mirror of
https://github.com/git/git
synced 2024-08-26 19:19:18 +00:00
![Chris Johnsen](/assets/img/avatar_default.png)
With this change, the "spurious .sp" suppression XSLT code is disabled by default. It can be enabled by defining DOCBOOK_SUPPRESS_SP. The "spurious .sp" XSLT fragment was used to work around a bug first released in docbook-xsl 1.69.1. Modern versions of docbook-xsl are negatively affected by the code (some empty lines are omitted from manpage output; see <http://article.gmane.org/gmane.comp.version-control.git/115302>). The key revisions in the docbook SVN repo seem to be 5144 (before docbook-xsl 1.69.1) and 6359 (before docbook-xsl 1.71.1). Testing done with asciidoc 8.3.1 and docbook-xsl 1.74.0. Signed-off-by: Chris Johnsen <chris_johnsen@pobox.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
36 lines
1.2 KiB
XML
36 lines
1.2 KiB
XML
<!-- manpage-base.xsl:
|
|
special formatting for manpages rendered from asciidoc+docbook -->
|
|
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
|
version="1.0">
|
|
|
|
<!-- these params silence some output from xmlto -->
|
|
<xsl:param name="man.output.quietly" select="1"/>
|
|
<xsl:param name="refentry.meta.get.quietly" select="1"/>
|
|
|
|
<!-- convert asciidoc callouts to man page format;
|
|
git.docbook.backslash and git.docbook.dot params
|
|
must be supplied by another XSL file or other means -->
|
|
<xsl:template match="co">
|
|
<xsl:value-of select="concat(
|
|
$git.docbook.backslash,'fB(',
|
|
substring-after(@id,'-'),')',
|
|
$git.docbook.backslash,'fR')"/>
|
|
</xsl:template>
|
|
<xsl:template match="calloutlist">
|
|
<xsl:value-of select="$git.docbook.dot"/>
|
|
<xsl:text>sp </xsl:text>
|
|
<xsl:apply-templates/>
|
|
<xsl:text> </xsl:text>
|
|
</xsl:template>
|
|
<xsl:template match="callout">
|
|
<xsl:value-of select="concat(
|
|
$git.docbook.backslash,'fB',
|
|
substring-after(@arearefs,'-'),
|
|
'. ',$git.docbook.backslash,'fR')"/>
|
|
<xsl:apply-templates/>
|
|
<xsl:value-of select="$git.docbook.dot"/>
|
|
<xsl:text>br </xsl:text>
|
|
</xsl:template>
|
|
|
|
</xsl:stylesheet>
|