git-name-rev(1) =============== NAME ---- git-name-rev - Find symbolic names for given revs SYNOPSIS -------- [verse] 'git name-rev' [--tags] [--refs=] ( --all | --annotate-stdin | ... ) DESCRIPTION ----------- Finds symbolic names suitable for human digestion for revisions given in any format parsable by 'git rev-parse'. OPTIONS ------- --tags:: Do not use branch names, but only tags to name the commits --refs=:: Only use refs whose names match a given shell pattern. The pattern can be a branch name, a tag name, or a fully qualified ref name. If given multiple times, use refs whose names match any of the given shell patterns. Use `--no-refs` to clear any previous ref patterns given. --exclude=:: Do not use any ref whose name matches a given shell pattern. The pattern can be one of branch name, tag name or fully qualified ref name. If given multiple times, a ref will be excluded when it matches any of the given patterns. When used together with --refs, a ref will be used as a match only when it matches at least one --refs pattern and does not match any --exclude patterns. Use `--no-exclude` to clear the list of exclude patterns. --all:: List all commits reachable from all refs --annotate-stdin:: Transform stdin by substituting all the 40-character SHA-1 hexes (say $hex) with "$hex ($rev_name)". When used with --name-only, substitute with "$rev_name", omitting $hex altogether. This option was called `--stdin` in older versions of Git. + For example: + ----------- $ cat sample.txt An abbreviated revision 2ae0a9cb82 will not be substituted. The full name after substitution is 2ae0a9cb8298185a94e5998086f380a355dd8907, while its tree object is 70d105cc79e63b81cfdcb08a15297c23e60b07ad $ git name-rev --annotate-stdin