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

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

From
Jonas Fonseca <fonseca@diku.dk>
Date
Nov 12, 2008, 00:04 UTC
Message-ID
<20081112000445.GB17662@diku.dk>
In-Reply-To
<ddb82bf60811100214j4246cf25yc1263c2ae8cd10fc@mail.gmail.com>
Piotr Findeisen <piotr.findeisen@gmail.com> wrote Mon, Nov 10, 2008:
Show 9 quoted lines
> > 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 :)
At least you don't loose anything compared to the current behavior. ;)
Show 5 quoted lines
> >        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.
I would like to see such a patch.
-- 
Jonas Fonseca
Previous: Piotr FindeisenNext: Piotr Findeisen
Message 7 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.