Jeff King wrote: > If you are concerned about the latter, do you mean something like this: > > -- >8 -- > Documentation/git-add: clarify -u with path limiting > > Signed-off-by: Jeff King <peff@xxxxxxxx> > --- > diff --git a/Documentation/git-add.txt b/Documentation/git-add.txt > index ea27018..27b9c0f 100644 > --- a/Documentation/git-add.txt > +++ b/Documentation/git-add.txt > @@ -57,8 +57,11 @@ OPTIONS > the index. > > -u:: > - Update all files that git already knows about. This is what > - "git commit -a" does in preparation for making a commit. > + Update only files that git already knows about. This is similar > + to what "git commit -a" does in preparation for making a commit, > + except that the update is limited to paths specified on the > + command line. If no paths are specified, all tracked files are > + updated. > > \--:: > This option can be used to separate command-line options from > That is very nice and needed, but I actually thought about correcting SYNOPSIS to read: @@ -7,7 +7,9 @@ git-add - Add file contents to the changeset to be committed next SYNOPSIS -------- -'git-add' [-n] [-v] [-f] [--interactive | -i] [-u] [--] <file>... +'git-add' [-n] [-v] [-f] [--] <file>... +'git-add' [-n] [-v] [-f] -u [[--] <file>...] +'git-add' (--interactive | -i) DESCRIPTION ----------- This ensures that while git-add without -u needs explicit paths (even if it is '.'), git-add with -u can have explicit paths but doesn't need them. -- Jakub Narebski Poland - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html