GIT-MAILINFO(1)GIT-MAILINFO(1)NAMEgit-mailinfo - Extracts patch and authorship from a single e-mail mes-
sage
SYNOPSIS
git mailinfo [-k|-b] [-u | --encoding=<encoding> | -n] [--scissors]
<msg> <patch>
DESCRIPTION
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 git am to create a commit. It is usually not nec-
essary to use this command directly. See git-am(1) instead.
OPTIONS-k Usually the program cleans up the Subject: header line to
extract the title line for the commit log message, among which
(1) remove Re: or re:, (2) leading whitespaces, (3) [ up to ],
typically [PATCH], and then prepends "[PATCH] ". This flag for-
bids this munging, and is most useful when used to read back git
format-patch -k output.
-b When -k is not in effect, all leading strings bracketed with [
and ] pairs are stripped. This option limits the stripping to
only the pairs whose bracketed string contains the word "PATCH".
-u 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.commitencod-
ing (defaulting to UTF-8) by transliterating them. This used to
be optional but now it is the default.
Note that the patch is always used as-is without charset conver-
sion, even with this flag.
--encoding=<encoding>
Similar to -u. But when re-coding, the charset specified here is
used instead of the one specified by i18n.commitencoding or
UTF-8.
-n Disable all charset re-coding of the metadata.
--scissors
Remove everything in body before a scissors line. A line that
mainly consists of scissors (either ">8" or "8<") and perfora-
tion (dash "-") marks is called a scissors line, and is used to
1
GIT-MAILINFO(1)GIT-MAILINFO(1)
request the reader to cut the message at that line. If such a
line appears in the body of the message before the patch, every-
thing before it (including the scissors line itself) is ignored
when this option is used.
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, sepa-
rating the discussion and the beginning of the proposed commit
log message with a scissors line.
This can enabled by default with the configuration option mail-
info.scissors.
--no-scissors
Ignore scissors lines. Useful for overriding mailinfo.scissors
settings.
<msg> The commit log message extracted from e-mail, usually except the
title line which comes from e-mail Subject.
<patch>
The patch extracted from e-mail.
AUTHOR
Written by Linus Torvalds <torvalds@osdl.org: mailto:torvalds@osdl.org>
and Junio C Hamano <gitster@pobox.com: mailto:gitster@pobox.com>
DOCUMENTATION
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org:
mailto:git@vger.kernel.org>.
GIT
Part of the git(1) suite
2
