mirrors/git
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add revspec documentation for ':path', ':[0-3]:path' and git-describe

Browse Source 
Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
Signed-off-by: Junio C Hamano <junkio@cox.net>
This commit is contained in:
pclouds@gmail.com
2006-10-19 10:04:55 +07:00
committed by Junio C Hamano
parent 8a83157e04
commit 6b09c7883f
1 changed files with 15 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
Documentation/git-rev-parse.txt
View File

@ -111,7 +111,9 @@ SPECIFYING REVISIONS
A revision parameter typically, but not necessarily, names a A revision parameter typically, but not necessarily, names a
commit object. They use what is called an 'extended SHA1' 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 * The full SHA1 object name (40-byte hexadecimal string), or
a substring of such that is unique within the repository. 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 name the same commit object if there are no other object in
your repository whose object name starts with dae86e. 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 * A symbolic ref name. E.g. 'master' typically means the commit
object referenced by $GIT_DIR/refs/heads/master. If you object referenced by $GIT_DIR/refs/heads/master. If you
happen to have both heads/master and tags/master, you can 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 and dereference the tag recursively until a non-tag object is
found. 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 Here is an illustration, by Jon Loeliger. Both node B and C are
a commit parents of commit node A. Parent commits are ordered a commit parents of commit node A. Parent commits are ordered
left-to-right. left-to-right.