From b609918f6224b63ce1fc886f38d1a80c62764766 Mon Sep 17 00:00:00 2001
From: Daiju <56184759+daiju81@users.noreply.github.com>
Date: Mon, 19 May 2025 22:02:56 +0900
Subject: [PATCH] git-for-each-ref: add page (#16531)

* git for-each-ref: add page

* git for-each-ref: use space separator for options
---
 pages/common/git-for-each-ref.md | 36 ++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 pages/common/git-for-each-ref.md

diff --git a/pages/common/git-for-each-ref.md b/pages/common/git-for-each-ref.md
new file mode 100644
index 0000000000..0279e9d093
--- /dev/null
+++ b/pages/common/git-for-each-ref.md
@@ -0,0 +1,36 @@
+# git for-each-ref
+
+> List and optionally format references (branches, tags) in a Git repository.
+> More information: <https://git-scm.com/docs/git-for-each-ref>.
+
+- List all refs (branches and tags):
+
+`git for-each-ref`
+
+- List only branches:
+
+`git for-each-ref refs/heads/`
+
+- List only tags:
+
+`git for-each-ref refs/tags/`
+
+- Show branches merged into HEAD:
+
+`git for-each-ref --merged HEAD refs/heads/`
+
+- List short names of all refs:
+
+`git for-each-ref --format "%(refname:short)"`
+
+- Sort refs by committer date (most recent first):
+
+`git for-each-ref --sort -committerdate`
+
+- Sort refs by committer date (oldest first):
+
+`git for-each-ref --sort committerdate`
+
+- Limit output to a specified number of refs:
+
+`git for-each-ref --count {{count}}`