Re: Suggestions to make git easier to understand

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 11, 2011, 22:39 UTC
Message-ID: <7vmxffpo8e.fsf@alter.siamese.dyndns.org>
In-Reply-To: <20110811221627.GA32005@elie.gateway.2wire.net>

Jonathan Nieder <jrnieder@gmail.com> writes:

Show 11 quoted lines

>> Maybe
>> --cached could have an alias like --index-only for things to be more
>> intuitive as well.
>> 
>> `git rm --index-only somefile` is more understandable than `git rm
>> --cached somefile` imho.
>> 
>> Also, in ls-files, --stage could maybe use an alias like --contents
>> for it to be more self-explanatory.
>
> These suggestions also seem sane.

The --index-only synonym was throwed around in a handful of discussions in the past. It probably would not hurt, I would say.

I do not think "ls-files --contents" makes things any better, though. Until a new user encounters a conflicted state, it might look like that the primary point of "ls-files -s" is to show the object names, but it also is important that it shows the stage numbers.