Documentation updates

diff --git a/xsl/params/table.frame.border.thickness.xml b/xsl/params/table.frame.border.thickness.xml
index e91ea7ddb3e833a80ffd5ef1eb70e025fd4906ec..0b5f2cbd1f6b35a6a9f1b212962da5d2d16e98af 100644 (file)
--- a/xsl/params/table.frame.border.thickness.xml
+++ b/xsl/params/table.frame.border.thickness.xml
@@ -5,7 +5,7 @@
 </refmeta>
 <refnamediv>
 <refname>table.frame.border.thickness</refname>
-<refpurpose></refpurpose>
+<refpurpose>Specifies the thickness of the frame border</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -16,7 +16,7 @@
 
 <refsect1><title>Description</title>
 
-<para>FIXME:</para>
+<para>Specifies the thickness of the border on the table's frame.</para>
 
 </refsect1>
 </refentry>

diff --git a/xsl/params/toc.margin.properties.xml b/xsl/params/toc.margin.properties.xml
index 0816921cacc59d4510e89818df5827c9466bbf20..0773967762c40bc83fb91db592b07fd117ddf589 100644 (file)
--- a/xsl/params/toc.margin.properties.xml
+++ b/xsl/params/toc.margin.properties.xml
@@ -1,20 +1,24 @@
 <refentry id="toc.margin.properties">
 <refnamediv>
 <refname>toc.margin.properties</refname>
-<refpurpose>FIXME:</refpurpose>
+<refpurpose>Margin properties used on Tables of Contents</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
-<src:fragment id='toc.margin.properties.frag'><xsl:attribute-set name="toc.margin.properties">
+<src:fragment id='toc.margin.properties.frag'>
+<xsl:attribute-set name="toc.margin.properties">
   <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute>
   <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
   <xsl:attribute name="space-before.maximum">2em</xsl:attribute>
   <xsl:attribute name="space-after.minimum">0.5em</xsl:attribute>
   <xsl:attribute name="space-after.optimum">1em</xsl:attribute>
   <xsl:attribute name="space-after.maximum">2em</xsl:attribute>
-</xsl:attribute-set></src:fragment>
+</xsl:attribute-set>
+</src:fragment>
 </refsynopsisdiv>
+
 <refsect1><title>Description</title>
-<para>FIXME:</para>
+<para>This attribute set is used on Tables of Contents. These attributes are set
+on the wrapper that surrounds the ToC block, not on each individual lines.</para>
 </refsect1>
 </refentry>

diff --git a/xsl/params/verbatim.properties.xml b/xsl/params/verbatim.properties.xml
index 92fadf0b820bb936879fbda38094553c6b5b69dd..1935347fd2d0ae878c5882c03bdf50061e4a0ed6 100644 (file)
--- a/xsl/params/verbatim.properties.xml
+++ b/xsl/params/verbatim.properties.xml
@@ -1,7 +1,7 @@
 <refentry id="verbatim.properties">
 <refnamediv>
 <refname>verbatim.properties</refname>
-<refpurpose>FIXME:</refpurpose>
+<refpurpose>Properties associated with verbatim text</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -12,7 +12,9 @@
   <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute>
 </xsl:attribute-set></src:fragment>
 </refsynopsisdiv>
+
 <refsect1><title>Description</title>
-<para>FIXME:</para>
+<para>This attribute set is used on all verbatim environments.</para>
 </refsect1>
+
 </refentry>

diff --git a/xsl/params/xref.properties.xml b/xsl/params/xref.properties.xml
index 65dc99a81cc70aa5464f187df137e1287ce4f464..9212c57f708a5c5ab4cab4201724edc6562b34d1 100644 (file)
--- a/xsl/params/xref.properties.xml
+++ b/xsl/params/xref.properties.xml
@@ -1,15 +1,19 @@
 <refentry id="xref.properties">
 <refnamediv>
 <refname>xref.properties</refname>
-<refpurpose>FIXME:</refpurpose>
+<refpurpose>Properties associated with cross-reference text</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
-<src:fragment id='xref.properties.frag'><xsl:attribute-set name="xref.properties">
-
-</xsl:attribute-set></src:fragment>
+<src:fragment id='xref.properties.frag'>
+<xsl:attribute-set name="xref.properties">
+</xsl:attribute-set>
+</src:fragment>
 </refsynopsisdiv>
+
 <refsect1><title>Description</title>
-<para>FIXME:</para>
+
+<para>This attribute set is used on cross reference text.</para>
+
 </refsect1>
 </refentry>