]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/git-mailsplit.txt
War on whitespace
[thirdparty/git.git] / Documentation / git-mailsplit.txt
CommitLineData
7fc9d69f
JH
1git-mailsplit(1)
2================
3
4NAME
5----
c3f0baac 6git-mailsplit - Simple UNIX mbox splitter program
7fc9d69f
JH
7
8SYNOPSIS
9--------
d63bd9a2 10'git-mailsplit' [-b] [-f<nn>] [-d<prec>] -o<directory> [--] [<mbox>|<Maildir>...]
7fc9d69f
JH
11
12DESCRIPTION
13-----------
d63bd9a2
FP
14Splits a mbox file or a Maildir into a list of files: "0001" "0002" .. in the
15specified directory so you can process them further from there.
16
17IMPORTANT: Maildir splitting relies upon filenames being sorted to output
18patches in the correct order.
7fc9d69f
JH
19
20OPTIONS
21-------
f58b7432 22<mbox>::
8b73edf4
JH
23 Mbox file to split. If not given, the mbox is read from
24 the standard input.
7fc9d69f 25
d63bd9a2
FP
26<Maildir>::
27 Root of the Maildir to split. This directory should contain the cur, tmp
28 and new subdirectories.
29
f58b7432
LAS
30<directory>::
31 Directory in which to place the individual messages.
7fc9d69f 32
b3f041fb
PA
33-b::
34 If any file doesn't begin with a From line, assume it is a
addf88e4 35 single mail message instead of signaling error.
b3f041fb 36
54ba6013
JH
37-d<prec>::
38 Instead of the default 4 digits with leading zeros,
39 different precision can be specified for the generated
40 filenames.
41
b3f041fb
PA
42-f<nn>::
43 Skip the first <nn> numbers, for example if -f3 is specified,
44 start the numbering with 0004.
54ba6013 45
7fc9d69f
JH
46Author
47------
48Written by Linus Torvalds <torvalds@osdl.org>
8b73edf4
JH
49and Junio C Hamano <junkio@cox.net>
50
7fc9d69f
JH
51
52Documentation
53--------------
54Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
55
56GIT
57---
a7154e91 58Part of the gitlink:git[7] suite