ref-filter.h: add functions for filter/format & format-only
[alt-git.git] / Documentation / git-mailsplit.txt
blobe3b2a88c4b75f1f6e23feb8a09030469468d9ca8
1 git-mailsplit(1)
2 ================
4 NAME
5 ----
6 git-mailsplit - Simple UNIX mbox splitter program
8 SYNOPSIS
9 --------
10 [verse]
11 'git mailsplit' [-b] [-f<nn>] [-d<prec>] [--keep-cr] [--mboxrd]
12                 -o<directory> [--] [(<mbox>|<Maildir>)...]
14 DESCRIPTION
15 -----------
16 Splits a mbox file or a Maildir into a list of files: "0001" "0002" ..  in the
17 specified directory so you can process them further from there.
19 IMPORTANT: Maildir splitting relies upon filenames being sorted to output
20 patches in the correct order.
22 OPTIONS
23 -------
24 <mbox>::
25         Mbox file to split.  If not given, the mbox is read from
26         the standard input.
28 <Maildir>::
29         Root of the Maildir to split. This directory should contain the cur, tmp
30         and new subdirectories.
32 -o<directory>::
33         Directory in which to place the individual messages.
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.
39 -d<prec>::
40         Instead of the default 4 digits with leading zeros,
41         different precision can be specified for the generated
42         filenames.
44 -f<nn>::
45         Skip the first <nn> numbers, for example if -f3 is specified,
46         start the numbering with 0004.
48 --keep-cr::
49         Do not remove `\r` from lines ending with `\r\n`.
51 --mboxrd::
52         Input is of the "mboxrd" format and "^>+From " line escaping is
53         reversed.
55 GIT
56 ---
57 Part of the linkgit:git[1] suite