git-check-mailmap
Resolve canonical author and committer identities
TLDR
SYNOPSIS
git check-mailmap [options] contact
DESCRIPTION
git check-mailmap looks up canonical names and email addresses using the mailmap file. It translates author/committer identities to their canonical forms as configured in .mailmap.The mailmap feature consolidates identity variations (typos, name changes, multiple emails) to canonical forms. This command shows how identities will be mapped in git log and shortlog output.This is primarily a debugging tool for verifying that .mailmap entries are correctly resolving contributor identities before relying on them in reports or statistics.
PARAMETERS
CONTACT
Contact in "Name <email>" format.--stdin
Read contacts from stdin.--mailmap-file FILE
Also read the specified mailmap file, taking precedence over the repository's configured mailmap.--mailmap-blob BLOB
Like --mailmap-file, but read the mailmap from a blob in the repository.--help
Display help information.
CONFIGURATION
.mailmap
Maps author and committer names/emails to canonical forms, consolidating identity variations in logs and statistics.
INSTALL
CAVEATS
Requires .mailmap file in repository. Input must be proper "Name <email>" format. Used mainly for debugging.
HISTORY
git check-mailmap was added to Git to support debugging mailmap configurations, complementing git shortlog -e functionality.
SEE ALSO
git-shortlog(1), git-log(1)
