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

Re: [PATCH] Update git-diff documentation

From
Nicolas Pitre <nico@cam.org>
Date
Dec 14, 2006, 17:02 UTC
Message-ID
<Pine.LNX.4.64.0612141157270.18171@xanadu.home>
In-Reply-To
<Pine.LNX.4.63.0612140957590.3635@wbgn013.biozentrum.uni-wuerzburg.de>
On Thu, 14 Dec 2006, Johannes Schindelin wrote:
Show 11 quoted lines
> Hi,
> 
> On Thu, 14 Dec 2006, Junio C Hamano wrote:
> 
> > -Show changes between two trees, a tree and the working tree, a
> > -tree and the index file, or the index file and the working tree.
> > -The combination of what is compared with what is determined by
> > -the number of trees given to the command.
> > +This command shows changes between four combinations of states.
> 
> I think the old explanation, while longer, is clearer.

It might not if you don't know what a "tree" is in git speak. The notion of what a tree refers to is slowly introduced afterwards which I think is better than delivering everything in a dense four lines right up front.

Previous: Jakub Narebski
Message 5 of 5 in “Update git-diff documentation”
  1. Update git-diff documentationJunio C Hamano, Dec 14, 2006
  2. Johannes SchindelinDec 14, 2006
  3. Cleanup git-diff documentationBrian Gernhardt, Dec 14, 2006
  4. Jakub NarebskiDec 15, 2006
  5. Nicolas PitreDec 14, 2006

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.