Re: [PATCH] In Examples, explain option -r and refer to git-rev-list[1]

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 27, 2007, 08:14 UTC
Message-ID: <7vy7fxl7hx.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <46D28502.3030003@etek.chalmers.se>

Lukas Sandström <lukass@etek.chalmers.se> writes:

Show 17 quoted lines

> Jari Aalto wrote:
>> Signed-off-by: Jari Aalto <jari.aalto@cante.net>
>> ---
>>  Documentation/git-log.txt |    3 ++-
>>  1 files changed, 2 insertions(+), 1 deletions(-)
>> 
>> diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt
>> index 49bb539..aa42f0e 100644
>> --- a/Documentation/git-log.txt
>> +++ b/Documentation/git-log.txt
>> @@ -76,7 +76,8 @@ git log -r --name-status release..test::
>>  
>>  	Show the commits that are in the "test" branch but not yet
>>  	in the "release" branch, along with the list of paths
>> -	each commit modifies.
>> +	each commit modifies. Opton -r (see gitlink:git-rev-list[1])
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ spelling mistake (option)

I think it makes more sense to make Porcelain including "git log" to always recurse in its diff operations (when diff output is asked for), in which case the example should simply lose the "-r" option.

But that is a post-1.5.3 change. That's why I am planning to drop this patch for now.