git/list[1] front-page[2] threads[3] people[4] search[5] about
 

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

From
PFPiotr 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

Previous: Jonas FonsecaNext: Jonas Fonseca
Message 6 of 9 in “Fwd: Documentation/user-manual.txt, asciidoc and "--" escapes”
  1. Piotr FindeisenNov 7, 2008
  2. Piotr FindeisenNov 9, 2008
  3. Jonas FonsecaNov 9, 2008
  4. Piotr FindeisenNov 10, 2008
  5. Jonas FonsecaNov 10, 2008
  6. Piotr FindeisenNov 10, 2008
  7. Jonas FonsecaNov 12, 2008
  8. Piotr FindeisenNov 14, 2008
  9. Junio C HamanoNov 15, 2008

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.