Re: Documentation/user-manual.txt, asciidoc and "--" escapes

From: Jonas Fonseca <fonseca@diku.dk>
Date: Nov 9, 2008, 18:52 UTC
Message-ID: <2c6b72b30811091052k77200785j722c8aed2beb7684@mail.gmail.com>
In-Reply-To: <ddb82bf60811090044l43eb4bb1ga5a16718a4176c29@mail.gmail.com>

> On Fri, Nov 7, 2008 at 04:09, Piotr Findeisen <piotr.findeisen@gmail.com> wrote:
>> Hello!

Hello,

>> The attached file is a result of running `git diff HEAD~1`.

Please read Documentation/SubmittingPatches for the preferred way to contribute patches.

>> Asciidoc replaces "--" with "—" when not in verbatim mode. This is
>> sometimes unwanted -- especially when citing command line options like
>> "git diff --cached". This commit includes proper quotes in user-manual.txt.

Newer asciidoc versions have the following "workaround". Maybe adding something like this to Documentation/asciidoc.conf would be more future proof.

# -- Spaced and unspaced em dashes (entity reference —) # But disallow unspaced in man pages because double-dash option name prefixes # are pervasive. ifndef::doctype-manpage[] (^|[^-\\])--($|[^-])=\1—\2 endif::doctype-manpage[] ifdef::doctype-manpage[] (^|\s*[^\S\\])--($|\s+)=\1—\2 endif::doctype-manpage[] \\--(?!-)=--

-- 
Jonas Fonseca