git-mailinfo.txt 1.9 KB
Newer Older
1 2 3 4 5
git-mailinfo(1)
===============

NAME
----
6
git-mailinfo - Extracts patch from a single e-mail message.
7 8 9 10


SYNOPSIS
--------
11
'git-mailinfo' [-k] [-u | --encoding=<encoding>] <msg> <patch>
12

13 14 15

DESCRIPTION
-----------
16 17 18 19 20 21
Reading 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-applypatch
to create a commit.  It is usually not necessary to use this
command directly.
22 23 24 25


OPTIONS
-------
26 27 28 29 30 31 32 33 34 35 36 37 38 39
-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 forbids this
	munging, and is most useful when used to read back 'git
	format-patch --mbox' output.

-u::
	By default, the commit log message, author name and
	author email are taken from the e-mail without any
	charset conversion, after minimally decoding MIME
	transfer encoding.  This flag causes the resulting
40 41 42
	commit to be encoded in the encoding specified by
	i18n.commitencoding configuration (defaults to utf-8) by
	transliterating them. 
43 44
	Note that the patch is always used as is without charset
	conversion, even with this flag.
45

46 47 48 49 50
--encoding=<encoding>::
	Similar to -u but if the local convention is different
	from what is specified by i18n.commitencoding, this flag
	can be used to override it.

51 52 53 54 55 56
<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.
57 58 59 60


Author
------
61 62 63
Written by Linus Torvalds <torvalds@osdl.org> and
Junio C Hamano <junkio@cox.net>

64 65 66 67 68 69 70

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT
---
71
Part of the gitlink:git[7] suite
72