On Sat, Nov 10, 2012 at 10:55:13AM +0100, Angelo Borsotti wrote:
> the man page of git-reset, synopsys, does not allow for an
> argumentless call, and the description does not tell either what is
> the meaning of it.
This issue was already reported by Bojan Petrović:
and fixed in commit d505865be5c7d72abb74318940e8c4c52aa0db5f
(doc: git-reset: make "<mode>" optional) in master branch.
"git reset" is equivalent to "git reset --mixed".
> Suggested changes:
> first line of synopsis:
> gitt reset [-q] [<commit>] [ [--] <pathspec> ...]
> Description: append to the end of the first paragraph:
> "If no <pathspecs> are specified, all the index entries are reset."
> I would suggest to change <paths> with <pathspec> in all the man page
> because paths in the glossary are called pathspecs.
The <paths> issue seems to be bigger - "<path>", "<paths>" and "<pathspec>"
are mixed in whole manual:
$ cat Documentation/*.txt | grep -o '<path[^>]*>' | sort | uniq -c |
sort -n -r
In commands it's even worse:
$ cat builtin/*.c | grep -o '<path[^>]*>' | sort | uniq -c | sort -n -r
Note: <path> is not always used for pathspec.
In git-checkout manual in synopsis "<paths>" is used, but in description
Maybe we should just add that <paths> is an shortcut for <pathspec>
and fix places where paths and pathspec are mixed or <path> is used as
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html