Package: git
Version: 1:1.7.10.4-1+wheezy1
<rev>^, e.g. HEAD^, v1.5.1^0
A suffix ^ to a revision parameter means the first parent of that
commit object. ^<n> means the <n>th parent (i.e. <rev>^ is
equivalent to <rev>^1). As a special rule, <rev>^0 means the commit
itself and is used when <rev> is the object name of a tag object
that refers to a commit object.
<rev>~<n>, e.g. master~3
A suffix ~<n> to a revision parameter means the commit object that
is the <n>th generation ancestor of the named commit object,
following only the first parents. I.e. <rev>~3 is equivalent to
<rev>^^^ which is equivalent to <rev>^1^1^1. See below for an
illustration of the usage of this form.
This gives the false impression that rev~ is not supported. But rev~
is the best syntax to remember for `parent' since rev~0 is useful and
easier to remember than rev^{}, and rev~2 is more usually want you
want in your finger macros than rev^2.
I suggest:
* swap these paragraphs
* use <rev>~ as the primary heading with <rev>~n in the body,
as for <rev>^.
If this is likely to meet with approval I will make a patch.
Ian.
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
