From 510e695f9f33f77c663910476d28db4f4145a1f8 Mon Sep 17 00:00:00 2001
From: Simon B <simon.bohlin@gmail.com>
Date: Fri, 29 Oct 2021 16:01:05 +0200
Subject: [PATCH] git-symbolic-ref: add page (#6938)

---
 pages/common/git-symbolic-ref.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 pages/common/git-symbolic-ref.md

diff --git a/pages/common/git-symbolic-ref.md b/pages/common/git-symbolic-ref.md
new file mode 100644
index 000000000..d4854a1b5
--- /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: <https://git-scm.com/docs/git-symbolic-ref>.
+
+- 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}}`