[mutter] Improve a bit the look of the main page of the API docs

[Jasper St. Pierre <jstpierre src gnome org>]

commit 460dc9f2effcabfea7a3535a5045a788d6de4058
Author: Tomeu Vizoso <tomeu vizoso collabora com>
Date:   Mon Mar 11 16:49:24 2013 +0100

    Improve a bit the look of the main page of the API docs
    
    https://bugzilla.gnome.org/show_bug.cgi?id=695641

 .gitignore                                         |    2 +
 configure.ac                                       |    1 +
 .../{meta-docs.sgml => meta-docs.sgml.in}          |   30 ++++++++++----------
 3 files changed, 18 insertions(+), 15 deletions(-)
---
diff --git a/.gitignore b/.gitignore
index ff4d76c..81a262c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -90,3 +90,5 @@ doc/reference/meta-overrides.txt
 doc/reference/meta-undeclared.txt
 doc/reference/meta-undocumented.txt
 doc/reference/meta-unused.txt
+doc/reference/meta-docs.sgml
+doc/reference/meta.types
diff --git a/configure.ac b/configure.ac
index 92e88e1..189b0ed 100644
--- a/configure.ac
+++ b/configure.ac
@@ -437,6 +437,7 @@ Makefile
 doc/Makefile
 doc/man/Makefile
 doc/reference/Makefile
+doc/reference/meta-docs.sgml
 src/Makefile
 src/wm-tester/Makefile
 src/libmutter.pc
diff --git a/doc/reference/meta-docs.sgml b/doc/reference/meta-docs.sgml.in
similarity index 83%
rename from doc/reference/meta-docs.sgml
rename to doc/reference/meta-docs.sgml.in
index 5d8d033..e082fa0 100644
--- a/doc/reference/meta-docs.sgml
+++ b/doc/reference/meta-docs.sgml.in
@@ -3,44 +3,44 @@
                "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd";
 [
   <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
+  <!ENTITY version "@VERSION@">
 ]>
 <book id="index">
   <bookinfo>
-    <title>meta Reference Manual</title>
+    <title>Mutter Reference Manual</title>
     <releaseinfo>
-      for meta [VERSION].
+      This document is for Mutter &version;.
       The latest version of this documentation can be found on-line at
-      <ulink role="online-location" url="http://[SERVER]/meta/index.html";>http://[SERVER]/meta/</ulink>.
+      <ulink role="online-location" 
url="http://developer.gnome.org/meta/";>http://developer.gnome.org/meta/</ulink>.
     </releaseinfo>
   </bookinfo>
 
-  <chapter>
-    <title>[Insert title here]</title>
-        <xi:include href="xml/barrier.xml"/>
-    <xi:include href="xml/boxes.xml"/>
+  <part id="core-reference">
+    <title>Mutter Core Reference</title>
+    <xi:include href="xml/main.xml"/>
     <xi:include href="xml/common.xml"/>
+    <xi:include href="xml/gradient.xml"/>
+    <xi:include href="xml/prefs.xml"/>
+    <xi:include href="xml/util.xml"/>
+    <xi:include href="xml/errors.xml"/>
+    <xi:include href="xml/meta-plugin.xml"/>
+    <xi:include href="xml/barrier.xml"/>
+    <xi:include href="xml/boxes.xml"/>
     <xi:include href="xml/compositor.xml"/>
-    <xi:include href="xml/compositor-mutter.xml"/>
     <xi:include href="xml/display.xml"/>
-    <xi:include href="xml/errors.xml"/>
-    <xi:include href="xml/gradient.xml"/>
     <xi:include href="xml/group.xml"/>
     <xi:include href="xml/keybindings.xml"/>
-    <xi:include href="xml/main.xml"/>
     <xi:include href="xml/meta-background-actor.xml"/>
-    <xi:include href="xml/meta-plugin.xml"/>
     <xi:include href="xml/meta-shadow-factory.xml"/>
     <xi:include href="xml/meta-shaped-texture.xml"/>
     <xi:include href="xml/meta-window-actor.xml"/>
-    <xi:include href="xml/prefs.xml"/>
     <xi:include href="xml/preview-widget.xml"/>
     <xi:include href="xml/screen.xml"/>
     <xi:include href="xml/theme.xml"/>
-    <xi:include href="xml/util.xml"/>
     <xi:include href="xml/window.xml"/>
     <xi:include href="xml/workspace.xml"/>
+  </part>
 
-  </chapter>
   <chapter id="object-tree">
     <title>Object Hierarchy</title>
      <xi:include href="xml/tree_index.sgml"/>