LinuxCommandLibrary

git-check-mailmap

Resolve canonical author and committer identities

TLDR

Check mailmap entry

$ git check-mailmap "[Name] <email@example.com>"
copy
Map multiple entries
$ git check-mailmap "[Name1] <email1>" "[Name2] <email2>"
copy
Read from stdin
$ echo "[Name] <email>" | git check-mailmap --stdin
copy

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.
--help
Display help information.

CONFIGURATION

.mailmap

Maps author and committer names/emails to canonical forms, consolidating identity variations in logs and statistics.

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

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community