Revamp the documentation to modernize and uniformize accross components

- Also fixes some autohells deprecations

1 files changed, 11 insertions, 21 deletions

diff --git a/docs/reference/xfconf-docs.xml b/docs/reference/xfconf-docs.xml
index bcecd23..d9311a5 100644
--- a/docs/reference/xfconf-docs.xml
+++ b/docs/reference/xfconf-docs.xml
@@ -3,29 +3,22 @@
                "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 % gtkdocentities SYSTEM "xml/gtkdocentities.ent">
+  %gtkdocentities;
 ]>
 
-<book id="index" lang="en">
+<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
   <bookinfo>
-    <title>Xfconf Reference Manual</title>
-    <releaseinfo>Version <xi:include href="version.xml" parse="text"/></releaseinfo>
-    <pubdate>2017</pubdate>
-
+    <title>&package_name; Reference Manual</title>
+    <releaseinfo>
+      For &package_string;.
+      The latest version of this documentation can be found on-line at
+      <ulink role="online-location" url="https://developer.xfce.org/&package_name;/index.html">https://developer.xfce.org/&package_name;/</ulink>.
+    </releaseinfo>
     <copyright>
-      <year>2017</year>
+      <year>2021</year>
       <holder>The Xfce Development Team</holder>
     </copyright>
-
-    <legalnotice id="legalnotice">
-      <para>
-        Permission is granted to copy, distribute and/or modify this document
-        under the terms of the GNU Free Documentation License, Version 1.1 or
-        any later version published by the Free Software Foundation; with no
-        Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
-        Texts. The complete license text is available from the <ulink
-        type="http" url="http://www.gnu.org/">Free Software Foundation</ulink>.
-      </para>
-    </legalnotice>
   </bookinfo>
 
   <chapter>
@@ -51,22 +44,19 @@
 
     <index id="api-index-full">
       <title>All symbols</title>
-      <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
     </index>
 
     <index id="api-index-4.5.91">
       <title>Added in 4.5.91</title>
-      <xi:include href="xml/api-index-4.5.91.xml"><xi:fallback /></xi:include>
     </index>
 
     <index id="api-index-4.5.92">
       <title>Added in 4.5.92</title>
-      <xi:include href="xml/api-index-4.5.92.xml"><xi:fallback /></xi:include>
     </index>
 
     <index id="api-index-4.12.1">
       <title>Added in 4.12.1</title>
-      <xi:include href="xml/api-index-4.12.1.xml"><xi:fallback /></xi:include>
     </index>
   </chapter>
+  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
 </book>