path: root/Documentation
diff options
authorJunio C Hamano <>2008-01-05 20:09:55 (GMT)
committerJunio C Hamano <>2008-01-07 02:41:43 (GMT)
commita6d97d49e23382027efff8a8e90e69e0572620c6 (patch)
treed9cb3a0a7857a18f7825d44d6b65b3e3f1719942 /Documentation
parent3023dc690f98f83b64cc6f2a9cc015bf2b01964a (diff)
git-rev-parse --symbolic-full-name
The plumbing level can understand that the user meant "refs/heads/master" when the user says "master" or "heads/master", but there is no easy way for the scripts to figure it out without duplicating the dwim_ref() logic. Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation')
1 files changed, 7 insertions, 0 deletions
diff --git a/Documentation/git-rev-parse.txt b/Documentation/git-rev-parse.txt
index 329fce0..0cedc13 100644
--- a/Documentation/git-rev-parse.txt
+++ b/Documentation/git-rev-parse.txt
@@ -70,6 +70,13 @@ OPTIONS
possible '{caret}' prefix); this option makes them output in a
form as close to the original input as possible.
+ This is similar to \--symbolic, but it omits input that
+ are not refs (i.e. branch or tag names; or more
+ explicitly disambiguating "heads/master" form, when you
+ want to name the "master" branch when there is an
+ unfortunately named tag "master"), and show them as full
+ refnames (e.g. "refs/heads/master").
Show all refs found in `$GIT_DIR/refs`.