[PATCHv3] git-rev-parse.txt: Document ":path" specifier
From: Michael J Gruber <hidden>
Date: 2016-06-15 22:49:01
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
Possibly related (same subject, not in this thread)
- 2016-06-15 · Re: [PATCHv3] git-rev-parse.txt: Document ":path" specifier · Junio C Hamano <hidden>
- 2016-06-15 · Re: [PATCHv3] git-rev-parse.txt: Document ":path" specifier · Michael J Gruber <hidden>
- 2016-06-15 · Re: [PATCHv3] git-rev-parse.txt: Document ":path" specifier · Matthieu Moy <hidden>
The empty treeish in ":path" means "index". This is actually a special case of the ":stage:path" syntax where it is documented, but mentioning it also together with "treeish:path" is helpful, so do it. Signed-off-by: Michael J Gruber <redacted> --- How about this? Short description at "rev:path" but still pointing to ":stage:path". Documentation/git-rev-parse.txt | 4 +++- 1 files changed, 3 insertions(+), 1 deletions(-)
diff --git a/Documentation/git-rev-parse.txt b/Documentation/git-rev-parse.txt
index 8db600f..d525e57 100644
--- a/Documentation/git-rev-parse.txt
+++ b/Documentation/git-rev-parse.txt@@ -291,7 +291,9 @@ the `$GIT_DIR/refs` directory or from the `$GIT_DIR/packed-refs` file. * 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. + before the colon. ":path" (with an empty part before the colon) + is a special case of the syntax described next: content + recorded in the index at the given path. * 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
--
1.7.1.621.g01d76