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

Re: [PATCH] git-rm.txt: Fix quoting

From
Jeff King <peff@peff.net>
Date
Dec 7, 2010, 17:25 UTC
Message-ID
<20101207172542.GA25827@sigill.intra.peff.net>
In-Reply-To
<20101207171939.GA21105@burratino>
On Tue, Dec 07, 2010 at 11:19:39AM -0600, Jonathan Nieder wrote:
Show 14 quoted lines
> Michael J Gruber wrote:
> 
> > --- a/Documentation/git-rm.txt
> > +++ b/Documentation/git-rm.txt
> > @@ -111,8 +111,8 @@ tree using this command:
> >  git ls-files -z | xargs -0 rm -f
> >  ----------------
> >  
> > -and then "untar" the new code in the working tree. Alternately
> > -you could "rsync" the changes into the working tree.
> > +and then `untar` the new code in the working tree. Alternately
> > +you could `rsync` the changes into the working tree.
> 
> I like the patch.  Is there really an "untar" command?

Heh. Yeah, I was so caught up in looking at formatting that I didn't think about the actual meaning. :) Untar should definitely not be a literal (and should not have been quoted in the first place).

> Maybe something like this on top?  ('rsync' is in italics because it
> is just a command name rather than a full command ready to be typed on
> the command line.)
No opinion on that from me.
>  Using ``git commit -a''
> -~~~~~~~~~~~~~~~~~~~~~
> +~~~~~~~~~~~~~~~~~~~~~~~

I think this length doesn't have to match the text above, but I agree it looks better to viewers of the source if it does.

-Peff
Previous: Jonathan NiederNext: Michael J Gruber
Message 7 of 9 in “[BUG] yet another doc formatting problem”
  1. Jeff KingDec 7, 2010
  2. Michael J GruberDec 7, 2010
  3. git-rm.txt: Fix quotingMichael J Gruber, Dec 7, 2010
  4. Jeff KingDec 7, 2010
  5. Michael J GruberDec 8, 2010
  6. Jonathan NiederDec 7, 2010
  7. Jeff KingDec 7, 2010
  8. [PATCHv2] git-rm.txt: Fix quotingMichael J Gruber, Dec 8, 2010
  9. Junio C HamanoDec 7, 2010

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.