Re: [PATCH] Documentation: fix git-clone manpage not to refer to itself

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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


-
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux