<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<article lang="en" id="git-mailinfo(1)">
<articleinfo>
    <title>git-mailinfo(1)</title>
        <indexterm>
                <primary>git-mailinfo(1)</primary>
        </indexterm>
</articleinfo>
<simplesect id="_name">
<title>NAME</title>
<simpara>git-mailinfo - Extracts patch and authorship from a single e-mail message</simpara>
</simplesect>
<simplesect id="_synopsis">
<title>SYNOPSIS</title>
<simpara><emphasis>git mailinfo</emphasis> [-k] [-u | --encoding=&lt;encoding&gt; | -n] &lt;msg&gt; &lt;patch&gt;</simpara>
</simplesect>
<simplesect id="_description">
<title>DESCRIPTION</title>
<simpara>Reads a single e-mail message from the standard input, and
writes the commit log message in &lt;msg&gt; file, and the patches in
&lt;patch&gt; file.  The author name, e-mail and e-mail subject are
written out to the standard output to be used by <emphasis>git-am</emphasis>
to create a commit.  It is usually not necessary to use this
command directly.  See <xref linkend="git-am(1)"/> instead.</simpara>
</simplesect>
<simplesect id="_options">
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term>
-k
</term>
<listitem>
<simpara>
        Usually the program <emphasis>cleans up</emphasis> the Subject: header line
        to extract the title line for the commit log message,
        among which (1) remove <emphasis>Re:</emphasis> or <emphasis>re:</emphasis>, (2) leading
        whitespaces, (3) <emphasis>[</emphasis> up to <emphasis>]</emphasis>, typically <emphasis>[PATCH]</emphasis>, and
        then prepends "[PATCH] ".  This flag forbids this
        munging, and is most useful when used to read back
        <emphasis>git-format-patch -k</emphasis> output.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-u
</term>
<listitem>
<simpara>
        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 UTF-8 by transliterating
        them.  This used to be optional but now it is the default.
</simpara>
<simpara>Note that the patch is always used as-is without charset
conversion, even with this flag.</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--encoding=&lt;encoding&gt;
</term>
<listitem>
<simpara>
        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.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-n
</term>
<listitem>
<simpara>
        Disable all charset re-coding of the metadata.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
&lt;msg&gt;
</term>
<listitem>
<simpara>
        The commit log message extracted from e-mail, usually
        except the title line which comes from e-mail Subject.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
&lt;patch&gt;
</term>
<listitem>
<simpara>
        The patch extracted from e-mail.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</simplesect>
<simplesect id="_author">
<title>Author</title>
<simpara>Written by Linus Torvalds &lt;<ulink url="mailto:torvalds@osdl.org">torvalds@osdl.org</ulink>&gt; and
Junio C Hamano &lt;<ulink url="mailto:gitster@pobox.com">gitster@pobox.com</ulink>&gt;</simpara>
</simplesect>
<simplesect id="_documentation">
<title>Documentation</title>
<simpara>Documentation by Junio C Hamano and the git-list &lt;<ulink url="mailto:git@vger.kernel.org">git@vger.kernel.org</ulink>&gt;.</simpara>
</simplesect>
<simplesect id="_git">
<title>GIT</title>
<simpara>Part of the <xref linkend="git(1)"/> suite</simpara>
</simplesect>
</article>
