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: 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 +
 doc/reference/meta-docs.sgml    | 58 -----------------------------------------
 doc/reference/meta-docs.sgml.in | 58 +++++++++++++++++++++++++++++++++++++++++
 4 files changed, 61 insertions(+), 58 deletions(-)
 delete mode 100644 doc/reference/meta-docs.sgml
 create mode 100644 doc/reference/meta-docs.sgml.in

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
deleted file mode 100644
index 5d8d0335b..000000000
--- a/doc/reference/meta-docs.sgml
+++ /dev/null
@@ -1,58 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-               "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'">
-]>
-<book id="index">
-  <bookinfo>
-    <title>meta Reference Manual</title>
-    <releaseinfo>
-      for meta [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>.
-    </releaseinfo>
-  </bookinfo>
-
-  <chapter>
-    <title>[Insert title here]</title>
-        <xi:include href="xml/barrier.xml"/>
-    <xi:include href="xml/boxes.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/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"/>
-
-  </chapter>
-  <chapter id="object-tree">
-    <title>Object Hierarchy</title>
-     <xi:include href="xml/tree_index.sgml"/>
-  </chapter>
-  <index id="api-index-full">
-    <title>API Index</title>
-    <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="deprecated-api-index" role="deprecated">
-    <title>Index of deprecated API</title>
-    <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
-  </index>
-
-  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
-</book>
diff --git a/doc/reference/meta-docs.sgml.in b/doc/reference/meta-docs.sgml.in
new file mode 100644
index 000000000..e082fa0f6
--- /dev/null
+++ b/doc/reference/meta-docs.sgml.in
@@ -0,0 +1,58 @@
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "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>Mutter Reference Manual</title>
+    <releaseinfo>
+      This document is for Mutter &version;.
+      The latest version of this documentation can be found on-line at
+      <ulink role="online-location" url="http://developer.gnome.org/meta/">http://developer.gnome.org/meta/</ulink>.
+    </releaseinfo>
+  </bookinfo>
+
+  <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/display.xml"/>
+    <xi:include href="xml/group.xml"/>
+    <xi:include href="xml/keybindings.xml"/>
+    <xi:include href="xml/meta-background-actor.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/preview-widget.xml"/>
+    <xi:include href="xml/screen.xml"/>
+    <xi:include href="xml/theme.xml"/>
+    <xi:include href="xml/window.xml"/>
+    <xi:include href="xml/workspace.xml"/>
+  </part>
+
+  <chapter id="object-tree">
+    <title>Object Hierarchy</title>
+     <xi:include href="xml/tree_index.sgml"/>
+  </chapter>
+  <index id="api-index-full">
+    <title>API Index</title>
+    <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
+  </index>
+  <index id="deprecated-api-index" role="deprecated">
+    <title>Index of deprecated API</title>
+    <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
+  </index>
+
+  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
+</book>
-- 
cgit v1.2.1