Code

Quote ' as \(aq in manpages
authorThomas Rast <trast@student.ethz.ch>
Thu, 22 Oct 2009 08:19:06 +0000 (10:19 +0200)
committerJunio C Hamano <gitster@pobox.com>
Thu, 22 Oct 2009 19:59:50 +0000 (12:59 -0700)
commit204d363f5a05bba0bdeb13f96a08d5078dcee820
tree65c9269eb12da5038ff06b07cbf877c86218bfc5
parentba7e81430a32614982172c7064c01db43f55b4bb
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>
Documentation/Makefile
Documentation/manpage-quote-apos.xsl [new file with mode: 0644]
Makefile