From: "Shawn O. Pearce" <spearce@spearce.org>
To: Junio C Hamano <junkio@cox.net>
Cc: git@vger.kernel.org
Subject: [PATCH 2/2] Refer users to git-rev-parse for revision specification syntax.
Date: Wed, 17 Jan 2007 21:08:09 -0500 [thread overview]
Message-ID: <20070118020809.GB23488@spearce.org> (raw)
In-Reply-To: <834ec15f66b9f03b36643cac1c924dcf9bf92f41.1169086075.git.spearce@spearce.org>
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>
---
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(-)
diff --git a/Documentation/git-cherry-pick.txt b/Documentation/git-cherry-pick.txt
index 875edb6..3149d08 100644
--- a/Documentation/git-cherry-pick.txt
+++ b/Documentation/git-cherry-pick.txt
@@ -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
diff --git a/Documentation/git-diff.txt b/Documentation/git-diff.txt
index 8977877..6a098df 100644
--- 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>.
+For a more complete list of ways to spell <commit>, see
+"SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
+
OPTIONS
-------
diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
index 23acb47..574cf76 100644
--- 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
-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].
diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt
index 60610f9..b802946 100644
--- 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.
+ 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.
diff --git a/Documentation/git-revert.txt b/Documentation/git-revert.txt
index 71f7815..8081bba 100644
--- a/Documentation/git-revert.txt
+++ b/Documentation/git-revert.txt
@@ -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
diff --git a/Documentation/git-show.txt b/Documentation/git-show.txt
index c210b9a..9051951 100644
--- a/Documentation/git-show.txt
+++ b/Documentation/git-show.txt
@@ -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[]
diff --git a/Documentation/gitk.txt b/Documentation/gitk.txt
index f1aeb07..6e2a878 100644
--- 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.
+ For a more complete list of ways to spell object names, see
+ "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1].
<path>::
--
1.5.0.rc1.g556b
parent reply other threads:[~2007-01-18 2:08 UTC|newest]
Thread overview: expand[flat|nested] mbox.gz Atom feed
[parent not found: <834ec15f66b9f03b36643cac1c924dcf9bf92f41.1169086075.git.spearce@spearce.org>]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20070118020809.GB23488@spearce.org \
--to=spearce@spearce.org \
--cc=git@vger.kernel.org \
--cc=junkio@cox.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).