From 52f3b610f7763d1a5dba3e83b1a7f9b0eeb8e9cf Mon Sep 17 00:00:00 2001
From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Thu, 23 Mar 2006 03:02:10 +0000
Subject: [PATCH] Fixed handling of table footnotes. With this checkin, the
 table support in the manpages stylesheet is now basically feature complete.
 So this change closes request #619532, "No support for tables" -- the oldest
 currently open manpages feature request, submitted by Ben Secrest (blsecres)
 on 2002-10-07. Congratulations to me [patting myself on the back].

---
 xsl/manpages/block.xsl   |  4 +-
 xsl/manpages/docbook.xsl |  1 +
 xsl/manpages/table.xsl   | 82 ++++++++++++++++++++++++++++++++++------
 3 files changed, 74 insertions(+), 13 deletions(-)

diff --git a/xsl/manpages/block.xsl b/xsl/manpages/block.xsl
index d8729a69f..6cfef0983 100644
--- a/xsl/manpages/block.xsl
+++ b/xsl/manpages/block.xsl
@@ -39,7 +39,9 @@
 </xsl:template>
 
 <xsl:template match="para">
-  <xsl:text>.PP&#10;</xsl:text>
+  <xsl:if test="not(ancestor::footnote[ancestor::table])">
+    <xsl:text>.PP&#10;</xsl:text>
+  </xsl:if>
   <xsl:call-template name="mixed-block"/>
   <xsl:text>&#10;</xsl:text>
 </xsl:template>
diff --git a/xsl/manpages/docbook.xsl b/xsl/manpages/docbook.xsl
index 381d91e29..dfd2b3537 100644
--- a/xsl/manpages/docbook.xsl
+++ b/xsl/manpages/docbook.xsl
@@ -46,6 +46,7 @@
   <xsl:param name="man.funcsynopsisinfo.font">B</xsl:param>
   <xsl:param name="man.table.headings.font">B</xsl:param>
   <xsl:param name="man.table.title.font">B</xsl:param>
+  <xsl:param name="man.table.footnotes.separator.line">----</xsl:param>
 
 <!-- ==================================================================== -->
 
diff --git a/xsl/manpages/table.xsl b/xsl/manpages/table.xsl
index d27ffe500..9cf5b21dc 100644
--- a/xsl/manpages/table.xsl
+++ b/xsl/manpages/table.xsl
@@ -134,9 +134,6 @@
       <xsl:value-of select="$man.table.title.font"/>
       <xsl:text> </xsl:text>
       <xsl:if test="self::htmltable">
-      <xsl:for-each select="ancestor-or-self::*">
-        <xsl:message><xsl:value-of select="@*"/></xsl:message>
-      </xsl:for-each>
     </xsl:if>
       <xsl:if test="parent::td|self::htmltable[@parent = 'td']">
         <xsl:text>*[nested&#160;table]</xsl:text>
@@ -288,7 +285,8 @@
           align="{@align}">
       <xsl:choose>
         <xsl:when test=".//tr">
-          <xsl:message>Warn: Extracted a nested table. (No nesting support in tbl(1).)</xsl:message>
+          <xsl:message
+              >Warn: Extracted a nested table. [tbl(1) does not support nesting]</xsl:message>
           <xsl:text>[nested&#160;table]*&#10;</xsl:text>
         </xsl:when>
         <xsl:otherwise>
@@ -453,20 +451,80 @@
     </xsl:if>
   </xsl:template>
 
-  <!-- * Not sure what if anything to do with colgroup -->
-  <xsl:template match="colgroup"/>
-  <xsl:template match="col"/>
+  <!-- * ============================================================== -->
+  <!-- *    Handle table footnotes                                      -->
+  <!-- * ============================================================== -->
+  <xsl:template match="footnote" mode="table.footnote.mode">
+    <xsl:variable name="footnotes" select=".//footnote"/>
+    <xsl:variable name="table.footnotes"
+                  select=".//tgroup//footnote"/>
+    <xsl:value-of select="$man.table.footnotes.separator.line"/>
+    <xsl:text>&#10;</xsl:text>
+    <xsl:text>.br&#10;</xsl:text>
+    <xsl:apply-templates select="*[1]" mode="footnote.body.number"/>
+    <xsl:apply-templates select="*[position() &gt; 1]"/>
+  </xsl:template>
 
-  <!-- * The following templates are needed for dealing with -->
-  <!-- * table-footnote markup generated by the HTML stylesheets. -->
-  <xsl:template match="div">
-    <xsl:apply-templates/>
+  <!-- * The following template for footnote.body.number mode was just -->
+  <!-- * lifted from the HTML stylesheets with some minor adjustments -->
+  <xsl:template match="*"  mode="footnote.body.number">
+    <xsl:variable name="name">
+      <xsl:text>ftn.</xsl:text>
+      <xsl:call-template name="object.id">
+        <xsl:with-param name="object" select="ancestor::footnote"/>
+      </xsl:call-template>
+    </xsl:variable>
+    <xsl:variable name="href">
+      <xsl:text>#</xsl:text>
+      <xsl:call-template name="object.id">
+        <xsl:with-param name="object" select="ancestor::footnote"/>
+      </xsl:call-template>
+    </xsl:variable>
+    <xsl:variable name="footnote.mark">
+      <xsl:text>[</xsl:text>
+      <xsl:apply-templates select="ancestor::footnote"
+                           mode="footnote.number"/>
+      <xsl:text>]&#10;</xsl:text>
+    </xsl:variable>
+    <xsl:variable name="html">
+      <xsl:apply-templates select="."/>
+    </xsl:variable>
+    <xsl:choose>
+      <xsl:when test="function-available('exsl:node-set')">
+        <xsl:variable name="html-nodes" select="exsl:node-set($html)"/>
+        <xsl:choose>
+          <xsl:when test="$html-nodes//p">
+            <xsl:apply-templates select="$html-nodes" mode="insert.html.p">
+              <xsl:with-param name="mark" select="$footnote.mark"/>
+            </xsl:apply-templates>
+          </xsl:when>
+          <xsl:otherwise>
+            <xsl:apply-templates select="$html-nodes" mode="insert.html.text">
+              <xsl:with-param name="mark" select="$footnote.mark"/>
+            </xsl:apply-templates>
+          </xsl:otherwise>
+        </xsl:choose>
+      </xsl:when>
+      <xsl:otherwise>
+        <xsl:copy-of select="$html"/>
+      </xsl:otherwise>
+    </xsl:choose>
   </xsl:template>
-  <xsl:template match="sup">
+
+  <!-- * The HTML stylesheets output <sup><a>...</a></sup> around -->
+  <!-- * footnote markers in tables -->
+  <xsl:template match="th/sup">
     <xsl:apply-templates/>
   </xsl:template>
   <xsl:template match="a">
     <xsl:apply-templates/>
   </xsl:template>
 
+  <!-- * ============================================================== -->
+  <!-- *    colgroup and col                                            -->
+  <!-- * ============================================================== -->
+  <!-- * Not sure what if anything to do with colgroup... -->
+  <xsl:template match="colgroup"/>
+  <xsl:template match="col"/>
+
 </xsl:stylesheet>
-- 
2.40.0