[gtksourceview/wip/improve-doc: 4/4] Improve API reference structure by grouping classes

[Sébastien Wilmet <swilmet src gnome org>]

commit 0303e6ab39e32e116f1cf494d7c36ff0ed34ef65
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Sat Nov 22 18:11:06 2014 +0100

    Improve API reference structure by grouping classes
    
    The classes were just sorted alphabetically. The GtkSourceView class at
    the end was not great, since it's the main class.
    
    The features with only one class are grouped into "Others".

 docs/reference/gtksourceview-docs.xml |   99 +++++++++++++++++++++-----------
 1 files changed, 65 insertions(+), 34 deletions(-)
---
diff --git a/docs/reference/gtksourceview-docs.xml b/docs/reference/gtksourceview-docs.xml
index 9803b5f..dc498f6 100644
--- a/docs/reference/gtksourceview-docs.xml
+++ b/docs/reference/gtksourceview-docs.xml
@@ -14,46 +14,77 @@
     <releaseinfo>for GtkSourceView &version;</releaseinfo>
   </bookinfo>
 
-  <chapter>
+  <part>
     <title>API reference</title>
-    <xi:include href="xml/buffer.xml"/>
-    <xi:include href="xml/completion.xml"/>
-    <xi:include href="xml/completioncontext.xml"/>
-    <xi:include href="xml/completioninfo.xml"/>
-    <xi:include href="xml/completionitem.xml"/>
-    <xi:include href="xml/completionproposal.xml"/>
-    <xi:include href="xml/completionprovider.xml"/>
-    <xi:include href="xml/completionwords.xml"/>
-    <xi:include href="xml/encoding.xml"/>
-    <xi:include href="xml/file.xml"/>
-    <xi:include href="xml/fileloader.xml"/>
-    <xi:include href="xml/filesaver.xml"/>
-    <xi:include href="xml/gutter.xml"/>
-    <xi:include href="xml/gutterrenderer.xml"/>
-    <xi:include href="xml/gutterrendererpixbuf.xml"/>
-    <xi:include href="xml/gutterrenderertext.xml"/>
-    <xi:include href="xml/language.xml"/>
-    <xi:include href="xml/languagemanager.xml"/>
-    <xi:include href="xml/mark.xml"/>
-    <xi:include href="xml/markattributes.xml"/>
-    <xi:include href="xml/printcompositor.xml"/>    
-    <xi:include href="xml/searchcontext.xml"/>
-    <xi:include href="xml/searchsettings.xml"/>
-    <xi:include href="xml/style.xml"/>
-    <xi:include href="xml/stylescheme.xml"/>
-    <xi:include href="xml/styleschememanager.xml"/>
-    <xi:include href="xml/undomanager.xml"/>
-    <xi:include href="xml/utils.xml"/>
-    <xi:include href="xml/view.xml"/>
-  </chapter>
 
-  <chapter>
-    <title>Syntax highlighting reference</title>
+    <chapter>
+      <title>Main Classes</title>
+      <xi:include href="xml/buffer.xml"/>
+      <xi:include href="xml/view.xml"/>
+    </chapter>
+
+    <chapter>
+      <title>Syntax Highlighting</title>
+      <xi:include href="xml/language.xml"/>
+      <xi:include href="xml/languagemanager.xml"/>
+      <xi:include href="xml/style.xml"/>
+      <xi:include href="xml/stylescheme.xml"/>
+      <xi:include href="xml/styleschememanager.xml"/>
+    </chapter>
+
+    <chapter>
+      <title>Completion</title>
+      <xi:include href="xml/completion.xml"/>
+      <xi:include href="xml/completioncontext.xml"/>
+      <xi:include href="xml/completioninfo.xml"/>
+      <xi:include href="xml/completionitem.xml"/>
+      <xi:include href="xml/completionproposal.xml"/>
+      <xi:include href="xml/completionprovider.xml"/>
+      <xi:include href="xml/completionwords.xml"/>
+    </chapter>
+
+    <chapter>
+      <title>File Loading and Saving</title>
+      <xi:include href="xml/encoding.xml"/>
+      <xi:include href="xml/file.xml"/>
+      <xi:include href="xml/fileloader.xml"/>
+      <xi:include href="xml/filesaver.xml"/>
+    </chapter>
+
+    <chapter>
+      <title>Gutter and Marks</title>
+      <xi:include href="xml/gutter.xml"/>
+      <xi:include href="xml/gutterrenderer.xml"/>
+      <xi:include href="xml/gutterrendererpixbuf.xml"/>
+      <xi:include href="xml/gutterrenderertext.xml"/>
+      <xi:include href="xml/mark.xml"/>
+      <xi:include href="xml/markattributes.xml"/>
+    </chapter>
 
+    <chapter>
+      <title>Printing</title>
+      <xi:include href="xml/printcompositor.xml"/>
+    </chapter>
+
+    <chapter>
+      <title>Search and Replace</title>
+      <xi:include href="xml/searchcontext.xml"/>
+      <xi:include href="xml/searchsettings.xml"/>
+    </chapter>
+
+    <chapter>
+      <title>Others</title>
+      <xi:include href="xml/undomanager.xml"/>
+      <xi:include href="xml/utils.xml"/>
+    </chapter>
+  </part>
+
+  <part>
+    <title>Syntax highlighting reference</title>
     &tutorial;
     &reference;
     &stylereference;
-  </chapter>
+  </part>
 
   <chapter id="object-tree">
     <title>Object Hierarchy</title>