From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Tue, 5 Jul 2005 03:51:11 +0000 (+0000)
Subject: Added man.subheading.divider.enabled flag and tweaked doc for
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=320647beb8bf84d22c200c01c5e5c4c797237d93;p=docbook-dsssl

Added man.subheading.divider.enabled flag and tweaked doc for
man.subheading.divider
---

diff --git a/xsl/manpages/param.ent b/xsl/manpages/param.ent
index a26f5bb72..a4986b06a 100644
--- a/xsl/manpages/param.ent
+++ b/xsl/manpages/param.ent
@@ -9,4 +9,5 @@
 <!ENTITY man.charmap.uri SYSTEM "../params/man.charmap.uri.xml">
 <!ENTITY man.charmap.subset.profile SYSTEM "../params/man.charmap.subset.profile.xml">
 <!ENTITY man.subheading.divider SYSTEM "../params/man.subheading.divider.xml">
+<!ENTITY man.subheading.divider.enabled SYSTEM "../params/man.subheading.divider.enabled.xml">
 <!ENTITY man.th.title.max.length SYSTEM "../params/man.th.title.max.length.xml">
diff --git a/xsl/manpages/param.xweb b/xsl/manpages/param.xweb
index ab6abe18c..7dbf9b744 100644
--- a/xsl/manpages/param.xweb
+++ b/xsl/manpages/param.xweb
@@ -36,6 +36,7 @@
 &man.output.quietly;
 &man.output.encoding;
 &man.string.subst.map;
+&man.subheading.divider.enabled;
 &man.subheading.divider;
 &man.th.title.max.length;
   </reference>
@@ -80,6 +81,7 @@
 <src:fragref linkend="man.charmap.use.subset.frag"/>
 <src:fragref linkend="man.charmap.subset.profile.frag"/>
 <src:fragref linkend="man.subheading.divider.frag"/>
+<src:fragref linkend="man.subheading.divider.enabled.frag"/>
 <src:fragref linkend="man.th.title.max.length.frag"/>
 </xsl:stylesheet>
     </src:fragment>
diff --git a/xsl/params/man.subheading.divider.enabled.xml b/xsl/params/man.subheading.divider.enabled.xml
new file mode 100644
index 000000000..c30c93927
--- /dev/null
+++ b/xsl/params/man.subheading.divider.enabled.xml
@@ -0,0 +1,32 @@
+<refentry id="man.subheading.divider.enabled">
+<refmeta>
+<refentrytitle>man.subheading.divider.enabled</refentrytitle>
+<refmiscinfo role="type">string</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>man.subheading.divider.enabled</refname>
+<refpurpose>Add divider comment to roff source before/after subheadings?</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment id='man.subheading.divider.enabled.frag'>
+<xsl:param name="man.subheading.divider.enabled">0</xsl:param>
+</src:fragment>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+
+<para>If the value of the
+<parameter>man.subheading.divider.enabled</parameter> parameter is
+non-zero, the contents of the
+<parameter>man.subheading.divider</parameter> parameter are used to
+add a "divider" before and after subheadings in the roff
+output. <emphasis role="bold">The divider is not visisble in the
+rendered man page</emphasis>; it is added as a comment, in the source,
+simply for the purpose of increasing reability of the source.</para>
+
+<para>If <parameter>man.subheading.divider.enabled</parameter> is zero
+(the default), the subheading divider is suppressed.</para>
+
+</refsect1>
+</refentry>
diff --git a/xsl/params/man.subheading.divider.xml b/xsl/params/man.subheading.divider.xml
index cd6f99a48..fed4c63cd 100644
--- a/xsl/params/man.subheading.divider.xml
+++ b/xsl/params/man.subheading.divider.xml
@@ -5,7 +5,7 @@
 </refmeta>
 <refnamediv>
 <refname>man.subheading.divider</refname>
-<refpurpose>Divider comment added to roff source before/after subheadings</refpurpose>
+<refpurpose>Specifies string to use as divider comment before/after subheadings</refpurpose>
 </refnamediv>
 
 <refsynopsisdiv>
@@ -18,15 +18,16 @@
 <refsect1><title>Description</title>
 
 <para>If the value of the
-<parameter>man.subheading.divider</parameter> parameter is non-empty,
-the contents are used to add a "divider" before and after subheadings
-in the roff output. <emphasis role="bold">The divider is not visisble
-in the rendered man page</emphasis>; it is added as a comment, in the
-source, simply for the purpose of increasing reability of the
-source.</para>
+<parameter>man.subheading.divider.enabled</parameter> parameter is
+non-zero, the contents of the
+<parameter>man.subheading.divider</parameter> parameter are used to
+add a "divider" before and after subheadings in the roff
+output. <emphasis role="bold">The divider is not visisble in the
+rendered man page</emphasis>; it is added as a comment, in the source,
+simply for the purpose of increasing reability of the source.</para>
 
-<para>If <parameter>man.subheading.divider</parameter> is empty, the
-subheading divider is suppressed.</para>
+<para>If <parameter>man.subheading.divider.enabled</parameter> is zero
+(the default), the subheading divider is suppressed.</para>
 
 </refsect1>
 </refentry>