Refer users to git-rev-parse for revision specification syntax.
The revision specification syntax (sometimes referred to as SHA1-expressions) is accepted almost everywhere in Git by almost every tool. Unfortunately it is only documented in git-rev-parse.txt, and most users don't know to look there. Signed-off-by: Shawn O. Pearce <spearce@spearce.org> Signed-off-by: Junio C Hamano <junkio@cox.net>
Shawn O. Pearce committed
Jan 17, 2007 at 21:08 UTC
41a5564e054043945e365c580abab724e12744ff
7 files changed
+17
-1
Documentation/git-cherry-pick.txt
+2
@@ -19,6 +19,8 @@ OPTIONS
19
-------
20
<commit>::
21
Commit to cherry-pick.
22
+ For a more complete list of ways to spell commits, see
23
+ "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
24
25
-e|--edit::
26
With this option, `git-cherry-pick` will let you edit the commit
Documentation/git-diff.txt
+3
@@ -47,6 +47,9 @@ Just in case if you are doing something exotic, it should be
47
noted that all of the <commit> in the above description can be
48
any <tree-ish>.
49
50
+For a more complete list of ways to spell <commit>, see
51
+"SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
52
+
53
54
OPTIONS
55
-------
Documentation/git-format-patch.txt
+3
-1
@@ -20,7 +20,9 @@ DESCRIPTION
20
Prepare each commit between <since> and <until> with its patch in
21
one file per commit, formatted to resemble UNIX mailbox format.
22
If ..<until> is not specified, the head of the current working
23
-tree is implied.
23
+tree is implied. For a more complete list of ways to spell
24
+<since> and <until>, see "SPECIFYING REVISIONS" section in
25
+gitlink:git-rev-parse[1].
26
27
The output of this command is convenient for e-mail submission or
28
for use with gitlink:git-am[1].
Documentation/git-log.txt
+3
@@ -34,6 +34,9 @@ include::pretty-formats.txt[]
34
Show only commits between the named two commits. When
35
either <since> or <until> is omitted, it defaults to
36
`HEAD`, i.e. the tip of the current branch.
37
+ For a more complete list of ways to spell <since>
38
+ and <until>, see "SPECIFYING REVISIONS" section in
39
+ gitlink:git-rev-parse[1].
40
41
-p::
42
Show the change the commit introduces in a patch form.
Documentation/git-revert.txt
+2
@@ -19,6 +19,8 @@ OPTIONS
19
-------
20
<commit>::
21
Commit to revert.
22
+ For a more complete list of ways to spell commit names, see
23
+ "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
24
25
-e|--edit::
26
With this option, `git-revert` will let you edit the commit
Documentation/git-show.txt
+2
@@ -32,6 +32,8 @@ OPTIONS
32
-------
33
<object>::
34
The name of the object to show.
35
+ For a more complete list of ways to spell object names, see
36
+ "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
37
38
include::pretty-formats.txt[]
39
Documentation/gitk.txt
+2
@@ -47,6 +47,8 @@ frequently used options.
47
meaning show from the given revision and back, or it can be a range in
48
the form "'<from>'..'<to>'" to show all revisions between '<from>' and
49
back to '<to>'. Note, more advanced revision selection can be applied.
50
+ For a more complete list of ways to spell object names, see
51
+ "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
52
53
<path>::
54