author | Thomas Rast <trast@student.ethz.ch> | |
Thu, 22 Oct 2009 08:19:06 +0000 (10:19 +0200) | ||
committer | Junio C Hamano <gitster@pobox.com> | |
Thu, 22 Oct 2009 19:59:50 +0000 (12:59 -0700) | ||
commit | 204d363f5a05bba0bdeb13f96a08d5078dcee820 | |
tree | 65c9269eb12da5038ff06b07cbf877c86218bfc5 | tree | snapshot |
parent | ba7e81430a32614982172c7064c01db43f55b4bb | commit | diff |
Quote ' as \(aq in manpages
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>
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>
Documentation/Makefile | diff | blob | history | |
Documentation/manpage-quote-apos.xsl | [new file with mode: 0644] | blob |
Makefile | diff | blob | history |