You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
127 lines
3.6 KiB
127 lines
3.6 KiB
git-rev-parse(1) |
|
================ |
|
|
|
NAME |
|
---- |
|
git-rev-parse - Pick out and massage parameters. |
|
|
|
|
|
SYNOPSIS |
|
-------- |
|
'git-rev-parse' [ --option ] <args>... |
|
|
|
DESCRIPTION |
|
----------- |
|
|
|
Many git Porcelainish commands take mixture of flags |
|
(i.e. parameters that begin with a dash '-') and parameters |
|
meant for underlying `git-rev-list` command they use internally |
|
and flags and parameters for other commands they use as the |
|
downstream of `git-rev-list`. This command is used to |
|
distinguish between them. |
|
|
|
|
|
OPTIONS |
|
------- |
|
--revs-only:: |
|
Do not output flags and parameters not meant for |
|
`git-rev-list` command. |
|
|
|
--no-revs:: |
|
Do not output flags and parameters meant for |
|
`git-rev-list` command. |
|
|
|
--flags:: |
|
Do not output non-flag parameters. |
|
|
|
--no-flags:: |
|
Do not output flag parameters. |
|
|
|
--default <arg>:: |
|
If there is no parameter given by the user, use `<arg>` |
|
instead. |
|
|
|
--verify:: |
|
The parameter given must be usable as a single, valid |
|
object name. Otherwise barf and abort. |
|
|
|
--sq:: |
|
Usually the output is made one line per flag and |
|
parameter. This option makes output a single line, |
|
properly quoted for consumption by shell. Useful when |
|
you expect your parameter to contain whitespaces and |
|
newlines (e.g. when using pickaxe `-S` with |
|
`git-diff-\*`). |
|
|
|
--not:: |
|
When showing object names, prefix them with '{caret}' and |
|
strip '{caret}' prefix from the object names that already have |
|
one. |
|
|
|
--symbolic:: |
|
Usually the object names are output in SHA1 form (with |
|
possible '{caret}' prefix); this option makes them output in a |
|
form as close to the original input as possible. |
|
|
|
|
|
--all:: |
|
Show all refs found in `$GIT_DIR/refs`. |
|
|
|
--show-prefix:: |
|
When the command is invoked from a directory show the |
|
path of the current directory relative to the top-level |
|
directory. |
|
|
|
<args>...:: |
|
Flags and parameters to be parsed. |
|
|
|
|
|
SPECIFYING REVISIONS |
|
-------------------- |
|
|
|
A revision parameter typically names a commit object. They use |
|
what is called an 'extended SHA1' syntax. |
|
|
|
* The full SHA1 object name (40-byte hexadecimal string), or |
|
a substring of such that is unique within the repository. |
|
E.g. dae86e1950b1277e545cee180551750029cfe735 and dae86e both |
|
name the same commit object if there are no other object in |
|
your repository whose object name starts with dae86e. |
|
|
|
* A symbolic ref name. E.g. 'master' typically means the commit |
|
object referenced by $GIT_DIR/refs/heads/master. If you |
|
happen to have both heads/master and tags/master, you can |
|
explicitly say 'heads/master' to tell GIT which one you mean. |
|
|
|
* A suffix '{caret}' to a revision parameter means the first parent of |
|
that commit object. '{caret}<n>' means the <n>th parent (i.e. |
|
'rev{caret}' |
|
is equivalent to 'rev{caret}1'). As a special rule, |
|
'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. |
|
|
|
* A suffix '~<n>' to a revision parameter means the commit |
|
object that is the <n>th generation grand-parent of the named |
|
commit object, following only the first parent. I.e. rev~3 is |
|
equivalent to rev{caret}{caret}{caret} which is equivalent to\ |
|
rev{caret}1{caret}1{caret}1. |
|
|
|
'git-rev-parse' also accepts a prefix '{caret}' to revision parameter, |
|
which is passed to 'git-rev-list'. Two revision parameters |
|
concatenated with '..' is a short-hand for writing a range |
|
between them. I.e. 'r1..r2' is equivalent to saying '{caret}r1 r2' |
|
|
|
|
|
Author |
|
------ |
|
Written by Linus Torvalds <torvalds@osdl.org> and |
|
Junio C Hamano <junkio@cox.net> |
|
|
|
Documentation |
|
-------------- |
|
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>. |
|
|
|
GIT |
|
--- |
|
Part of the gitlink:git[7] suite |
|
|
|
|