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: . + +- 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`