From: Jakub Narebski <jnareb@gmail.com>
Date: Mon, 19 Nov 2007 14:03:00 GMT
Subject: Re: [PATCH] Documentation: fix git-clone manpage not to refer to itself
Message-ID: <fhs52j$npp$1@ger.gmane.org>
In-Reply-To: <Pine.LNX.4.64.0711191430460.16728@wbgn129.biozentrum.uni-wuerzburg.de>

Johannes Schindelin wrote:

> On Fri, 16 Nov 2007, Sergei Organov wrote:
> 
>> +ifndef::git-clone[]
> 
> It is laudable that you want to fix the _generated_ documentation, but 
> there are two things to keep in mind:
> 
> - it does _nothing_ to help readers of the sources, and asciidoc was 
>   chosen purposely because the source is human-readable, and

IMHO it doesn't make source of documentation less readable.

It has the advantage of not duplicating contents, and being a bit mre
readable than writing "for <cmd>" in documentation contents.

-- 
Jakub Narebski
Warsaw, Poland
ShadeHawk on #git