Re: [PATCH] add: Clarify documentation of -A and -u

2013-03-07 Thread Junio C Hamano
eady has an entry matching > . Good; this was the short phrasing I was looking for but couldn't come up with myself without repeating "the index" over and over. > Then follow both with the "If no " paragraph. I just > noticed that the paragraph actually need

Re: [PATCH] add: Clarify documentation of -A and -u

2013-03-07 Thread Greg Price
modifies, and removes index entries to match the working tree. These are the shortest in the discussion so far, and I think they're also the clearest. Then follow both with the "If no " paragraph. I just noticed that the paragraph actually needs a small modification to f

Re: [PATCH] add: Clarify documentation of -A and -u

2013-03-06 Thread Junio C Hamano
Greg Price writes: > diff --git a/Documentation/git-add.txt b/Documentation/git-add.txt > index 388a225..f89d920 100644 > --- a/Documentation/git-add.txt > +++ b/Documentation/git-add.txt > @@ -105,7 +105,9 @@ apply to the index. See EDITING PATCHES below. > will never stage new files, but

[PATCH] add: Clarify documentation of -A and -u

2013-03-05 Thread Greg Price
The documentation of '-A' is very confusing for someone who doesn't already know what it does. In particular, it describes the option's meaning by reference to that of '-u', but it's no more similar to the latter than it is to the default behavior. Describe it directly (and in a way that uses the