Re: [PATCH] Update git-diff documentation

On Thu, 14 Dec 2006, Johannes Schindelin wrote:

Hi,

On Thu, 14 Dec 2006, Junio C Hamano wrote:

quoted

-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.