From: Junio C Hamano Date: Thu, 11 Aug 2011 22:39:13 GMT Subject: Re: Suggestions to make git easier to understand Message-ID: <7vmxffpo8e.fsf@alter.siamese.dyndns.org> In-Reply-To: <20110811221627.GA32005@elie.gateway.2wire.net> Jonathan Nieder writes: >> 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.