Re: [PATCH] added a built-in alias for 'stage' to the 'add' command

From: Junio C Hamano <gitster@pobox.com>
Date: Dec 2, 2008, 01:38 UTC
Message-ID: <7vbpvvqrub.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <20081201172902.GA41963@agadorsparticus>

Scott Chacon <schacon@gmail.com> writes:

> Subject: Re: [PATCH] added a built-in alias for 'stage' to the 'add' command

s/added/Add/;

Write your commit log message in present tense (recall David Brown's talk at GitTogether '08? ;-)

> this comes from conversation at the GitTogether where we thought it would

s/this/This/;

Show 9 quoted lines

> be helpful to be able to teach people to 'stage' files because it tends
> to cause confusion when told that they have to keep 'add'ing them.
>
> This continues the movement to start referring to the index as a
> staging area (eg: the --staged alias to 'git diff'). Also added a
> doc file for 'git stage' that basically points to the docs for
> 'git add'.
>
> Signed-off-by: Scott Chacon <schacon@gmail.com>

I think this is fine but I'd rather not risk the documentation getting stale over time, so...

Show 6 quoted lines

> +SYNOPSIS
> +--------
> +[verse]
> +'git stage' [-n] [-v] [--force | -f] [--interactive | -i] [--patch | -p]
> +	  [--all | [--update | -u]] [--intent-to-add | -N]
> +	  [--refresh] [--ignore-errors] [--] <filepattern>...

...I think this should read something like

	'git stage' args...