Skip to content
  • Thomas Rast's avatar
    Quote ' as \(aq in manpages · 204d363f
    Thomas Rast authored and Junio C Hamano's avatar Junio C Hamano committed
    
    
    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: default avatarThomas Rast <trast@student.ethz.ch>
    Signed-off-by: default avatarJunio C Hamano <gitster@pobox.com>
    204d363f