Re: A tiny documentation patch
- From
Michael J Gruber <git@drmicha.warpmail.net>
- Date
- Aug 11, 2009, 08:01 UTC
- Message-ID
- <4A812575.50105@drmicha.warpmail.net>
- In-Reply-To
- <200908101659.28291.trast@student.ethz.ch>
Thomas Rast venit, vidit, dixit 10.08.2009 16:59:
> Štěpán Němec wrote:
[...]
Show 15 quoted lines
> [...]
>> -In mirror mode, enabled with `\--mirror`, the refs will not be stored
>> +In mirror mode, enabled with `--mirror`, the refs will not be stored
> [...]
>> -mode, furthermore, `git push` will always behave as if `\--mirror`
>> +mode, furthermore, `git push` will always behave as if `--mirror`
>
> While I'm not sure how far back you'd have to go to find an asciidoc
> that does need this escaping, it's definitely *not* a typo. In some
> instances, -- turns into em dashes.
>
> If you are seeing stray backslashes in the output (I don't), I suspect
> you are either running asciidoc 8.x but forgot to set ASCIIDOC8, or
> 8.4.1+ and are missing the patch 71c020c (Disable asciidoc 8.4.1+
> semantics for `{plus}` and friends, 2009-07-25).[...]
In current next's Documentation/, we have 149 lines with `-- and 48 lines with `\--. How is our policy regarding old AsciiDoc? I suggest (read: volunteer) making these things uniform one way or the other, depending which versions we want to support.
Michael