summaryrefslogtreecommitdiffstats
path: root/git-rev-parse.txt
diff options
context:
space:
mode:
authorJunio C Hamano <junio@hera.kernel.org>2006-10-19 05:58:48 +0000
committerJunio C Hamano <junio@hera.kernel.org>2006-10-19 05:58:48 +0000
commitfbe0052a6097e716bc4ad9676c3c4d6f472a1d8d (patch)
treea926e3dc0d853abf06ca1e0de4ae19340c8a5c72 /git-rev-parse.txt
parent21c0b42d4578867273ad6bc14fb225d61aa6f67e (diff)
downloadgit-htmldocs-fbe0052a6097e716bc4ad9676c3c4d6f472a1d8d.tar.gz
Autogenerated HTML docs for v1.4.3-g72bb
Diffstat (limited to 'git-rev-parse.txt')
-rw-r--r--git-rev-parse.txt16
1 files changed, 15 insertions, 1 deletions
diff --git a/git-rev-parse.txt b/git-rev-parse.txt
index 2f1306c1d..5d4257062 100644
--- a/git-rev-parse.txt
+++ b/git-rev-parse.txt
@@ -111,7 +111,9 @@ SPECIFYING REVISIONS
A revision parameter typically, but not necessarily, names a
commit object. They use what is called an 'extended SHA1'
-syntax.
+syntax. Here are various ways to spell object names. The
+ones listed near the end of this list are to name trees and
+blobs contained in a commit.
* The full SHA1 object name (40-byte hexadecimal string), or
a substring of such that is unique within the repository.
@@ -119,6 +121,9 @@ syntax.
name the same commit object if there are no other object in
your repository whose object name starts with dae86e.
+* An output from `git-describe`; i.e. a closest tag, followed by a
+ dash, a 'g', and an abbreviated object name.
+
* A symbolic ref name. E.g. 'master' typically means the commit
object referenced by $GIT_DIR/refs/heads/master. If you
happen to have both heads/master and tags/master, you can
@@ -156,6 +161,15 @@ syntax.
and dereference the tag recursively until a non-tag object is
found.
+* A suffix ':' followed by a path; this names the blob or tree
+ at the given path in the tree-ish object named by the part
+ before the colon.
+
+* A colon, optionally followed by a stage number (0 to 3) and a
+ colon, followed by a path; this names a blob object in the
+ index at the given path. Missing stage number (and the colon
+ that follows it) names an stage 0 entry.
+
Here is an illustration, by Jon Loeliger. Both node B and C are
a commit parents of commit node A. Parent commits are ordered
left-to-right.