[tracker/0.10-documentation-review] docs, libtracker-miner: Cleanup sections and added new 'Compiling applications' one

[Aleksander Morgado <aleksm src gnome org>]

commit 077fe14d580ee81db4b9c046ce5d5e5fc9e72e62
Author: Aleksander Morgado <aleksander lanedo com>
Date:   Tue Feb 8 12:22:38 2011 +0100

    docs, libtracker-miner: Cleanup sections and added new 'Compiling applications' one

 docs/reference/libtracker-miner/Makefile.am        |    3 +-
 .../libtracker-miner/libtracker-miner-docs.sgml    |   35 +++++++++++--------
 2 files changed, 21 insertions(+), 17 deletions(-)
---
diff --git a/docs/reference/libtracker-miner/Makefile.am b/docs/reference/libtracker-miner/Makefile.am
index 5b0f236..b4174fd 100644
--- a/docs/reference/libtracker-miner/Makefile.am
+++ b/docs/reference/libtracker-miner/Makefile.am
@@ -57,8 +57,7 @@ MKDB_OPTIONS=--sgml-mode --output-format=xml
 MKHTML_OPTIONS=--path="$(abs_builddir)"
 
 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE)
-content_files =                                        \
-	version.xml
+content_files = version.xml overview.sgml
 
 expand_content_files =
 
diff --git a/docs/reference/libtracker-miner/libtracker-miner-docs.sgml b/docs/reference/libtracker-miner/libtracker-miner-docs.sgml
index a1dd867..dd3f33c 100644
--- a/docs/reference/libtracker-miner/libtracker-miner-docs.sgml
+++ b/docs/reference/libtracker-miner/libtracker-miner-docs.sgml
@@ -1,6 +1,8 @@
 <?xml version="1.0"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
+<!ENTITY version SYSTEM "version.xml">
+<!ENTITY tracker-overview SYSTEM "overview.sgml">
 <!ENTITY tracker-miner SYSTEM "xml/tracker-miner.xml">
 <!ENTITY tracker-miner-fs SYSTEM "xml/tracker-miner-fs.xml">
 <!ENTITY tracker-miner-manager SYSTEM "xml/tracker-miner-manager.xml">
@@ -9,7 +11,6 @@
 <!ENTITY tracker-password-provider SYSTEM "xml/tracker-password-provider.xml">
 <!ENTITY tracker-storage SYSTEM "xml/tracker-storage.xml">
 <!ENTITY tracker-thumbnailer SYSTEM "xml/tracker-thumbnailer.xml">
-<!ENTITY version SYSTEM "version.xml">
 ]>
 <book id="index">
   <bookinfo>
@@ -17,29 +18,26 @@
     <releaseinfo>for libtracker-miner &version;</releaseinfo>
   </bookinfo>
 
-  <part id="libtracker-miner">
-    <title>Overview</title>
+  <!-- The Library Overview -->
+  &tracker-overview;
+
+  <!-- The API Reference -->
+  <part id="libtracker-miner-reference">
+    <title>Reference</title>
     <partintro>
       <para>
-        The libtracker-miner library is the foundation for Tracker data miners,
-        these miners will extract metadata and insert it in SPARQL form to
-        tracker-store, following the Nepomuk ontology.
-      </para>
-      <para>
+        This section provides the detailed API of the Tracker Miner library.
       </para>
     </partintro>
-  </part>
 
     <chapter>
-      <title>Base abstract miner class</title>
+      <title>Base abstract miners</title>
       &tracker-miner;
       &tracker-miner-web;
-      &tracker-network-provider;
-      &tracker-password-provider;
     </chapter>
 
     <chapter>
-      <title>Helper implementations</title>
+      <title>Additional miners</title>
       &tracker-miner-fs;
     </chapter>
 
@@ -49,8 +47,15 @@
     </chapter>
 
     <chapter>
-      <title>Utilities</title>
+      <title>Base abstract utilities</title>
+      &tracker-network-provider;
+      &tracker-password-provider;
+    </chapter>
+
+    <chapter>
+      <title>Additional utilities</title>
       &tracker-storage;
       &tracker-thumbnailer;
     </chapter>
+  </part>
 </book>