[PATCH] Add revspec documentation for ':path', ':[0-3]:path' and git-describe
Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
---
Documentation/git-rev-parse.txt | 9 +++++++++
1 files changed, 9 insertions(+), 0 deletions(-)
As I'm not very good at English, please correct any mistake I made
diff --git a/Documentation/git-rev-parse.txt b/Documentation/git-rev-parse.txt
index 2f1306c..f8f4920 100644
--- a/Documentation/git-rev-parse.txt
+++ b/Documentation/git-rev-parse.txt
@@ -119,11 +119,17 @@ syntax.
name the same commit object if there are no other object in
your repository whose object name starts with dae86e.
+* The result of `git-describe`
+
* 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
explicitly say 'heads/master' to tell git which one you mean.
+* A colon at the beginning, followed by path name to specify
+ a file in index. If you want to specify a file in a stage,
+ use expression ':[0-3]:<path>' instead.
+
* A suffix '@' followed by a date specification enclosed in a brace
pair (e.g. '\{yesterday\}', '\{1 month 2 weeks 3 days 1 hour 1
second ago\}' or '\{1979-02-26 18:30:00\}') to specify the value
@@ -156,6 +162,9 @@ syntax.
and dereference the tag recursively until a non-tag object is
found.
+* A suffix ':' followed by path name to specify a specific file
+ in that commit/tag/tree.
+
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.
--
1.4.3.rc2.g0503-dirty
pclouds@gmail.com <pclouds@gmail.com>