mirror of
https://github.com/git/git
synced 2024-11-05 18:59:29 +00:00
Fix usage of carets in git-rev-parse(1)
... but using a {caret} attribute. Signed-off-by: Jonas Fonseca <fonseca@diku.dk> Signed-off-by: Junio C Hamano <junkio@cox.net>
This commit is contained in:
parent
4cfc63db1d
commit
babfaba23d
2 changed files with 17 additions and 11 deletions
|
@ -7,6 +7,9 @@
|
||||||
# Show GIT link as: <command>(<section>); if section is defined, else just show
|
# Show GIT link as: <command>(<section>); if section is defined, else just show
|
||||||
# the command.
|
# the command.
|
||||||
|
|
||||||
|
[attributes]
|
||||||
|
caret=^
|
||||||
|
|
||||||
ifdef::backend-docbook[]
|
ifdef::backend-docbook[]
|
||||||
[gitlink-inlinemacro]
|
[gitlink-inlinemacro]
|
||||||
{0%{target}}
|
{0%{target}}
|
||||||
|
@ -19,3 +22,5 @@ ifdef::backend-xhtml11[]
|
||||||
[gitlink-inlinemacro]
|
[gitlink-inlinemacro]
|
||||||
<a href="{target}.html">{target}{0?({0})}</a>
|
<a href="{target}.html">{target}{0?({0})}</a>
|
||||||
endif::backend-xhtml11[]
|
endif::backend-xhtml11[]
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -54,13 +54,13 @@ OPTIONS
|
||||||
`git-diff-\*`).
|
`git-diff-\*`).
|
||||||
|
|
||||||
--not::
|
--not::
|
||||||
When showing object names, prefix them with '^' and
|
When showing object names, prefix them with '{caret}' and
|
||||||
strip '^' prefix from the object names that already have
|
strip '{caret}' prefix from the object names that already have
|
||||||
one.
|
one.
|
||||||
|
|
||||||
--symbolic::
|
--symbolic::
|
||||||
Usually the object names are output in SHA1 form (with
|
Usually the object names are output in SHA1 form (with
|
||||||
possible '^' prefix); this option makes them output in a
|
possible '{caret}' prefix); this option makes them output in a
|
||||||
form as close to the original input as possible.
|
form as close to the original input as possible.
|
||||||
|
|
||||||
|
|
||||||
|
@ -93,22 +93,23 @@ what is called an 'extended SHA1' syntax.
|
||||||
happen to have both heads/master and tags/master, you can
|
happen to have both heads/master and tags/master, you can
|
||||||
explicitly say 'heads/master' to tell GIT which one you mean.
|
explicitly say 'heads/master' to tell GIT which one you mean.
|
||||||
|
|
||||||
* A suffix '^' to a revision parameter means the first parent of
|
* A suffix '{caret}' to a revision parameter means the first parent of
|
||||||
that commit object. '^<n>' means the <n>th parent (i.e.
|
that commit object. '{caret}<n>' means the <n>th parent (i.e.
|
||||||
'rev^'
|
'rev{caret}'
|
||||||
is equivalent to 'rev^1'). As a special rule,
|
is equivalent to 'rev{caret}1'). As a special rule,
|
||||||
'rev^0' means the commit itself and is used when 'rev' is the
|
'rev{caret}0' means the commit itself and is used when 'rev' is the
|
||||||
object name of a tag object that refers to a commit object.
|
object name of a tag object that refers to a commit object.
|
||||||
|
|
||||||
* A suffix '~<n>' to a revision parameter means the commit
|
* A suffix '~<n>' to a revision parameter means the commit
|
||||||
object that is the <n>th generation grand-parent of the named
|
object that is the <n>th generation grand-parent of the named
|
||||||
commit object, following only the first parent. I.e. rev~3 is
|
commit object, following only the first parent. I.e. rev~3 is
|
||||||
equivalent to rev^^^ which is equivalent to rev^1^1^1.
|
equivalent to rev{caret}{caret}{caret} which is equivalent to\
|
||||||
|
rev{caret}1{caret}1{caret}1.
|
||||||
|
|
||||||
'git-rev-parse' also accepts a prefix '^' to revision parameter,
|
'git-rev-parse' also accepts a prefix '{caret}' to revision parameter,
|
||||||
which is passed to 'git-rev-list'. Two revision parameters
|
which is passed to 'git-rev-list'. Two revision parameters
|
||||||
concatenated with '..' is a short-hand for writing a range
|
concatenated with '..' is a short-hand for writing a range
|
||||||
between them. I.e. 'r1..r2' is equivalent to saying '^r1 r2'
|
between them. I.e. 'r1..r2' is equivalent to saying '{caret}r1 r2'
|
||||||
|
|
||||||
|
|
||||||
Author
|
Author
|
||||||
|
|
Loading…
Reference in a new issue