From: Junio C Hamano <junkio@cox.net>
Date: Mon, 14 Nov 2005 21:30:19 GMT
Subject: Re: [PATCH] Bugfix: stop if directory already exists
Message-ID: <7vlkzqx6hg.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <437858A1.9010007@op5.se>

Andreas Ericsson <ae@op5.se> writes:

> Junio C Hamano wrote:
>>
>>> 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?