From: Josef Weidendorfer <josef.weidendorfer@gmx.de>
Date: Mon, 14 Nov 2005 09:29:18 GMT
Subject: Re: [PATCH] Bugfix: stop if directory already exists
Message-ID: <200511141029.18256.Josef.Weidendorfer@gmx.de>
In-Reply-To: <7vpsp3zjwm.fsf@assigned-by-dhcp.cox.net>

On Monday 14 November 2005 09:57, Junio C Hamano wrote:
> Josef Weidendorfer <Josef.Weidendorfer@gmx.de> writes:
> >  usage: git clone ...
> >  For more details, see 'man git-clone'
> 
> doing too much awk these days").  And "for more details see man"
> goes without saying.

Of course; it was more about the current inconsistency: usage
says "git clone", but for the man page, you have to know that
there is an additional command "git-clone" with extra man page.
Usually, if I see e.g. "usage: cvs diff", I look up the man
page of "cvs" searching for "diff" on it, not "cvs-diff".

So just another suggestion: Why not put most of the
documentation in a huge "git" man page? cvs does this (3601 lines
here), all the shells have huge man pages (bash: 4794).
We would be in a good tradition ;-)

Josef