Skip to contentSkip to conversation

Refer users to git-rev-parse for revision specification syntax.

PATCH In review Shawn O. Pearce 1 participant 1 message Jun 15, 2016 1 message not in the archive Documentation

lore
Share & tools
lore

A message that is not in the archive (sent off-list or not yet received): 834ec15f66b9f03b36643cac1c924dcf9bf92f41.1169086075.git.spearce@spearce.org

#1 lore raw

PATCH 2/2 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.

---
 Documentation/git-cherry-pick.txt  |    2 ++
 Documentation/git-diff.txt         |    3 +++
 Documentation/git-format-patch.txt |    4 +++-
 Documentation/git-log.txt          |    3 +++
 Documentation/git-revert.txt       |    2 ++
 Documentation/git-show.txt         |    2 ++
 Documentation/gitk.txt             |    2 ++
 7 files changed, 17 insertions(+), 1 deletions(-)
Documentation/git-cherry-pick.txt +2 -0
index 875edb6..3149d08 100644
@@ -19,6 +19,8 @@ OPTIONS
 -------
 <commit>::
 	Commit to cherry-pick.
+	For a more complete list of ways to spell commits, see
+	"SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
 
 -e|--edit::
 	With this option, `git-cherry-pick` will let you edit the commit
Documentation/git-diff.txt +3 -0
index 8977877..6a098df 100644
@@ -47,6 +47,9 @@ Just in case if you are doing something exotic, it should be
 noted that all of the <commit> in the above description can be
 any <tree-ish>.
 
+For a more complete list of ways to spell <commit>, see
+"SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
+
 
 OPTIONS
 -------
Documentation/git-format-patch.txt +3 -1
index 23acb47..574cf76 100644
@@ -20,7 +20,9 @@ DESCRIPTION
 Prepare each commit between <since> and <until> with its patch in
 one file per commit, formatted to resemble UNIX mailbox format.
 If ..<until> is not specified, the head of the current working
-tree is implied.
+tree is implied.  For a more complete list of ways to spell
+<since> and <until>, see "SPECIFYING REVISIONS" section in
+gitlink:git-rev-parse[1].
 
 The output of this command is convenient for e-mail submission or
 for use with gitlink:git-am[1].
Documentation/git-log.txt +3 -0
index 60610f9..b802946 100644
@@ -34,6 +34,9 @@ include::pretty-formats.txt[]
 	Show only commits between the named two commits.  When
 	either <since> or <until> is omitted, it defaults to
 	`HEAD`, i.e. the tip of the current branch.
+	For a more complete list of ways to spell <since>
+	and <until>, see "SPECIFYING REVISIONS" section in
+	gitlink:git-rev-parse[1].
 
 -p::
 	Show the change the commit introduces in a patch form.
Documentation/git-revert.txt +2 -0
index 71f7815..8081bba 100644
@@ -19,6 +19,8 @@ OPTIONS
 -------
 <commit>::
 	Commit to revert.
+	For a more complete list of ways to spell commit names, see
+	"SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
 
 -e|--edit::
 	With this option, `git-revert` will let you edit the commit
Documentation/git-show.txt +2 -0
index c210b9a..9051951 100644
@@ -32,6 +32,8 @@ OPTIONS
 -------
 <object>::
 	The name of the object to show.
+	For a more complete list of ways to spell object names, see
+	"SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
 
 include::pretty-formats.txt[]
 
Documentation/gitk.txt +2 -0
index f1aeb07..6e2a878 100644
@@ -47,6 +47,8 @@ frequently used options.
 	meaning show from the given revision and back, or it can be a range in
 	the form "'<from>'..'<to>'" to show all revisions between '<from>' and
 	back to '<to>'. Note, more advanced revision selection can be applied.
+	For a more complete list of ways to spell object names, see
+	"SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
 
 <path>::
 
Signature · 1 line
1.5.0.rc1.g556b