From: Nicolas Pitre Date: Thu, 14 Dec 2006 17:02:25 GMT Subject: Re: [PATCH] Update git-diff documentation Message-ID: In-Reply-To: On Thu, 14 Dec 2006, Johannes Schindelin wrote: > 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.