Re: [PATCH] Implement git-staged, an alias for 'git diff --cached'.

From: Teemu Likonen <tlikonen@iki.fi>
To: Wincent Colaiuta <win@wincent.com>
Cc: Johannes Schindelin <Johannes.Schindelin@gmx.de>,
	David Symonds <dsymonds@gmail.com>,
	git@vger.kernel.org, gitster@pobox.com, Jeff King <peff@peff.net>
Subject: Re: [PATCH] Implement git-staged, an alias for 'git diff --cached'.
Date: Wed, 29 Oct 2008 20:30:39 +0200	[thread overview]
Message-ID: <878ws7w8xc.fsf@iki.fi> (raw)
In-Reply-To: <E4E10B61-FA92-417C-9046-F9DE3B48C2A6@wincent.com> (Wincent Colaiuta's message of "Wed\, 29 Oct 2008 18\:42\:57 +0100")

Wincent Colaiuta (2008-10-29 18:42 +0100) wrote:

> El 29/10/2008, a las 18:03, Johannes Schindelin escribió:
>> I completely disagree. If the existing set of commands causes
>> confusion, we need to deprecate those parts and add new commands.
>> Even if we have a ton of commands already.
>
> The confusion isn't at the command level; it's at the switch/option
> level. The solution isn't to add a new command.

I don't remember being confused in particular area but I think it's a
_very_ good thing that the following three are behind the same "diff"
command:

    git diff
    git diff --cached       (or --staged)
    git diff HEAD

It's also good idea to pretty much always teach those three together.