git-name-rev
Find symbolic names for given commits
SYNOPSIS
git name-rev [
PARAMETERS
--tags
Consider tags as symbolic names.
--refs=
Consider only refs matching
--remotes=
Consider only remote refs matching
--branches=
Consider only local branch refs matching
--exclude=
Exclude refs matching
--all
Consider all refs.
--name-only
Only output the name.
--no-undefined
Fail if no name is found.
The Git object to find a name for (e.g., commit ID, branch name, tag name).
--undefined=
Print
DESCRIPTION
The git-name-rev command is a utility in Git for finding symbolic names that refer to specific revisions. It provides a way to translate commit IDs or other Git object names into more human-readable and stable references, like tag names or branch names.
The core functionality revolves around identifying the "best" name that points to a given commit. This is particularly useful for scripting, generating build information, or creating user interfaces where presenting commit IDs would be less informative. The command prioritizes different types of names (e.g., tags over branches) and can be configured to match specific naming conventions. Its primary purpose is to resolve ambiguous or opaque Git object names into more easily understood references. In essence, it's a reverse lookup tool for Git revisions, turning raw commit hashes into descriptive names.
UNDERSTANDING THE OUTPUT
The default output format is:
SEE ALSO
git-rev-parse(1), git-show-ref(1)
