Re: [PATCH] Documentation/git-commit: rewrite to make it more end-user friendly.

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.