[libchamplain] Make the TOC of the manual more readable

[Jiří Techet <jiritechet src gnome org>]

commit 1b4e9dd40ba16f83e69cbc582e11a3c33f40ea63
Author: JiÅ?í Techet <techet gmail com>
Date:   Mon May 10 00:43:39 2010 +0200

    Make the TOC of the manual more readable
    
    Signed-off-by: JiÅ?í Techet <techet gmail com>

 champlain/champlain-bounding-box.c            |    2 +-
 champlain/champlain-local-map-data-source.c   |    2 +-
 champlain/champlain-map-data-source.c         |    2 +-
 champlain/champlain-network-map-data-source.c |    2 +-
 champlain/champlain-point.c                   |    2 +-
 docs/reference/libchamplain-docs.sgml         |   89 ++++++++++++++-----------
 6 files changed, 55 insertions(+), 44 deletions(-)
---
diff --git a/champlain/champlain-bounding-box.c b/champlain/champlain-bounding-box.c
index 74d1cca..0cd8fef 100644
--- a/champlain/champlain-bounding-box.c
+++ b/champlain/champlain-bounding-box.c
@@ -21,7 +21,7 @@
 
 /**
  * SECTION:champlain-bounding-box
- * @short_description: A basic struct to describe a bounding box.
+ * @short_description: A basic struct to describe a bounding box
  *
  * A basic struct to describe a bounding box.
  *
diff --git a/champlain/champlain-local-map-data-source.c b/champlain/champlain-local-map-data-source.c
index df62de9..63daaa0 100644
--- a/champlain/champlain-local-map-data-source.c
+++ b/champlain/champlain-local-map-data-source.c
@@ -18,7 +18,7 @@
 
 /**
  * SECTION:champlain-local-map-data-source
- * @short_description: Loads local map data for #ChamplainMemphisTileSource.
+ * @short_description: Loads local map data for #ChamplainMemphisTileSource
  *
  * This map data source loads local <ulink role="online-location"
  * url="http://wiki.openstreetmap.org/wiki/.osm";>
diff --git a/champlain/champlain-map-data-source.c b/champlain/champlain-map-data-source.c
index e5ecfbc..47b93ac 100644
--- a/champlain/champlain-map-data-source.c
+++ b/champlain/champlain-map-data-source.c
@@ -18,7 +18,7 @@
 
 /**
  * SECTION:champlain-map-data-source
- * @short_description: Base class for map data sources.
+ * @short_description: Base class for map data sources
  *
  * ChamplainMapDataSource provides the interface for
  *  #ChamplainMemphisTileSource to aquire map data.
diff --git a/champlain/champlain-network-map-data-source.c b/champlain/champlain-network-map-data-source.c
index ad65871..3e96dbd 100644
--- a/champlain/champlain-network-map-data-source.c
+++ b/champlain/champlain-network-map-data-source.c
@@ -18,7 +18,7 @@
 
 /**
  * SECTION:champlain-network-map-data-source
- * @short_description: Downloads map data for #ChamplainMemphisTileSource.
+ * @short_description: Downloads map data for #ChamplainMemphisTileSource
  *
  * This map data source downloads the map data from an OpenStreetMap API
  * server. It supports protocol version 0.5 and 0.6.
diff --git a/champlain/champlain-point.c b/champlain/champlain-point.c
index 37cd303..d918811 100644
--- a/champlain/champlain-point.c
+++ b/champlain/champlain-point.c
@@ -21,7 +21,7 @@
 
 /**
  * SECTION:champlain-point
- * @short_description: A base struct to store a latitude and longitude.
+ * @short_description: A base struct to store a latitude and longitude
  *
  * A base struct to store a latitude and longitude.
  *
diff --git a/docs/reference/libchamplain-docs.sgml b/docs/reference/libchamplain-docs.sgml
index 39cbd59..b48d474 100644
--- a/docs/reference/libchamplain-docs.sgml
+++ b/docs/reference/libchamplain-docs.sgml
@@ -40,40 +40,63 @@
     </legalnotice>
   </bookinfo>
 
-  <chapter>
-    <title>I. View API Reference</title>
+  <part>
+    <title>Core API Reference</title>
     <xi:include href="xml/champlain-view.xml"/>
-    <xi:include href="xml/champlain-layer.xml"/>
-    <xi:include href="xml/champlain-selection-layer.xml"/>
-    <xi:include href="xml/champlain-base-marker.xml"/>
-    <xi:include href="xml/champlain-marker.xml"/>
-    <xi:include href="xml/champlain-polygon.xml"/>
-    <xi:include href="xml/champlain-point.xml"/>
-  </chapter>
-  <chapter>
-    <title>II. Map Source API Reference</title>
-    <xi:include href="xml/champlain-map-source-factory.xml"/>
-    <xi:include href="xml/champlain-map-source.xml"/>
     <xi:include href="xml/champlain-tile.xml"/>
-    <xi:include href="xml/champlain-map-source-chain.xml"/>
-    <xi:include href="xml/champlain-tile-source.xml"/>
-    <xi:include href="xml/champlain-tile-cache.xml"/>
-    <xi:include href="xml/champlain-network-tile-source.xml"/>
-    <xi:include href="xml/champlain-memphis-tile-source.xml"/>
-    <xi:include href="xml/champlain-error-tile-source.xml"/>
-    <xi:include href="xml/champlain-file-cache.xml"/>
-  </chapter>
-  <chapter>
-    <title>III. Map Data Source API Reference</title>
+  </part>
+  <part>
+    <title>Layers, Markers and Polygons</title>
+    <chapter>
+      <title>Layers</title>
+      <xi:include href="xml/champlain-layer.xml"/>
+      <xi:include href="xml/champlain-selection-layer.xml"/>
+    </chapter>
+    <chapter>
+      <title>Markers</title>
+      <xi:include href="xml/champlain-base-marker.xml"/>
+      <xi:include href="xml/champlain-marker.xml"/>
+    </chapter>
+    <chapter>
+      <title>Polygons</title>
+      <xi:include href="xml/champlain-polygon.xml"/>
+      <xi:include href="xml/champlain-point.xml"/>
+    </chapter>
+  </part>
+  <part>
+    <title>Map Source API Reference</title>
+    <xi:include href="xml/champlain-map-source.xml"/>
+    <chapter>
+      <title>Tile Sources</title>
+      <xi:include href="xml/champlain-tile-source.xml"/>
+      <xi:include href="xml/champlain-network-tile-source.xml"/>
+      <xi:include href="xml/champlain-error-tile-source.xml"/>
+      <xi:include href="xml/champlain-memphis-tile-source.xml"/>
+    </chapter>
+    <chapter>
+      <title>Tile Caches</title>
+      <xi:include href="xml/champlain-tile-cache.xml"/>
+      <xi:include href="xml/champlain-file-cache.xml"/>
+    </chapter>
+    <chapter>
+      <title>Map Source Utilities</title>
+      <xi:include href="xml/champlain-map-source-chain.xml"/>
+      <xi:include href="xml/champlain-map-source-factory.xml"/>
+      <xi:include href="xml/champlain-map-source-desc.xml"/>
+    </chapter>
+  </part>
+  <part>
+    <title>Map Data Source API Reference</title>
     <xi:include href="xml/champlain-map-data-source.xml"/>
     <xi:include href="xml/champlain-local-map-data-source.xml"/>
     <xi:include href="xml/champlain-network-map-data-source.xml"/>
     <xi:include href="xml/champlain-bounding-box.xml"/>
-  </chapter>
-  <chapter>
-    <title>IV. Utility API Reference</title>
+  </part>
+  <part>
+    <title>Utility API Reference</title>
     <xi:include href="xml/champlain-version.xml"/>
-  </chapter>
+  </part>
+  
   <index>
     <title>Index</title>
   </index>
@@ -90,18 +113,6 @@
     <title>Index of new symbols in 0.2</title>
   </index>
 
-  <index role="0.2.2">
-    <title>Index of new symbols in 0.2.2</title>
-  </index>
-
-  <index role="0.2.7">
-    <title>Index of new symbols in 0.2.7</title>
-  </index>
-
-  <index role="0.2.8">
-    <title>Index of new symbols in 0.2.8</title>
-  </index>
-
   <index role="0.4">
     <title>Index of new symbols in 0.4</title>
   </index>