From: Junio C Hamano <gitster@pobox.com>
Date: Tue, 08 Mar 2011 19:59:22 GMT
Subject: Re: [PATCH 2/3] git-log.txt,rev-list-options.txt: -n/--max-count is commit limiting
Message-ID: <7vaah5e63p.fsf@alter.siamese.dyndns.org>
In-Reply-To: <4c0ad5a9af1d18e59a7e820349a531f220cbf776.1299572814.git.git@drmicha.warpmail.net>

Michael J Gruber <git@drmicha.warpmail.net> 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.

> diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt
> index 76add13..adcafa0 100644
> --- a/Documentation/rev-list-options.txt
> +++ b/Documentation/rev-list-options.txt
> @@ -158,7 +158,8 @@ Commit Limiting
>  
>  Besides specifying a range of commits that should be listed using the
>  special notations explained in the description, additional commit
> -limiting may be applied.
> +limiting may be applied. Note that they are applied before commit
> +ordering and formatting options, such as '--reverse'.

This part is probably a good addition.