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

Re: [PATCH] Documentation: fix typos, grammar, asciidoc syntax

From
Junio C Hamano <gitster@pobox.com>
Date
Dec 20, 2008, 20:08 UTC
Message-ID
<7v3agiy5gs.fsf@gitster.siamese.dyndns.org>
In-Reply-To
<200812201418.38707.markus.heidelberg@web.de>
Markus Heidelberg <markus.heidelberg@web.de> writes:
Show 14 quoted lines
> Junio C Hamano, 20.12.2008:
>> Markus Heidelberg <markus.heidelberg@web.de> writes:
>> 
>> > @@ -172,7 +172,7 @@ only the primary branches.  In addition, if you happen to be on
>> >  your topic branch, it is shown as well.
>> >  
>> >  ------------
>> > -$ git show-branch --reflog='10,1 hour ago' --list master
>> > +$ git show-branch --reflog="10,1 hour ago" --list master
>> >  ------------
>> 
>> Is this just a personal taste, or a correction to typography?
>
> When using single quotes, the manpage displayed backticks.
It does not seem to do that to me:
    $ git help show-branch | grep 10,1 | od -bc
    0000000 040 040 040 040 040 040 040 040 040 040 044 040 147 151 164 040
                                                      $       g   i   t
    0000020 163 150 157 167 055 142 162 141 156 143 150 040 055 055 162 145
              s   h   o   w   -   b   r   a   n   c   h       -   -   r   e
    0000040 146 154 157 147 075 342 200 231 061 060 054 061 040 150 157 165
              f   l   o   g   = 342 200 231   1   0   ,   1       h   o   u
    0000060 162 040 141 147 157 342 200 231 040 055 055 154 151 163 164 040
              r       a   g   o 342 200 231       -   -   l   i   s   t
    0000100 155 141 163 164 145 162 012
              m   a   s   t   e   r  \n

It does not use ASCII single quote ' (\047) but the result still does render well enough to keep anybody who are typing, following the printed examples, from mistaking it from a backquote:

    http://pics.livejournal.com/gitster/pic/00009pk0/g6

But in this particular case, because sq/dq does not make any difference to the example, I am Ok to change it to dq. But I suspect there are many other places that do need to use sq in examples, so...

Previous: Markus HeidelbergNext: Teemu Likonen
Message 4 of 9 in “Documentation: fix typos, grammar, asciidoc syntax”
  1. Documentation: fix typos, grammar, asciidoc syntaxMarkus Heidelberg, Dec 19, 2008
  2. Junio C HamanoDec 20, 2008
  3. Markus HeidelbergDec 20, 2008
  4. Junio C HamanoDec 20, 2008
  5. Teemu LikonenDec 20, 2008
  6. Markus HeidelbergDec 20, 2008
  7. Teemu LikonenDec 20, 2008
  8. Markus HeidelbergDec 20, 2008
  9. Teemu LikonenDec 20, 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.