Re: [1.8.0] use 'stage' term consistently

From: Jonathan Nieder <jrnieder@gmail.com>
Date: May 20, 2012, 17:58 UTC
Message-ID: <20120520175828.GB3000@burratino>
In-Reply-To: <CAMP44s2cGeQq3V=jS1Xjg-S0-rMyKS79XFN9yFm+4KxMo963OA@mail.gmail.com>

Felipe Contreras wrote:

> On Sat, May 19, 2012 at 8:00 AM, Jonathan Nieder <jrnieder@gmail.com> wrote:

Show 10 quoted lines

>>        The "index" file (see gitindex(5)) typically holds a snapshot of
>>        the content of the working tree, and it is this snapshot that is
>>        taken as the content of the next commit.  Thus after making any
>>        changes to the working directory, and before running the commit
>>        command, you must use the add command to add any new or modified
>>        files.
>
> I find this paragraph completely unnecessary. This is useless
> distraction; the user wants to know about 'git add', she doesn't need
> to know about the index, and we should hide it from her.

Ok. Have you seen the current git-add(1) manpage? Do you have patches that improve it to avoid such useless background information in a non-confusing way?

Jonathan