From: Zenaan Harkness <zen@freedbms.net>
Date: Sat, 20 Aug 2016 07:25:00 GMT
Subject: Re: git rm --cached should be git rm --cache or git rm --stage
Message-ID: <20160820072500.GC24992@x220-a02>
In-Reply-To: <20160820072214.GB24992@x220-a02>

   Please CC me :)

> From man git-rm:
> 
> --cached
>   Use this option to unstage and remove paths only from the index.
>   Working tree files, whether modified or not, will be left alone.
> 
> 
> This wording is unclear and dangerous, and ought be cleaned up somehow.
> 
> Probably also the option name should change.
> 
> See here for examples of community self-help compensating for git-rm man
> page's particularly bad wording:
> http://stackoverflow.com/questions/6919121/why-are-there-2-ways-to-unstage-a-file-in-git


Also, perhaps a git porcelain command "git unstage" to unstage staged
changes.  Something small like this might make a huge difference for git
newbies.