From: Štěpán Němec <stepnem@gmail.com>
Date: Thu, 04 Nov 2010 21:51:55 GMT
Subject: Re: [PATCH] docs: clarify git diff modes of operation
Message-ID: <871v70hi4k.fsf@gmail.com>
In-Reply-To: <20101104211729.GA5551@sigill.intra.peff.net>

Jeff King <peff@peff.net> writes:

> Note that in all versions (the original, yours, and mine) we gloss over
> the fact that <commit> can actually be any two objects (as long as they
> are bother either tree-ishs or blobs).

Yeah, I thought about that, too. I think it would be nice to use more
precise placeholders like <tree-ish> or <object> (which do already
occur in other places), but I suspect it might be needed/useful at more
places and would better be done as a separate patch (preferably by someone
who is more familiar with the internals than me).

> I'm not sure if it is worth documenting that subtlety here (at least
> the tree-ish thing gets mentioned later in the description; I'm not
> sure we ever document "git diff HEAD:Makefile HEAD^:Makefile"
> anywhere).

There's gitrevisions(7) (also pointed to from the git-diff manpage)
which describes those in some detail.

  Štěpán