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:
Jonas Fonseca 2005-10-05 16:56:31 -07:00 committed by Junio C Hamano
parent 4cfc63db1d
commit babfaba23d
2 changed files with 17 additions and 11 deletions

View file

@ -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[]

View file

@ -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