From b63d43928f4d7e8cd9a7042a072fcea200076c65 Mon Sep 17 00:00:00 2001
From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Wed, 29 Jun 2005 06:50:25 +0000
Subject: [PATCH] Added support for man.subheading.divider parameter.

---
 xsl/manpages/block.xsl    | 22 ++++++++++------------
 xsl/manpages/general.xsl  | 20 +++++++++++++++++++-
 xsl/manpages/other.xsl    |  2 ++
 xsl/manpages/param.ent    |  3 ++-
 xsl/manpages/param.xweb   |  2 ++
 xsl/manpages/refentry.xsl |  9 ++++++++-
 6 files changed, 43 insertions(+), 15 deletions(-)

diff --git a/xsl/manpages/block.xsl b/xsl/manpages/block.xsl
index 053522dec..7da45d2a7 100644
--- a/xsl/manpages/block.xsl
+++ b/xsl/manpages/block.xsl
@@ -16,13 +16,11 @@
 
 <xsl:template match="caution|important|note|tip|warning">
   <xsl:call-template name="nested-section-title"/>
-  <xsl:text>&#10;</xsl:text>
   <xsl:apply-templates/>
 </xsl:template> 
 
 <xsl:template match="formalpara">
   <xsl:call-template name="nested-section-title"/>
-  <xsl:text>&#10;</xsl:text>
   <xsl:text>.RS 3&#10;</xsl:text>
   <xsl:apply-templates/>
   <xsl:text>.RE&#10;</xsl:text>
@@ -43,18 +41,18 @@
 </xsl:template>
 
 <xsl:template match="address|literallayout|programlisting|screen|synopsis">
-  <!-- Yes, address and synopsis are verbatim environments. -->
+  <!-- * Yes, address and synopsis are verbatim environments. -->
 
   <xsl:choose>
-    <!-- Check to see if this verbatim item is within a parent element that -->
-    <!-- allows mixed content. -->
-    
-    <!-- If it is within a mixed-content parent, then a line break is -->
-    <!-- already added before it by the mixed-block template, so we don't -->
-    <!-- need to add one here. -->
-    
-    <!-- If it is not within a mixed-content parent, then we need to add a -->
-    <!-- line break before it. -->
+    <!-- * Check to see if this verbatim item is within a parent element that -->
+    <!-- * allows mixed content. -->
+    <!-- * -->
+    <!-- * If it is within a mixed-content parent, then a line break is -->
+    <!-- * already added before it by the mixed-block template, so we don't -->
+    <!-- * need to add one here. -->
+    <!-- * -->
+    <!-- * If it is not within a mixed-content parent, then we need to add a -->
+    <!-- * line break before it. -->
     <xsl:when test="parent::caption|parent::entry|parent::para|
                     parent::td|parent::th" /> <!-- do nothing -->
     <xsl:otherwise>
diff --git a/xsl/manpages/general.xsl b/xsl/manpages/general.xsl
index 7f50a267c..52b21cdec 100644
--- a/xsl/manpages/general.xsl
+++ b/xsl/manpages/general.xsl
@@ -13,6 +13,9 @@
 
      ******************************************************************** -->
 
+<xsl:param name="man.subheading.divider"
+>========================================================================</xsl:param>
+
 <!-- ==================================================================== -->
 
 <!-- * This file contains named and "non element" templates that are -->
@@ -107,9 +110,12 @@
         </xsl:otherwise>
       </xsl:choose></bold>
     </xsl:variable>
+    <xsl:call-template name="mark.subheading"/>
     <xsl:apply-templates mode="bold" select="exsl:node-set($title.wrapper)"/>
+    <xsl:text>&#10;</xsl:text>
+    <xsl:call-template name="mark.subheading"/>
   </xsl:template>
-
+  
   <!-- ================================================================== -->
 
   <!-- * The mixed-block template jumps through a few hoops to deal with -->
@@ -230,4 +236,16 @@
     </xsl:choose>
   </xsl:template>
 
+  <!-- ================================================================== -->
+  
+  <!-- * Put a horizontal rule or other divider around section titles -->
+  <!-- * in roff source (just to make things easier to read). -->
+  <xsl:template name="mark.subheading">
+    <xsl:if test="$man.subheading.divider != ''">
+      <xsl:text>.\" </xsl:text>
+      <xsl:value-of select="$man.subheading.divider"/>
+      <xsl:text>&#10;</xsl:text>
+    </xsl:if>
+  </xsl:template>
+  
 </xsl:stylesheet>
