diff --git a/pages/common/git-symbolic-ref.md b/pages/common/git-symbolic-ref.md new file mode 100644 index 0000000000..d4854a1b55 --- /dev/null +++ b/pages/common/git-symbolic-ref.md @@ -0,0 +1,24 @@ +# git symbolic-ref + +> Read, change, or delete files that store references. +> More information: . + +- Store a reference by a name: + +`git symbolic-ref refs/{{name}} {{ref}}` + +- Store a reference by name, including a message with a reason for the update: + +`git symbolic-ref -m "{{message}}" refs/{{name}} refs/heads/{{branch_name}}` + +- Read a reference by name: + +`git symbolic-ref refs/{{name}}` + +- Delete a reference by name: + +`git symbolic-ref --delete refs/{{name}}` + +- For scripting, hide errors with `--quiet` and use `--short` to simplify ("refs/heads/X" prints as "X"): + +`git symbolic-ref --quiet --short refs/{{name}}`