From: Steffen Prohaska <prohaska@zib.de>
Date: Fri, 03 Aug 2007 05:08:44 GMT
Subject: Re: [PATCH] user-manual: mention git gui citool (commit, amend)
Message-ID: <B14C42A6-F4BD-40D7-AEAF-66FFF492AB9B@zib.de>
In-Reply-To: <20070802223132.GA15212@fieldses.org>


On Aug 3, 2007, at 12:31 AM, J. Bruce Fields wrote:

>>> Also, I like the verb "stage" as a way to explain the part of the  
>>> index
>>> file in creating commits, but I've been consistently using the word
>>> "index" throughout the user manual, and I think that's consistent  
>>> with
>>> the rest of the documentation--so don't avoid it here.
>>
>> "staging/unstaging" is how git gui calls adding/removing files to and
>> from the index.
>
> I understand what you meant, but a reader of the user manual at this
> point might not, since it's been consistently saying things like  
> "to add
> the contents of a new file to the index, use git add".  So we  
> should use
> the same language here.  Unless we want to update the whole thing  
> to use
> "stage" and "unstage".  I'd rather not.

Agree. But we could briefly introduce git gui's dialect, something like

"git gui lets you select files (use menu 'Commit > Stage to Commit') or
individually diff hunks (use 'Stage Hunk For Commit' in context menu of
diff view) for inclusion in the index."

	Steffen