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

Junio C Hamano wrote:

Nicolas Pitre [off-list ref] writes:

quoted

quoted

 -o|--only::
-   Commit only the files specified on the command line.
-   This format cannot be used during a merge, nor when the
-   index and the latest commit does not match on the
-   specified paths to avoid confusion.
+   Commit only the files specified on the command line;
+   this is the default when pathnames are given on the
+   command line, so you usually do not have to give this
+   option.  This format cannot be used during a merge.

Is there some value in keeping this option documented?  What about 
removing it (the documentation not the option)?

True, although the description of <files>... need to be
clarified if we do this.

I'm a bit uncomfortable about removing documentation to existing
(if no-op) option. I'd rather it stay.
-- 
Jakub Narebski
Warsaw, Poland
ShadeHawk on #git