From 57af452076f41cff9f7d8c430d022e3f7884e44c Mon Sep 17 00:00:00 2001
From: Daiju <56184759+daijudev@users.noreply.github.com>
Date: Sat, 24 May 2025 03:47:57 +0900
Subject: [PATCH] git-name-rev: add page (#16549)

---
 pages/common/git-name-rev.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 pages/common/git-name-rev.md

diff --git a/pages/common/git-name-rev.md b/pages/common/git-name-rev.md
new file mode 100644
index 0000000000..07e954a069
--- /dev/null
+++ b/pages/common/git-name-rev.md
@@ -0,0 +1,36 @@
+# git name-rev
+
+> Describe a commit using existing ref names.
+> More information: <https://git-scm.com/docs/git-name-rev>.
+
+- Show the name for HEAD:
+
+`git name-rev HEAD`
+
+- Show only the name:
+
+`git name-rev --name-only HEAD`
+
+- Enumerate all matching ref names:
+
+`git name-rev --all`
+
+- Use only tags to name the commit:
+
+`git name-rev --tags HEAD`
+
+- Exit with a non-zero status code instead of printing `undefined` for unknown commits:
+
+`git name-rev --no-undefined {{commit-ish}}`
+
+- Show names for multiple commits:
+
+`git name-rev HEAD~1 HEAD~2 main`
+
+- Restrict names to branch refs:
+
+`git name-rev --refs refs/heads/ {{commit-ish}}`
+
+- Read commit IDs from `stdin`:
+
+`echo "{{commit-ish}}" | git name-rev --annotate-stdin`