From: Junio C Hamano <gitster@pobox.com>
Date: Tue, 17 Nov 2009 23:13:28 GMT
Subject: Re: [PATCH v2 0/2] user-manual: new "getting started" section
Message-ID: <7vzl6kd9t3.fsf@alter.siamese.dyndns.org>
In-Reply-To: <94a0d4530911171506o2b08954bw4acba8ea9193e65d@mail.gmail.com>

Felipe Contreras <felipe.contreras@gmail.com> writes:

> If the goal of the change is to make things more user-friendly, then
> I'd say "git diff HEAD @stage" is better than "git diff
> --tree-vs-staged HEAD".

Exactly.  That is where we disagree.  The funny "@stage" does not convey
the fact that it is affecting how "git diff" operates, like any other
option like "-R" does in "git diff -R" command line does.  Now the user
needs to know git commands take -option like other normal tools do, but in
addition they need to remember that an oddball "diff" subcommand takes
"@funny" in addition to the usual "-option".

How would that be an improvement?