Added man.subheading.divider param, for enabling addition of

divider around section titles in source. This doesn't show up in
rendered man page -- it is just there to help make the source more
readable.

diff --git a/xsl/params/man.subheading.divider.xml b/xsl/params/man.subheading.divider.xml
new file mode 100644 (file)
index 0000000..cd6f99a
--- /dev/null
+++ b/xsl/params/man.subheading.divider.xml
@@ -0,0 +1,32 @@
+<refentry id="man.subheading.divider">
+<refmeta>
+<refentrytitle>man.subheading.divider</refentrytitle>
+<refmiscinfo role="type">string</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>man.subheading.divider</refname>
+<refpurpose>Divider comment added to roff source before/after subheadings</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment id='man.subheading.divider.frag'>
+<xsl:param name="man.subheading.divider"
+>========================================================================</xsl:param>
+</src:fragment>
+</refsynopsisdiv>
+
+<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>
+
+<para>If <parameter>man.subheading.divider</parameter> is empty, the
+subheading divider is suppressed.</para>
+
+</refsect1>
+</refentry>