blob: 6d6b16acb575b583dc8276b344d912ea8120aa39 [file] [log] [blame]
'\" t
.\" Title: git-mailinfo
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 11/22/2018
.\" Manual: Git Manual
.\" Source: Git 2.20.0.rc1
.\" Language: English
.\"
.TH "GIT\-MAILINFO" "1" "11/22/2018" "Git 2\&.20\&.0\&.rc1" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-mailinfo \- Extracts patch and authorship from a single e\-mail message
.SH "SYNOPSIS"
.sp
.nf
\fIgit mailinfo\fR [\-k|\-b] [\-u | \-\-encoding=<encoding> | \-n] [\-\-[no\-]scissors] <msg> <patch>
.fi
.sp
.SH "DESCRIPTION"
.sp
Reads a single e\-mail message from the standard input, and writes the commit log message in <msg> file, and the patches in <patch> file\&. The author name, e\-mail and e\-mail subject are written out to the standard output to be used by \fIgit am\fR to create a commit\&. It is usually not necessary to use this command directly\&. See \fBgit-am\fR(1) instead\&.
.SH "OPTIONS"
.PP
\-k
.RS 4
Usually the program removes email cruft from the Subject: header line to extract the title line for the commit log message\&. This option prevents this munging, and is most useful when used to read back
\fIgit format\-patch \-k\fR
output\&.
.sp
Specifically, the following are removed until none of them remain:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Leading and trailing whitespace\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Leading
\fBRe:\fR,
\fBre:\fR, and
\fB:\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Leading bracketed strings (between
\fB[\fR
and
\fB]\fR, usually
\fB[PATCH]\fR)\&.
.RE
.sp
Finally, runs of whitespace are normalized to a single ASCII space character\&.
.RE
.PP
\-b
.RS 4
When \-k is not in effect, all leading strings bracketed with
\fI[\fR
and
\fI]\fR
pairs are stripped\&. This option limits the stripping to only the pairs whose bracketed string contains the word "PATCH"\&.
.RE
.PP
\-u
.RS 4
The commit log message, author name and author email are taken from the e\-mail, and after minimally decoding MIME transfer encoding, re\-coded in the charset specified by i18n\&.commitencoding (defaulting to UTF\-8) by transliterating them\&. This used to be optional but now it is the default\&.
.sp
Note that the patch is always used as\-is without charset conversion, even with this flag\&.
.RE
.PP
\-\-encoding=<encoding>
.RS 4
Similar to \-u\&. But when re\-coding, the charset specified here is used instead of the one specified by i18n\&.commitencoding or UTF\-8\&.
.RE
.PP
\-n
.RS 4
Disable all charset re\-coding of the metadata\&.
.RE
.PP
\-m, \-\-message\-id
.RS 4
Copy the Message\-ID header at the end of the commit message\&. This is useful in order to associate commits with mailing list discussions\&.
.RE
.PP
\-\-scissors
.RS 4
Remove everything in body before a scissors line\&. A line that mainly consists of scissors (either ">8" or "8<") and perforation (dash "\-") marks is called a scissors line, and is used to request the reader to cut the message at that line\&. If such a line appears in the body of the message before the patch, everything before it (including the scissors line itself) is ignored when this option is used\&.
.sp
This is useful if you want to begin your message in a discussion thread with comments and suggestions on the message you are responding to, and to conclude it with a patch submission, separating the discussion and the beginning of the proposed commit log message with a scissors line\&.
.sp
This can be enabled by default with the configuration option mailinfo\&.scissors\&.
.RE
.PP
\-\-no\-scissors
.RS 4
Ignore scissors lines\&. Useful for overriding mailinfo\&.scissors settings\&.
.RE
.PP
<msg>
.RS 4
The commit log message extracted from e\-mail, usually except the title line which comes from e\-mail Subject\&.
.RE
.PP
<patch>
.RS 4
The patch extracted from e\-mail\&.
.RE
.SH "GIT"
.sp
Part of the \fBgit\fR(1) suite