Subject: Re: [PATCH 2/3] git-log.txt,rev-list-options.txt: -n/--max-count is commit limiting

From: Michael J Gruber <[email-masked]>
Date: Wed, 09 Mar 2011 08:11:26 +0100

Junio C Hamano venit, vidit, dixit 08.03.2011 20:59:
> Michael J Gruber <[email-masked]> writes:
> 
>> diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt
>> index ff41784..48c1715 100644
>> --- a/Documentation/git-log.txt
>> +++ b/Documentation/git-log.txt
>> @@ -25,6 +25,7 @@ OPTIONS
>>  
>>  -<n>::
>>  	Limits the number of commits to show.
>> +	Note that this is a commit limiting option, see below.
> 
> I wonder if we should be dropping this instead, as it appears later in the
> document anyway.

It is an intended redundancy but can be dropped, of course. I just
thought that people confused by "-<n>" would not be looking further down
for yet another description of the same option unless they are pointed
to it (or the right section) explicitly.

Michael