1 git-rev-parse(1)
2 ================
4 NAME
5 ----
6 git-rev-parse - Pick out and massage parameters.
9 SYNOPSIS
10 --------
11 'git-rev-parse' [ --option ] <args>...
13 DESCRIPTION
14 -----------
16 Many git Porcelainish commands take mixture of flags
17 (i.e. parameters that begin with a dash '-') and parameters
18 meant for underlying `git-rev-list` command they use internally
19 and flags and parameters for other commands they use as the
20 downstream of `git-rev-list`. This command is used to
21 distinguish between them.
24 OPTIONS
25 -------
26 --revs-only::
27 Do not output flags and parameters not meant for
28 `git-rev-list` command.
30 --no-revs::
31 Do not output flags and parameters meant for
32 `git-rev-list` command.
34 --flags::
35 Do not output non-flag parameters.
37 --no-flags::
38 Do not output flag parameters.
40 --default <arg>::
41 If there is no parameter given by the user, use `<arg>`
42 instead.
44 --verify::
45 The parameter given must be usable as a single, valid
46 object name. Otherwise barf and abort.
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-\*`).
56 --not::
57 When showing object names, prefix them with '^' and
58 strip '^' prefix from the object names that already have
59 one.
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.
67 --all::
68 Show all refs found in `$GIT_DIR/refs`.
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.
75 <args>...::
76 Flags and parameters to be parsed.
79 Author
80 ------
81 Written by Linus Torvalds <torvalds@osdl.org> and
82 Junio C Hamano <junkio@cox.net>
84 Documentation
85 --------------
86 Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
88 GIT
89 ---
90 Part of the link:git.html[git] suite