OnWorks favicon

git-check-mailmap - Online in the Cloud

Run git-check-mailmap in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command git-check-mailmap that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



git-check-mailmap - Show canonical names and email addresses of contacts


git check-mailmap [options] <contact>...


For each “Name <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.


Read contacts, one per line, from the standard input after exhausting contacts
provided on the command-line.


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.


If the file .mailmap exists at the toplevel of the repository, or at the location pointed
to by the mailmap.file or mailmap.blob configuration options, it is used to map author and
committer names and email addresses to canonical real names and email addresses.

In the simple form, each line in the file consists of the canonical real name of an
author, whitespace, and an email address used in the commit (enclosed by < and >) to map
to the name. For example:

Proper Name <[email protected]>

The more complex forms are:

<[email protected]> <[email protected]>

which allows mailmap to replace only the email part of a commit, and:

Proper Name <[email protected]> <[email protected]>

which allows mailmap to replace both the name and the email of a commit matching the
specified commit email address, and:

Proper Name <[email protected]> Commit Name <[email protected]>

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:

Joe Developer <[email protected]>
Joe R. Developer <[email protected]>
Jane Doe <[email protected]>
Jane Doe <jane@laptop.(none)>
Jane D. <jane@desktop.(none)>

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:

Jane Doe <jane@desktop.(none)>
Joe R. Developer <[email protected]>

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:

nick1 <[email protected]>
nick2 <[email protected]>
nick2 <[email protected]>
santa <[email protected]>
claus <[email protected]>
CTO <[email protected]>

Then you might want a .mailmap file that looks like:

<[email protected]> <[email protected]>
Some Dude <[email protected]> nick1 <[email protected]>
Other Author <[email protected]> nick2 <[email protected]>
Other Author <[email protected]> <[email protected]>
Santa Claus <[email protected]> <[email protected]>

Use hash # for comments that are either on their own line, or after the email address.


Part of the git(1) suite

Use git-check-mailmap online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Alt-F provides a free and open source
    alternative firmware for the DLINK
    DNS-320/320L/321/323/325/327L and
    DNR-322L. Alt-F has Samba and NFS;
    supports ext2/3/4...
    Download Alt-F
  • 2
    Usm is a unified slackware package
    manager that handles automatic
    dependency resolution. It unifies
    various package repositories including
    slackware, slacky, p...
    Download usm
  • 3
    Chart.js is a Javascript library that
    allows designers and developers to draw
    all kinds of charts using the HTML5
    canvas element. Chart js offers a great
    array ...
    Download Chart.js
  • 4
    iReport-Designer for JasperReports
    iReport-Designer for JasperReports
    NOTE: iReport/Jaspersoft Studio Support
    Announcement: As of version 5.5.0,
    Jaspersoft Studio will be the official
    design client for JasperReports. iReport
    Download iReport-Designer for JasperReports
  • 5
    PostInstallerF will install all the
    software that Fedora Linux and others
    doesn't include by default, after
    running Fedora for the first time. Its
    easy for...
    Download PostInstallerF
  • 6
    The strace project has been moved to
    https://strace.io. strace is a
    diagnostic, debugging and instructional
    userspace tracer for Linux. It is used
    to monitor a...
    Download strace
  • More »

Linux commands