git-check-mailmap
Show canonical names and email addresses of contacts
SYNOPSIS
gitcheck -mailmap [<options>] <contact> ...
DESCRIPTION
OPTIONS
--stdin Read contacts, one per line, from the standard input after exhausting contacts provided on the command -line .
OUTPUT
MAPPING AUTHORS
Proper Name <commit@email .xx> .RE The more complex forms are: .RS 4
<proper@email .xx> <commit@email .xx> .RE which allows mailmap to replace only the email part of a commit, and: .RS 4
Proper Name <proper@email .xx> <commit@email .xx> .RE which allows mailmap to replace both the name and the email of a commit matching the specified commit email address, and: .RS 4
Proper Name <proper@email .xx> Commit Name <commit@email .xx> .RE which allows mailmap to replace both the name and the email of a commit matching both the specified commit name and email address . Example 1: Your history contains commits by two authors, Jane and Joe, whose names appear in the repository under several forms: .RS 4
Joe Developer <joe@example .com> Joe R . Developer <joe@example .com> Jane Doe <jane@example .com> Jane Doe <jane@laptop .(none)> Jane D . <jane@desktop .(none)> .RE Now suppose that Joe wants his middle name initial used, and Jane prefers her family name fully spelled out . A proper .mailmap file would look like: .RS 4
Jane Doe <jane@desktop .(none)> Joe R . Developer <joe@example .com> .RE Note how there is no need for an entry for <jane@laptop.(none)> ,because the real name of that author is already correct . Example 2: Your repository contains commits from the following authors: .RS 4
nick1 <bugs@company .xx> nick2 <bugs@company .xx> nick2 <nick2@company .xx> santa <me@company .xx> claus <me@company .xx> CTO <cto@coompany .xx> .RE Then you might want a .mailmap file that looks like: .RS 4
<cto@company .xx> <cto@coompany .xx> Some Dude <some@dude .xx> nick1 <bugs@company .xx> Other Author <other@author .xx> nick2 <bugs@company .xx> Other Author <other@author .xx> <nick2@company .xx> Santa Claus <santa .claus@northpole .xx> <me@company .xx> .RE Use hash # for comments that are either on their own line, or after the email address .