Documentation / git-mailsplit.txton commit Sync with maint (a0a1831)
   1git-mailsplit(1)
   2================
   3
   4NAME
   5----
   6git-mailsplit - Simple UNIX mbox splitter program
   7
   8SYNOPSIS
   9--------
  10[verse]
  11'git mailsplit' [-b] [-f<nn>] [-d<prec>] [--keep-cr] [--mboxrd]
  12                -o<directory> [--] [(<mbox>|<Maildir>)...]
  13
  14DESCRIPTION
  15-----------
  16Splits a mbox file or a Maildir into a list of files: "0001" "0002" ..  in the
  17specified directory so you can process them further from there.
  18
  19IMPORTANT: Maildir splitting relies upon filenames being sorted to output
  20patches in the correct order.
  21
  22OPTIONS
  23-------
  24<mbox>::
  25        Mbox file to split.  If not given, the mbox is read from
  26        the standard input.
  27
  28<Maildir>::
  29        Root of the Maildir to split. This directory should contain the cur, tmp
  30        and new subdirectories.
  31
  32-o<directory>::
  33        Directory in which to place the individual messages.
  34
  35-b::
  36        If any file doesn't begin with a From line, assume it is a
  37        single mail message instead of signaling error.
  38
  39-d<prec>::
  40        Instead of the default 4 digits with leading zeros,
  41        different precision can be specified for the generated
  42        filenames.
  43
  44-f<nn>::
  45        Skip the first <nn> numbers, for example if -f3 is specified,
  46        start the numbering with 0004.
  47
  48--keep-cr::
  49        Do not remove `\r` from lines ending with `\r\n`.
  50
  51--mboxrd::
  52        Input is of the "mboxrd" format and "^>+From " line escaping is
  53        reversed.
  54
  55GIT
  56---
  57Part of the linkgit:git[1] suite