fetch() assumes we do not have the object.
[git/git.git] / Documentation / git-rev-parse.txt
CommitLineData
7fc9d69f
JH
1git-rev-parse(1)
2================
3
4NAME
5----
5077fa9c 6git-rev-parse - Pick out and massage parameters.
7fc9d69f
JH
7
8
9SYNOPSIS
10--------
11'git-rev-parse' [ --option ] <args>...
12
13DESCRIPTION
14-----------
5077fa9c
JH
15
16Many git Porcelainish commands take mixture of flags
17(i.e. parameters that begin with a dash '-') and parameters
18meant for underlying `git-rev-list` command they use internally
19and flags and parameters for other commands they use as the
20downstream of `git-rev-list`. This command is used to
21distinguish between them.
7fc9d69f
JH
22
23
24OPTIONS
25-------
5077fa9c
JH
26--revs-only::
27 Do not output flags and parameters not meant for
28 `git-rev-list` command.
29
30--no-revs::
31 Do not output flags and parameters meant for
32 `git-rev-list` command.
33
34--flags::
35 Do not output non-flag parameters.
36
37--no-flags::
38 Do not output flag parameters.
39
40--default <arg>::
41 If there is no parameter given by the user, use `<arg>`
42 instead.
43
44--verify::
45 The parameter given must be usable as a single, valid
46 object name. Otherwise barf and abort.
47
48--sq::
49 Usually the output is made one line per flag and
50 parameter. This option makes output a single line,
51 properly quoted for consumption by shell. Useful when
52 you expect your parameter to contain whitespaces and
53 newlines (e.g. when using pickaxe `-S` with
54 `git-diff-\*`).
55
56--not::
57 When showing object names, prefix them with '^' and
58 strip '^' prefix from the object names that already have
59 one.
60
61--symbolic::
62 Usually the object names are output in SHA1 form (with
63 possible '^' prefix); this option makes them output in a
64 form as close to the original input as possible.
65
66
67--all::
68 Show all refs found in `$GIT_DIR/refs`.
69
70--show-prefix::
71 When the command is invoked from a directory show the
72 path of the current directory relative to the top-level
73 directory.
7fc9d69f
JH
74
75<args>...::
5077fa9c 76 Flags and parameters to be parsed.
7fc9d69f
JH
77
78
79Author
80------
5077fa9c
JH
81Written by Linus Torvalds <torvalds@osdl.org> and
82Junio C Hamano <junkio@cox.net>
7fc9d69f
JH
83
84Documentation
85--------------
86Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
87
88GIT
89---
90Part of the link:git.html[git] suite
91