<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect2 SYSTEM "../../../dtd/dblite.dtd">

<sect2 lang="en" id="git-mailsplit(1)">
    <title>git-mailsplit(1)</title>
    <date>2024-07-02</date>
<revhistory><revision><date>2024-07-02</date></revision></revhistory>
<indexterm>
<primary>git-mailsplit(1)</primary>
</indexterm>
<simplesect id="git-mailsplit(1)__name">
<title>NAME</title>
<simpara>git-mailsplit - Simple UNIX mbox splitter program</simpara>
</simplesect>
<simplesect id="git-mailsplit(1)__synopsis">
<title>SYNOPSIS</title>
<blockquote>
<literallayout><emphasis>git mailsplit</emphasis> [-b] [-f&lt;nn&gt;] [-d&lt;prec&gt;] [--keep-cr] [--mboxrd]
                -o&lt;directory&gt; [--] [(&lt;mbox&gt;|&lt;Maildir&gt;)&#8230;]</literallayout>
</blockquote>
</simplesect>
<simplesect id="git-mailsplit(1)__description">
<title>DESCRIPTION</title>
<simpara>Splits a mbox file or a Maildir into a list of files: "0001" "0002" ..  in the
specified directory so you can process them further from there.</simpara>
<important><simpara>Maildir splitting relies upon filenames being sorted to output
patches in the correct order.</simpara></important>
</simplesect>
<simplesect id="git-mailsplit(1)__options">
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term>
&lt;mbox&gt;
</term>
<listitem>
<simpara>
        Mbox file to split.  If not given, the mbox is read from
        the standard input.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
&lt;Maildir&gt;
</term>
<listitem>
<simpara>
        Root of the Maildir to split. This directory should contain the cur, tmp
        and new subdirectories.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-o&lt;directory&gt;
</term>
<listitem>
<simpara>
        Directory in which to place the individual messages.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-b
</term>
<listitem>
<simpara>
        If any file doesn't begin with a From line, assume it is a
        single mail message instead of signaling an error.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-d&lt;prec&gt;
</term>
<listitem>
<simpara>
        Instead of the default 4 digits with leading zeros,
        different precision can be specified for the generated
        filenames.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-f&lt;nn&gt;
</term>
<listitem>
<simpara>
        Skip the first &lt;nn&gt; numbers, for example if -f3 is specified,
        start the numbering with 0004.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--keep-cr
</term>
<listitem>
<simpara>
        Do not remove <emphasis>\r</emphasis> from lines ending with <emphasis>\r\n</emphasis>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
--mboxrd
</term>
<listitem>
<simpara>
        Input is of the "mboxrd" format and "^&gt;+From " line escaping is
        reversed.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</simplesect>
<simplesect id="git-mailsplit(1)__git">
<title>GIT</title>
<simpara>Part of the <xref linkend="git(1)" /> suite</simpara>
</simplesect>
</sect2>
