svn commit: r1933583 - httpd/httpd/trunk/docs/manual/style/xsl

[rb...@apache.org]

Author: rbowen
Date: Thu Apr 30 12:15:46 2026
New Revision: 1933583

Log:
Reverts the manpage xsl change from yesterday, which had unfortunate
side effects. I'm not sure what the right solution is here, but it's not
this. Perhaps someone else who understands manpage formatting better can
have a look at this.

Modified:
   httpd/httpd/trunk/docs/manual/style/xsl/nroff.xsl

Modified: httpd/httpd/trunk/docs/manual/style/xsl/nroff.xsl
==============================================================================
--- httpd/httpd/trunk/docs/manual/style/xsl/nroff.xsl	Thu Apr 30 12:15:44 2026	(r1933582)
+++ httpd/httpd/trunk/docs/manual/style/xsl/nroff.xsl	Thu Apr 30 12:15:46 2026	(r1933583)
@@ -140,14 +140,6 @@
 <xsl:apply-templates select="summary" />&lf;
 <xsl:apply-templates select="section[@id!='synopsis']" />&lf;
 
-<!-- SEE ALSO section from seealso elements -->
-<xsl:if test="seealso">
-<xsl:text>.SH "SEE ALSO"</xsl:text>&lf;
-<xsl:for-each select="seealso">
-<xsl:apply-templates select="." mode="seealso" />
-<xsl:if test="position() != last()">, </xsl:if>
-</xsl:for-each>&lf;
-</xsl:if>
 </xsl:template>
 <!-- /manualpage -->
 
@@ -273,7 +265,7 @@
 <!-- <strong>                                                             -->
 <!-- show it somewhat special (bold)                                      -->
 <!-- ==================================================================== -->
-<xsl:template match="strong|code">
+<xsl:template match="strong|code|program">
 <xsl:text>\fB</xsl:text>
     <xsl:apply-templates />
 <xsl:text>\fR</xsl:text>
@@ -382,7 +374,7 @@ FATAL: only tables with two (2) columns
 <!-- ==================================================================== -->
 <!-- pass through content                                                 -->
 <!-- ==================================================================== -->
-<xsl:template match="a|module|table|program|glossary|highlight|rfc">
+<xsl:template match="a|module|table|glossary|highlight|rfc">
 <xsl:apply-templates />
 </xsl:template>
 
@@ -390,19 +382,9 @@ FATAL: only tables with two (2) columns
 <!-- ==================================================================== -->
 <!-- remove some stuff from the output                                    -->
 <!-- ==================================================================== -->
-<xsl:template match="parentdocument|dd|td|example/br|dd/br" />
+<xsl:template match="parentdocument|seealso|dd|td|example/br|dd/br" />
 
-<!-- suppress seealso in normal flow (rendered separately in SEE ALSO) -->
-<xsl:template match="seealso" />
 
-<!-- ==================================================================== -->
-<!-- seealso mode: extract plain text for SEE ALSO section                -->
-<!-- ==================================================================== -->
-<xsl:template match="seealso" mode="seealso">
-<xsl:variable name="text" select="normalize-space(.)" />
-<xsl:text>
-</xsl:text><xsl:value-of select="$text" />
-</xsl:template>
 
 
 <!-- ==================================================================== -->