Added support for man.output.quietly for writing of stubs.

Also, added comments regarding display of .TH contents across
platforms.

diff --git a/xsl/manpages/other.xsl b/xsl/manpages/other.xsl
index 576dba307619beadba289619023521fe06148fdf..54f733bb32efc5b98b4e49c94de37ec551fbc491 100644 (file)
--- a/xsl/manpages/other.xsl
+++ b/xsl/manpages/other.xsl
@@ -38,16 +38,21 @@
 <!-- ==================================================================== -->
 
   <xsl:template name="TH.title.line">
-    
-    <!-- * FYI: Here is how the .TH contents show up in a rendered man page: -->
+
+    <!-- * The exact way that .TH contents are displayed is system- -->
+    <!-- * dependent; it varies somewhat between OSes and roff -->
+    <!-- * versions. Below is a description of how Linux systems with -->
+    <!-- * a modern groff seem to render .TH contents. -->
     <!-- * -->
     <!-- *   title(section)      extra3      title(section)  <- page header -->
     <!-- * -->
     <!-- *   extra2              extra1      title(section)  <- page footer-->
     <!-- * -->
     <!-- * Note the while extra1, extra2, and extra3 are all optional, almost all -->
-    <!-- * pages include an "extra1", which is almost always a date. -->
-
+    <!-- * pages include an "extra1", which is almost always a date, -->
+    <!-- * and it is almost always rendered in the same place (the -->
+    <!-- * middle column of the footer), across all OSes and roff versions. -->
+    <!-- * -->
     <!-- * Here are a couple of examples of real-world man pages that have -->
     <!-- * useful page headers/footers: -->
     <!-- * -->
@@ -111,6 +116,7 @@
           <xsl:with-param name="filename"
                           select="concat(normalize-space(.), '.',
                                   $metadata/section)"/>
+          <xsl:with-param name="quiet" select="$man.output.quietly"/>
           <xsl:with-param
               name="content"
               select="concat('.so man', $metadata/section, '/',