libra check-mailmap
Command reference for `libra check-mailmap`
Resolve Name <email> contacts through the repository .mailmap — a focused
subset of git check-mailmap.
Synopsis
libra check-mailmap <contact>...
libra check-mailmap --stdinDescription
For each Name <email> contact (given as arguments or, with --stdin, one per
line on stdin), check-mailmap looks it up in the worktree's .mailmap and
prints the canonical Name <email>. A contact with no .mailmap match is
printed unchanged.
.mailmap lines take the usual Git forms:
Proper Name <[email protected]>
<[email protected]> <[email protected]>
Proper Name <[email protected]> <[email protected]>
Proper Name <[email protected]> Commit Name <[email protected]>A (name, email) rule (with a commit name) takes precedence over an
email-only rule for the same email, matching Git. Comments (#) and blank lines
are ignored.
Options
| Option | Description | Example |
|---|---|---|
<contact>... | Contacts to resolve, each Name <email>. | libra check-mailmap 'Bob <bob@old>' |
--stdin | Read contacts (one per line) from stdin. | … | libra check-mailmap --stdin |
--json / --machine | Structured output: { contacts: [...] }. | libra --json check-mailmap 'B <b@x>' |
Exit codes
| Code | Meaning |
|---|---|
0 | Resolved contacts were printed. |
128 | Not inside a repository, no contacts given, or a contact missing <email>. |
Examples
echo 'Old Name <[email protected]>' | libra check-mailmap --stdin
libra check-mailmap 'Old Name <[email protected]>' 'Other <[email protected]>'Comparison with Git
| Task | Libra | Git |
|---|---|---|
| Resolve a contact | libra check-mailmap '<c>' | git check-mailmap '<c>' |
| From stdin | libra check-mailmap --stdin | git check-mailmap --stdin |
Differences and deferred features: only the worktree .mailmap is read
(mailmap.file / mailmap.blob config not yet honoured), and the resolver is
not yet wired into log / blame author display — that integration is a
documented follow-up.