Document git-show-ref [-s|--hash] option.
Signed-off-by: Christian Couder <chriscool@tuxfamily.org> Signed-off-by: Junio C Hamano <junkio@cox.net>
Christian Couder committed
Sep 20, 2006 at 06:14 UTC
9581e0fca225927dbcbdf03fe70a1d2711ddc6b9
1 file changed
+17
-1
Documentation/git-show-ref.txt
+17
-1
@@ -9,7 +9,7 @@ SYNOPSIS
9
--------
10
[verse]
11
'git-show-ref' [-q|--quiet] [--verify] [-h|--head] [-d|--dereference]
12
- [--tags] [--heads] [--] <pattern>...
12
+ [-s|--hash] [--tags] [--heads] [--] <pattern>...
13
14
DESCRIPTION
15
-----------
@@ -40,6 +40,12 @@ OPTIONS
40
Dereference tags into object IDs. They will be shown with "^{}"
41
appended.
42
43
+-s, --hash::
44
+
45
+ Only show the SHA1 hash, not the reference name. When also using
46
+ --dereference the dereferenced tag will still be shown after the SHA1,
47
+ this maybe a bug.
48
+
49
--verify::
50
51
Enable stricter reference checking by requiring an exact ref path.
@@ -72,6 +78,16 @@ $ git show-ref --head --dereference
78
...
79
-----------------------------------------------------------------------------
80
81
+When using --hash (and not --dereference) the output format is: '<SHA-1 ID>'
82
+
83
+-----------------------------------------------------------------------------
84
+$ git show-ref --heads --hash
85
+2e3ba0114a1f52b47df29743d6915d056be13278
86
+185008ae97960c8d551adcd9e23565194651b5d1
87
+03adf42c988195b50e1a1935ba5fcbc39b2b029b
88
+...
89
+-----------------------------------------------------------------------------
90
+
91
EXAMPLE
92
-------
93