Andreas Ericsson [off-list ref] writes:
Junio C Hamano wrote:
quoted
quoted
usage: git clone ...
For more details, see 'man git-clone'
And "for more details see man" goes without saying.
But we name them differently, as hpa pointed out some week ago.
When I see "usage: <prog> <command>" I expect to find the info in "man
<prog>".
... meaning, "man git", which would list the subcommands.
And a user who got "usage: git clone blah" and did "man git"
once is intelligent enough to know and remember "man git" lists
the subcommands, what she wanted to know about was listed as
"git-clone(1)", and she had to do "man git-clone", so next time
around we should be able to expect her to do "man git-commit".
Am I overestimating the users or overtaxing them?