From: Nicolas Pitre <nico@cam.org>
Date: Sat, 09 Dec 2006 22:26:51 GMT
Subject: Re: [PATCH] Documentation/git-commit: rewrite to make it more end-user friendly.
Message-ID: <Pine.LNX.4.64.0612091718190.2630@xanadu.home>
In-Reply-To: <7vpsas91e5.fsf@assigned-by-dhcp.cox.net>

On Sat, 9 Dec 2006, Junio C Hamano wrote:

> Attached is an incremental patch on top of what you commented
> on.
> 
[...]
>  <file>...::
> -	Files to be committed.  The meaning of these is
> -	different between `--include` and `--only`.  Without
> -	either, it defaults `--only` semantics.
> +	When files are given on the command line, the command
> +	commits the contents of the named files, without
> +	recording the changes already staged.  The contents of
> +	these files are also staged for the next commit on top
> +	of what have been staged before.

Might something like "When -i is provided however..." be missing in the 
above?  Otherwise it is rather confusing.

Besides that I'm really happy with the result.