Re: [PATCH v6 06/12] doc: revisions: single vs multi-parent notation comparison

From: Jakub Narębski <jnareb@gmail.com>
Date: Aug 26, 2016, 15:30 UTC
Message-ID: <6b37851f-0f2f-0379-c10e-52f7da6b7110@gmail.com>
In-Reply-To: <20160812234522.7792-3-philipoakley@iee.org>

W dniu 13.08.2016 o 01:45, Philip Oakley pisze:

Show 10 quoted lines

> --- a/Documentation/revisions.txt
> +++ b/Documentation/revisions.txt
> @@ -284,6 +284,10 @@ The 'r1{caret}@' notation means all parents of 'r1'.
>  The 'r1{caret}!' notation includes commit 'r1' but excludes all of its parents.
>  By itself, this notation denotes the single commit 'r1'.
>  
> +While '<rev>{caret}<n>' was about specifying a single commit parent, these
> +two notations consider all its parents. For example you can say
> +'HEAD{caret}2{caret}@', however you cannot say 'HEAD{caret}@{caret}2'.
> +

That's good to have.

Though I do wonder if it is implementation limitation, or if it is something inherent in the notation, namely that <rev>^@ and <rev>^! resolve (the former at least in general, though not for every <rev>) to more than one revision specifier.

Anyway, good addition!

-- 
Jakub Narębski