docs: use xi:include to use the generated indexes if available.

This works transparantly for people with new enough gtk-doc (>=1.11) and
significantly improves the build time.
This commit is contained in:
Stefan Kost 2010-01-07 10:22:14 +02:00
parent 4c55b45162
commit d01e2527ce
3 changed files with 84 additions and 51 deletions

View File

@ -1,6 +1,7 @@
<?xml version="1.0"?> <?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" [ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml"> <!ENTITY version SYSTEM "version.xml">
]> ]>
<book lang="en" id="gio" xmlns:xi="http://www.w3.org/2003/XInclude"> <book lang="en" id="gio" xmlns:xi="http://www.w3.org/2003/XInclude">
@ -142,22 +143,28 @@
<xi:include href="xml/tree_index.sgml"/> <xi:include href="xml/tree_index.sgml"/>
</chapter> </chapter>
<index> <index id="api-index-full">
<title id="index-all">Index</title> <title id="index-all">Index</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="deprecated"> <index id="api-index-deprecated" role="deprecated">
<title>Index of deprecated symbols</title> <title>Index of deprecated symbols</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="2.18"> <index id="api-index-2-18" role="2.18">
<title>Index of new symbols in 2.18</title> <title>Index of new symbols in 2.18</title>
<xi:include href="xml/api-index-2.18.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="2.20"> <index id="api-index-2-20" role="2.20">
<title>Index of new symbols in 2.20</title> <title>Index of new symbols in 2.20</title>
<xi:include href="xml/api-index-2.20.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="2.22"> <index id="api-index-2-22" role="2.22">
<title>Index of new symbols in 2.22</title> <title>Index of new symbols in 2.22</title>
<xi:include href="xml/api-index-2.22.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="2.24"> <index id="api-index-2-24" role="2.24">
<title>Index of new symbols in 2.24</title> <title>Index of new symbols in 2.24</title>
<xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
</index> </index>
</book> </book>

View File

@ -80,9 +80,10 @@
<!ENTITY gtester SYSTEM "gtester.xml"> <!ENTITY gtester SYSTEM "gtester.xml">
<!ENTITY gtester-report SYSTEM "gtester-report.xml"> <!ENTITY gtester-report SYSTEM "gtester-report.xml">
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml"> <!ENTITY version SYSTEM "version.xml">
]> ]>
<book id="index"> <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo> <bookinfo>
<title>GLib Reference Manual</title> <title>GLib Reference Manual</title>
<releaseinfo> <releaseinfo>
@ -208,44 +209,57 @@ synchronize their operation.
&gtester-report; &gtester-report;
</chapter> </chapter>
<index> <index id="api-index-full">
<title>Index</title> <title>Index</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="deprecated"> <index id="api-index-deprecated" role="deprecated">
<title>Index of deprecated symbols</title> <title>Index of deprecated symbols</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="2.2"> <index id="api-index-2-2" role="2.2">
<title>Index of new symbols in 2.2</title> <title>Index of new symbols in 2.2</title>
<xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="2.4"> <index id="api-index-2-4" role="2.4">
<title>Index of new symbols in 2.4</title> <title>Index of new symbols in 2.4</title>
</index> <xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
<index role="2.6"> </index>
<index id="api-index-2-6" role="2.6">
<title>Index of new symbols in 2.6</title> <title>Index of new symbols in 2.6</title>
</index> <xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include>
<index role="2.8"> </index>
<index id="api-index-2-8" role="2.8">
<title>Index of new symbols in 2.8</title> <title>Index of new symbols in 2.8</title>
</index> <xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
<index role="2.10"> </index>
<index id="api-index-2-10" role="2.10">
<title>Index of new symbols in 2.10</title> <title>Index of new symbols in 2.10</title>
</index> <xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
<index role="2.12"> </index>
<index id="api-index-2-12" role="2.12">
<title>Index of new symbols in 2.12</title> <title>Index of new symbols in 2.12</title>
</index> <xi:include href="xml/api-index-2.12.xml"><xi:fallback /></xi:include>
<index role="2.14"> </index>
<index id="api-index-2-14" role="2.14">
<title>Index of new symbols in 2.14</title> <title>Index of new symbols in 2.14</title>
</index> <xi:include href="xml/api-index-2.14.xml"><xi:fallback /></xi:include>
<index role="2.16"> </index>
<index id="api-index-2-16" role="2.16">
<title>Index of new symbols in 2.16</title> <title>Index of new symbols in 2.16</title>
</index> <xi:include href="xml/api-index-2.16.xml"><xi:fallback /></xi:include>
<index role="2.18"> </index>
<index id="api-index-2-18" role="2.18">
<title>Index of new symbols in 2.18</title> <title>Index of new symbols in 2.18</title>
</index> <xi:include href="xml/api-index-2.18.xml"><xi:fallback /></xi:include>
<index role="2.20"> </index>
<index id="api-index-2-20" role="2.20">
<title>Index of new symbols in 2.20</title> <title>Index of new symbols in 2.20</title>
</index> <xi:include href="xml/api-index-2.20.xml"><xi:fallback /></xi:include>
<index role="2.22"> </index>
<index id="api-index-2-22" role="2.22">
<title>Index of new symbols in 2.22</title> <title>Index of new symbols in 2.22</title>
</index> <xi:include href="xml/api-index-2.22.xml"><xi:fallback /></xi:include>
</index>
</book> </book>

