204d363f5a
The docbook/xmlto toolchain insists on quoting ' as \'. This does achieve the quoting goal, but modern 'man' implementations turn the apostrophe into a unicode "proper" apostrophe (given the right circumstances), breaking code examples in many of our manpages. Quote them as \(aq instead, which is an "apostrophe quote" as per the groff_char manpage. Unfortunately, as Anders Kaseorg kindly pointed out, this is not portable beyond groff, so we add an extra Makefile variable GNU_ROFF which you need to enable to get the new quoting. Thanks also to Miklos Vajna for documentation. Signed-off-by: Thomas Rast <trast@student.ethz.ch> Signed-off-by: Junio C Hamano <gitster@pobox.com>
17 lines
585 B
XML
17 lines
585 B
XML
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
|
version="1.0">
|
|
|
|
<!-- work around newer groff/man setups using a prettier apostrophe
|
|
that unfortunately does not quote anything when cut&pasting
|
|
examples to the shell -->
|
|
<xsl:template name="escape.apostrophe">
|
|
<xsl:param name="content"/>
|
|
<xsl:call-template name="string.subst">
|
|
<xsl:with-param name="string" select="$content"/>
|
|
<xsl:with-param name="target">'</xsl:with-param>
|
|
<xsl:with-param name="replacement">\(aq</xsl:with-param>
|
|
</xsl:call-template>
|
|
</xsl:template>
|
|
|
|
</xsl:stylesheet>
|