Re: Undocumented git-diff syntax

From: Jakub Narebski <jnareb@gmail.com>
Date: Oct 11, 2010, 16:57 UTC
Message-ID: <m3wrpoekha.fsf@localhost.localdomain>
In-Reply-To: <20101011161721.35940919@chalon.bertin.fr>

Yann Dirson <dirson@bertin.fr> writes:

> That said, this two-path construct would surely deserve its own
> synopsis.

Something like this?  Just kidding...

 SYNOPSIS
 --------
+[verse]
 'git diff' [<common diff options>] <commit>{0,2} [--] [<path>...]
+'git diff' [<common diff options>] <tree-ish> <tree-ish> [--] [<path>...]
+'git diff' [<common diff options>] <blob-or-path> <blob-or-path>

Possibly that <tree-ish> can be also a <directory> (on filesystem).

You can e.g. use

  git diff HEAD:git-gui/ 00e9de7^^
           ^^^^^^^^^^^^^ ~~~~~~~~~
           \-- tree       \-- commit (in subtree-merged history)

-- 
Jakub Narebski
Poland
ShadeHawk on #git