New upstream version 1.8.0 upstream/1.8.0

1 files changed, 42 insertions, 21 deletions

diff --git a/docs/api/settings-spec.xsl b/docs/api/settings-spec.xsl
index 04feb398..80f27309 100644
--- a/docs/api/settings-spec.xsl
+++ b/docs/api/settings-spec.xsl
@@ -9,37 +9,58 @@
       />
 
   <xsl:template match="nm-setting-docs">
-    <section>
+    <chapter>
       <title>Configuration Settings</title>
       <xsl:apply-templates/>
-    </section>
+    </chapter>
   </xsl:template>
 
   <xsl:template match="setting">
-    <para>
-      <table>
-	<title><xsl:value-of select="@name"/> setting</title>
-	<tgroup cols="4">
-	  <thead>
-	    <row>
-              <entry>Key Name</entry>
-              <entry>Value Type</entry>
-              <entry>Default Value</entry>
-              <entry>Value Description</entry>
-	    </row>
-	  </thead>
-	  <tbody>
-	    <xsl:apply-templates/>
-	  </tbody>
-	</tgroup>
-      </table>
-    </para>
+    <refentry>
+      <xsl:attribute name="id">settings-<xsl:value-of select="@name"/></xsl:attribute>
+      <refnamediv>
+        <refname><xsl:value-of select="@name"/></refname>
+        <refpurpose><xsl:value-of select="@description"/></refpurpose>
+      </refnamediv>
+      <refsect1 role="properties">
+        <title>
+            <xsl:attribute name="id">settings-<xsl:value-of select="@name"/>.properties</xsl:attribute>
+            Properties
+        </title>
+        <para>
+          <table>
+            <tgroup cols="4">
+              <thead>
+                <row>
+                  <entry>Key Name</entry>
+                  <entry>Value Type</entry>
+                  <entry>Default Value</entry>
+                  <entry>Value Description</entry>
+                </row>
+              </thead>
+              <tbody>
+                <xsl:apply-templates/>
+              </tbody>
+            </tgroup>
+          </table>
+        </para>
+      </refsect1>
+    </refentry>
   </xsl:template>
 
   <xsl:template match="property">
     <xsl:variable name="setting_name" select="../@name"/>
     <row>
-      <entry><screen><xsl:value-of select="@name"/></screen></entry>
+      <entry><screen>
+        <xsl:value-of select="@name"/>
+        <indexterm>
+           <xsl:attribute name="zone">settings-<xsl:value-of select="../@name"/></xsl:attribute>
+           <primary>
+             <xsl:attribute name="sortas"><xsl:value-of select="@name"/></xsl:attribute>
+             <xsl:value-of select="@name"/>
+           </primary>
+        </indexterm>
+      </screen></entry>
       <entry><screen><xsl:value-of select="@type"/></screen></entry>
       <entry><screen><xsl:value-of select="@default"/></screen></entry>
       <entry><xsl:value-of select="@description"/><xsl:if test="@type = 'NMSettingSecretFlags'"> (see <xref linkend="secrets-flags"/> for flag values)</xsl:if></entry>