You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@apache.org on 2026/04/29 18:16:28 UTC
svn commit: r1933515 - httpd/httpd/branches/2.4.x/docs/manual/style/xsl
Author: rbowen
Date: Wed Apr 29 18:16:28 2026
New Revision: 1933515
Log:
nroff: Render seealso elements as SEE ALSO man page section instead of suppressing them (Bug 62678)
Modified:
httpd/httpd/branches/2.4.x/docs/manual/style/xsl/nroff.xsl
Modified: httpd/httpd/branches/2.4.x/docs/manual/style/xsl/nroff.xsl
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/style/xsl/nroff.xsl Wed Apr 29 18:16:24 2026 (r1933514)
+++ httpd/httpd/branches/2.4.x/docs/manual/style/xsl/nroff.xsl Wed Apr 29 18:16:28 2026 (r1933515)
@@ -139,6 +139,15 @@
<xsl:apply-templates select="section[@id='synopsis']" />&lf;
<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 -->
@@ -381,7 +390,19 @@ FATAL: only tables with two (2) columns
<!-- ==================================================================== -->
<!-- remove some stuff from the output -->
<!-- ==================================================================== -->
-<xsl:template match="parentdocument|seealso|dd|td|example/br|dd/br" />
+<xsl:template match="parentdocument|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>
<!-- ==================================================================== -->