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>

diff --git a/Documentation/git-cherry-pick.txt b/Documentation/git-cherry-pick.txt
index 875edb6b9f5ddc6d19b2de29cebbad5ebb7d37a0..3149d08da83f5cd7b92f13da47298791ce9a3737 100644 (file)
--- a/Documentation/git-cherry-pick.txt
+++ b/Documentation/git-cherry-pick.txt
@@ -19,6 +19,8 @@ OPTIONS
 -------
 <commit>::
        Commit to cherry-pick.
 -------
 <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
 
 -e|--edit::
        With this option, `git-cherry-pick` will let you edit the commit

diff --git a/Documentation/git-diff.txt b/Documentation/git-diff.txt
index 8977877b21b6681528d13f71b558c060e8c26c4d..6a098df26b1c1639f6ac88233b5642a2be9039fa 100644 (file)
--- a/Documentation/git-diff.txt
+++ b/Documentation/git-diff.txt
@@ -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>.
 
 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
 -------
 
 OPTIONS
 -------

diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
index 23acb47528fc2e3beafe4d85a26152cb718b3e72..574cf76dca2194e9d13d5db384d39409a9095740 100644 (file)
--- a/Documentation/git-format-patch.txt
+++ b/Documentation/git-format-patch.txt
@@ -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
 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].
 
 The output of this command is convenient for e-mail submission or
 for use with gitlink:git-am[1].

diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt
index 60610f91f4c38946b35209bd3e9a1c696fd1b17d..b8029463d9e9b356d3b263f50b3eab2012956ee6 100644 (file)
--- a/Documentation/git-log.txt
+++ b/Documentation/git-log.txt
@@ -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.
        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.
 
 -p::
        Show the change the commit introduces in a patch form.

diff --git a/Documentation/git-revert.txt b/Documentation/git-revert.txt
index 71f7815d65a38db70a5176a50989300b39684cda..8081bbaffa8d3710b644c744b9f81d459938a20e 100644 (file)
--- a/Documentation/git-revert.txt
+++ b/Documentation/git-revert.txt
@@ -19,6 +19,8 @@ OPTIONS
 -------
 <commit>::
        Commit to revert.
 -------
 <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
 
 -e|--edit::
        With this option, `git-revert` will let you edit the commit

diff --git a/Documentation/git-show.txt b/Documentation/git-show.txt
index c210b9af6bb4ce09d061e24715b07cd64887d54c..9051951c34c41cf339df1f54319addf62318f5d6 100644 (file)
--- a/Documentation/git-show.txt
+++ b/Documentation/git-show.txt
@@ -32,6 +32,8 @@ OPTIONS
 -------
 <object>::
        The name of the object to show.
 -------
 <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[]
 
 
 include::pretty-formats.txt[]
 

diff --git a/Documentation/gitk.txt b/Documentation/gitk.txt
index f1aeb07f64e09735871f0a956b9ba412578a2a23..6e2a8782cd41e1571dd3c77b5756ff73b48dfcd5 100644 (file)
--- a/Documentation/gitk.txt
+++ b/Documentation/gitk.txt
@@ -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.
        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>::
 
 
 <path>::