From 460dc9f2effcabfea7a3535a5045a788d6de4058 Mon Sep 17 00:00:00 2001
From: Tomeu Vizoso <tomeu.vizoso@collabora.com>
Date: Mon, 11 Mar 2013 16:49:24 +0100
Subject: [PATCH] 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}     | 32 +++++++++----------
 3 files changed, 19 insertions(+), 16 deletions(-)
 rename doc/reference/{meta-docs.sgml => meta-docs.sgml.in} (83%)

diff --git a/.gitignore b/.gitignore
index ff4d76c78..81a262cdd 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 92e88e1c5..189b0ed8b 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 5d8d0335b..e082fa0f6 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/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/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/display.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"/>