View File

@ -17,7 +17,6 @@
<!ENTITY glib-mkenums SYSTEM "glib-mkenums.xml"> <!ENTITY glib-mkenums SYSTEM "glib-mkenums.xml">
<!ENTITY glib-genmarshal SYSTEM "glib-genmarshal.xml"> <!ENTITY glib-genmarshal SYSTEM "glib-genmarshal.xml">
<!ENTITY gobject-query SYSTEM "gobject-query.xml"> <!ENTITY gobject-query SYSTEM "gobject-query.xml">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY tutorial-Intro SYSTEM "tut_intro.xml"> <!ENTITY tutorial-Intro SYSTEM "tut_intro.xml">
<!ENTITY tutorial-GType SYSTEM "tut_gtype.xml"> <!ENTITY tutorial-GType SYSTEM "tut_gtype.xml">
@ -26,8 +25,10 @@
<!ENTITY tutorial-HowTo SYSTEM "tut_howto.xml"> <!ENTITY tutorial-HowTo SYSTEM "tut_howto.xml">
<!ENTITY tutorial-Tools SYSTEM "tut_tools.xml"> <!ENTITY tutorial-Tools SYSTEM "tut_tools.xml">
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]> ]>
<book id="index"> <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo> <bookinfo>
<title>GObject Reference Manual</title> <title>GObject Reference Manual</title>
<releaseinfo> <releaseinfo>
@ -125,38 +126,49 @@
&tutorial-Tools; &tutorial-Tools;
</part> </part>
<index> <index id="api-index-full">
<title>Index</title> <title>Index</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="deprecated"> <index id="api-index-deprecated" role="deprecated">
<title>Index of deprecated symbols</title> <title>Index of deprecated symbols</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="2.2"> <index id="api-index-2-2" role="2.2">
<title>Index of new symbols in 2.2</title> <title>Index of new symbols in 2.2</title>
<xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
</index> </index>
<index role="2.4"> <index id="api-index-2-4" role="2.4">
<title>Index of new symbols in 2.4</title> <title>Index of new symbols in 2.4</title>
</index> <xi:include href="xml/api-index-2.4.xml"><xi:fallback /></xi:include>
<index role="2.6"> </index>
<index id="api-index-2-6" role="2.6">
<title>Index of new symbols in 2.6</title> <title>Index of new symbols in 2.6</title>
</index> <xi:include href="xml/api-index-2.6.xml"><xi:fallback /></xi:include>
<index role="2.8"> </index>
<index id="api-index-2-8" role="2.8">
<title>Index of new symbols in 2.8</title> <title>Index of new symbols in 2.8</title>
</index> <xi:include href="xml/api-index-2.8.xml"><xi:fallback /></xi:include>
<index role="2.10"> </index>
<index id="api-index-2-10" role="2.10">
<title>Index of new symbols in 2.10</title> <title>Index of new symbols in 2.10</title>
</index> <xi:include href="xml/api-index-2.10.xml"><xi:fallback /></xi:include>
<index role="2.12"> </index>
<index id="api-index-2-12" role="2.12">
<title>Index of new symbols in 2.12</title> <title>Index of new symbols in 2.12</title>
</index> <xi:include href="xml/api-index-2.12.xml"><xi:fallback /></xi:include>
<index role="2.14"> </index>
<index id="api-index-2-14" role="2.14">
<title>Index of new symbols in 2.14</title> <title>Index of new symbols in 2.14</title>
</index> <xi:include href="xml/api-index-2.14.xml"><xi:fallback /></xi:include>
<index role="2.18"> </index>
<index id="api-index-2-18" role="2.18">
<title>Index of new symbols in 2.18</title> <title>Index of new symbols in 2.18</title>
</index> <xi:include href="xml/api-index-2.18.xml"><xi:fallback /></xi:include>
<index role="2.22"> </index>
<index id="api-index-2-22" role="2.22">
<title>Index of new symbols in 2.22</title> <title>Index of new symbols in 2.22</title>
</index> <xi:include href="xml/api-index-2.22.xml"><xi:fallback /></xi:include>
</index>
</book> </book>