git-check-mailmap - Man Page
Show canonical names and email addresses of contacts
Examples (TL;DR)
- Look up the canonical name associated with an email address:
git check-mailmap email@example.com - Use the specified mailmap file in addition to the defaults:
git check-mailmap --mailmap-file path/to/file email@example.com
Synopsis
git check-mailmap [<options>] <contact>...
Description
For each “Name <user@host>”, “<user@host>”, or “user@host” from the command-line or standard input (when using --stdin), look up the person’s canonical name and email address (see "Mapping Authors" below). If found, print them; otherwise print the input as-is.
Options
- --stdin
Read contacts, one per line, from the standard input after exhausting contacts provided on the command-line.
- --mailmap-file=<file>
In addition to any configured mailmap files, read the specified mailmap file. Entries in this file take precedence over entries in either the default mailmap file or any configured mailmap file.
- --mailmap-blob=<blob>
Like --mailmap-file, but consider the value as a reference to a blob in the repository. If both --mailmap-file and --mailmap-blob are specified, entries in --mailmap-file will take precedence.
Output
For each contact, a single line is output, terminated by a newline. If the name is provided or known to the mailmap, “Name <user@host>” is printed; otherwise only “<user@host>” is printed.
Configuration
See mailmap.file and mailmap.blob in git-config(1) for how to specify a custom .mailmap target file or object.
Mapping Authors
See gitmailmap(5).
Git
Part of the git(1) suite