From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 17 Sep 2012 05:00:48 GMT
Subject: Re: [PATCH 7/8] Doc clean: add See Also links
Message-ID: <7vboh5xmyn.fsf@alter.siamese.dyndns.org>
In-Reply-To: <vpqsjaiyxth.fsf@grenoble-inp.fr>

Matthieu Moy <Matthieu.Moy@grenoble-inp.fr> writes:

> Philip Oakley <philipoakley@iee.org> writes:
>
>> --- a/Documentation/git-clean.txt
>> +++ b/Documentation/git-clean.txt
>> @@ -63,6 +63,12 @@ OPTIONS
>>  	Remove only files ignored by git.  This may be useful to rebuild
>>  	everything from scratch, but keep manually created files.
>>  
>> +SEE ALSO
>> +--------
>> +linkgit:gitignore[5]
>> +linkgit:gitrepository-layout[5]
>> +The optional configuration variable `core.excludesfile` linkgit:git-config[1]
>
> I think linkgit:gitignore[5] is enough. linkgit:gitrepository-layout[5]
> is a very general documentation, it's not clear to the reader which part
> is intended to be read in complement to git-clean, and indeed, the
> relevant information is already in linkgit:gitignore[5]. Same for
> core.excludesfile which is already documented in linkgit:gitignore[5].
>
> Otherwise, I suspect we'll end-up having the transitive closure of SEE
> ALSO in each manpage ...

Concurred.  Thanks.