From: J. Bruce Fields Date: Fri, 03 Aug 2007 12:56:34 GMT Subject: Re: [PATCH] user-manual: mention git gui citool (commit, amend) Message-ID: <20070803125634.GB28323@fieldses.org> In-Reply-To: On Fri, Aug 03, 2007 at 07:08:44AM +0200, Steffen Prohaska wrote: > > 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." Sounds good to me. Somebody do that! --b.