From: Jonathan Nieder <jrnieder@gmail.com>
Date: Sun, 20 May 2012 17:58:28 GMT
Subject: Re: [1.8.0] use 'stage' term consistently
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:

>>        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