diff --git a/xsl/manpages/other.xsl b/xsl/manpages/other.xsl
index 2988ae350..449910b93 100644
--- a/xsl/manpages/other.xsl
+++ b/xsl/manpages/other.xsl
@@ -72,6 +72,7 @@
     <xsl:param name="extra2"/>
     <xsl:param name="extra3"/>
 
+    <xsl:call-template name="mark.subheading"/>
     <xsl:text>.TH "</xsl:text>
     <xsl:call-template name="string.upper">
       <xsl:with-param name="string">
@@ -88,6 +89,7 @@
     <xsl:text>" "</xsl:text>
     <xsl:value-of select="normalize-space($extra3)"/>
     <xsl:text>"&#10;</xsl:text>
+    <xsl:call-template name="mark.subheading"/>
   </xsl:template>
 
   <!-- ============================================================== -->
diff --git a/xsl/manpages/param.ent b/xsl/manpages/param.ent
index 1e98f58ab..a26f5bb72 100644
--- a/xsl/manpages/param.ent
+++ b/xsl/manpages/param.ent
@@ -6,6 +6,7 @@
 <!ENTITY man.string.subst.map SYSTEM "../params/man.string.subst.map.xml">
 <!ENTITY man.charmap.enabled SYSTEM "../params/man.charmap.enabled.xml">
 <!ENTITY man.charmap.use.subset SYSTEM "../params/man.charmap.use.subset.xml">
+<!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.th.title.max.length SYSTEM "../params/man.th.title.max.length.xml">
-<!ENTITY man.charmap.uri SYSTEM "../params/man.charmap.uri.xml">
\ No newline at end of file
diff --git a/xsl/manpages/param.xweb b/xsl/manpages/param.xweb
index bdf2d4143..ab6abe18c 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;
 &man.th.title.max.length;
   </reference>
   <reference id="charmap">
@@ -78,6 +79,7 @@
 <src:fragref linkend="man.charmap.uri.frag"/>
 <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.th.title.max.length.frag"/>
 </xsl:stylesheet>
     </src:fragment>
diff --git a/xsl/manpages/refentry.xsl b/xsl/manpages/refentry.xsl
index 3a9bb3344..3c102313b 100644
--- a/xsl/manpages/refentry.xsl
+++ b/xsl/manpages/refentry.xsl
@@ -20,6 +20,7 @@
         <!-- no title on secondary refnamedivs! -->
       </xsl:when>
       <xsl:otherwise>
+        <xsl:call-template name="mark.subheading"/>
         <xsl:text>.SH "</xsl:text>
         <xsl:call-template name="string.upper">
           <xsl:with-param name="string">
@@ -32,6 +33,7 @@
       </xsl:otherwise>
     </xsl:choose>
     <xsl:text>&#10;</xsl:text>
+    <xsl:call-template name="mark.subheading"/>
     <xsl:for-each select="refname">
       <xsl:if test="position()>1">
         <xsl:text>, </xsl:text>
@@ -44,6 +46,7 @@
   </xsl:template>
 
   <xsl:template match="refsynopsisdiv">
+    <xsl:call-template name="mark.subheading"/>
     <xsl:text>.SH "</xsl:text>
     <xsl:call-template name="string.upper">
       <xsl:with-param name="string">
@@ -53,28 +56,32 @@
       </xsl:with-param>
     </xsl:call-template>
     <xsl:text>"&#10;</xsl:text>
+    <xsl:call-template name="mark.subheading"/>
     <xsl:apply-templates/>
   </xsl:template>
 
   <xsl:template match="refsect1|refentry/refsection">
+    <xsl:call-template name="mark.subheading"/>
     <xsl:text>.SH "</xsl:text>
     <xsl:call-template name="string.upper">
       <xsl:with-param name="string" select="title"/>
     </xsl:call-template>
     <xsl:text>"&#10;</xsl:text>
+    <xsl:call-template name="mark.subheading"/>
     <xsl:apply-templates/>
   </xsl:template>
 
   <xsl:template match="refsect2|refentry/refsection/refsection">
+    <xsl:call-template name="mark.subheading"/>
     <xsl:text>.SS "</xsl:text>
     <xsl:value-of select="title[1]"/>
     <xsl:text>"&#10;</xsl:text>
+    <xsl:call-template name="mark.subheading"/>
     <xsl:apply-templates/>
   </xsl:template>
 
   <xsl:template match="refsect3|refsection">
     <xsl:call-template name="nested-section-title"/>
-    <xsl:text>&#10;</xsl:text>
     <xsl:text>.RS 3&#10;</xsl:text>
     <xsl:apply-templates/>
     <xsl:text>.RE&#10;</xsl:text>
-- 
2.40.0