'\" t .\" Title: git-mailinfo .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Date: 06/01/2011 .\" Manual: Git Manual .\" Source: Git 1.7.5.4 .\" Language: English .\" .TH "GIT\-MAILINFO" "1" "06/01/2011" "Git 1\&.7\&.5\&.4" "Git Manual" .\" ----------------------------------------------------------------- .\" * 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 \fIgit mailinfo\fR [\-k|\-b] [\-u | \-\-encoding=<encoding> | \-n] [\-\-scissors] <msg> <patch> .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 \fIcleans up\fR the Subject: header line to extract the title line for the commit log message, among which (1) remove \fIRe:\fR or \fIre:\fR, (2) leading whitespaces, (3) \fI[\fR up to \fI]\fR, typically \fI[PATCH]\fR, and then prepends "[PATCH] "\&. This flag forbids this munging, and is most useful when used to read back \fIgit format\-patch \-k\fR output\&. .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 \-\-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 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