Autogenerated manpages for v2.36.1-74-g277cf0
[git-manpages.git] / man1 / git-check-mailmap.1
blob8263676e1a088e8e689ed0a3f1409e92515eec9c
1 '\" t
2 .\"     Title: git-check-mailmap
3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\"      Date: 05/11/2022
6 .\"    Manual: Git Manual
7 .\"    Source: Git 2.36.1.74.g277cf0bc36
8 .\"  Language: English
9 .\"
10 .TH "GIT\-CHECK\-MAILMAP" "1" "05/11/2022" "Git 2\&.36\&.1\&.74\&.g277cf0b" "Git Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 git-check-mailmap \- Show canonical names and email addresses of contacts
32 .SH "SYNOPSIS"
33 .sp
34 .nf
35 \fIgit check\-mailmap\fR [<options>] <contact>\&...
36 .fi
37 .sp
38 .SH "DESCRIPTION"
39 .sp
40 For each \(lqName <user@host>\(rq or \(lq<user@host>\(rq from the command\-line or standard input (when using \fB\-\-stdin\fR), look up the person\(cqs canonical name and email address (see "Mapping Authors" below)\&. If found, print them; otherwise print the input as\-is\&.
41 .SH "OPTIONS"
42 .PP
43 \-\-stdin
44 .RS 4
45 Read contacts, one per line, from the standard input after exhausting contacts provided on the command\-line\&.
46 .RE
47 .SH "OUTPUT"
48 .sp
49 For each contact, a single line is output, terminated by a newline\&. If the name is provided or known to the \fImailmap\fR, \(lqName <user@host>\(rq is printed; otherwise only \(lq<user@host>\(rq is printed\&.
50 .SH "CONFIGURATION"
51 .sp
52 See \fBmailmap\&.file\fR and \fBmailmap\&.blob\fR in \fBgit-config\fR(1) for how to specify a custom \fB\&.mailmap\fR target file or object\&.
53 .SH "MAPPING AUTHORS"
54 .sp
55 See \fBgitmailmap\fR(5)\&.
56 .SH "GIT"
57 .sp
58 Part of the \fBgit\fR(1) suite