other versions
- wheezy 1:1.7.10.4-1+wheezy3
- wheezy-backports 1:1.9.1-1~bpo70+2
- jessie 1:2.1.4-2.1+deb8u2
- jessie-backports 1:2.11.0-3~bpo8+1
- testing 1:2.11.0-3
- unstable 1:2.11.0-4
- experimental 1:2.13.1+next.20170610-1
GIT-SYMBOLIC-REF(1) | Git Manual | GIT-SYMBOLIC-REF(1) |
NAME¶
git-symbolic-ref - Read and modify symbolic refsSYNOPSIS¶
git symbolic-ref [-m <reason>] <name> <ref> git symbolic-ref [-q] [--short] <name>
DESCRIPTION¶
Given one argument, reads which branch head the given symbolic ref refers to and outputs its path, relative to the .git/ directory. Typically you would give HEAD as the <name> argument to see which branch your working tree is on.OPTIONS¶
-q, --quietDo not issue an error message if the
<name> is not a symbolic ref but a detached HEAD; instead exit with
non-zero status silently.
--short
When showing the value of <name> as a
symbolic ref, try to shorten the value, e.g. from refs/heads/master to
master.
-m
Update the reflog for <name> with
<reason>. This is valid only when creating or updating a symbolic
ref.
NOTES¶
In the past, .git/HEAD was a symbolic link pointing at refs/heads/master. When we wanted to switch to another branch, we did ln -sf refs/heads/newbranch .git/HEAD, and when we wanted to find out which branch we are on, we did readlink .git/HEAD. But symbolic links are not entirely portable, so they are now deprecated and symbolic refs (as described above) are used by default.GIT¶
Part of the git(1) suite03/19/2016 | Git 1.7.10.4 |