Re: Documentation/user-manual.txt, asciidoc and "--" escapes
- From
- Piotr Findeisen <piotr.findeisen@gmail.com>
- Date
- Nov 10, 2008, 10:14 UTC
- Message-ID
- <ddb82bf60811100214j4246cf25yc1263c2ae8cd10fc@mail.gmail.com>
- In-Reply-To
- <20081110100757.GA12868@diku.dk>
Show 15 quoted lines
> >> I noticed that all substitutions "--" -> "—", where "—" is a part of >> sentence punctuation, match \w--\w pattern (e.g. no spaces on both >> sides) and probably this is how it should be written in English. But >> basing on this doesn't seem to me to be fool proof. > > So another option is to disable all substitution of "--" and just use > the "—" character when it is explicitly needed. The documentation is > using UTF-8 after all. This would also fix the usage of "--" in the > manpages, e.g. > > You've now initialized the working directory--you may notice ... > > in gittutorial(7). On my setup, with "--" replaced with "—", I get the > following nroff code:
On my machine, make gittutorial.7 produces manpage that displays "--" in this place :)
> > You've now initialized the working directory\(emyou may notice
Anyway, this may be a good idea to use unambiguous "—" (though people writing docs may be used to using "--" as a punctuation). I can run through the Documentation replacing "\w--\w" with m-dash, if you want.
Regards, Piotr