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 a26f5bb72b19d58bc83863d88f0a85908b00dd66..a4986b06acba350ad0d3cdc8d09c0873973403e8 100644 (file)
--- 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 ab6abe18ca9bbc7ae93d350dfebadb8e7cb3a6f3..7dbf9b744af9655d81bfa0a9784f4e615c4a0fa2 100644 (file)
--- 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 (file)
index 0000000..c30c939
--- /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 cd6f99a48b1b4adf47c0828f1e3e7f4ffe06bc9f..fed4c63cda78b3ed6c5590718476926ba9086b9f 100644 (file)
--- 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>