blob: a634485281154cb665c8168cc3469dc0f5051697 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:231git-mailsplit(1)
2================
3
4NAME
5----
Junio C Hamano7c73c662007-01-19 00:37:506git-mailsplit - Simple UNIX mbox splitter program
Junio C Hamano1a4e8412005-12-27 08:17:237
8SYNOPSIS
9--------
Junio C Hamanocaa712a2010-03-11 01:17:3510'git mailsplit' [-b] [-f<nn>] [-d<prec>] [--keep-cr] -o<directory> [--] [<mbox>|<Maildir>...]
Junio C Hamano1a4e8412005-12-27 08:17:2311
12DESCRIPTION
13-----------
Junio C Hamanob7ed57a2007-05-25 05:01:3014Splits 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.
Junio C Hamano1a4e8412005-12-27 08:17:2319
20OPTIONS
21-------
22<mbox>::
23Mbox file to split. If not given, the mbox is read from
24the standard input.
25
Junio C Hamanob7ed57a2007-05-25 05:01:3026<Maildir>::
27Root of the Maildir to split. This directory should contain the cur, tmp
28and new subdirectories.
29
Junio C Hamano14ccc602008-06-04 23:09:2130-o<directory>::
Junio C Hamano1a4e8412005-12-27 08:17:2331Directory in which to place the individual messages.
32
33-b::
34If any file doesn't begin with a From line, assume it is a
Junio C Hamano51c2ab02006-07-09 20:38:5435single mail message instead of signaling error.
Junio C Hamano1a4e8412005-12-27 08:17:2336
37-d<prec>::
38Instead of the default 4 digits with leading zeros,
39different precision can be specified for the generated
40filenames.
41
42-f<nn>::
43Skip the first <nn> numbers, for example if -f3 is specified,
44start the numbering with 0004.
45
Junio C Hamanocaa712a2010-03-11 01:17:3546--keep-cr::
47Do not remove `\r` from lines ending with `\r\n`.
48
Junio C Hamano1a4e8412005-12-27 08:17:2349Author
50------
51Written by Linus Torvalds <torvalds@osdl.org>
Junio C Hamano0868a302008-07-22 09:20:4452and Junio C Hamano <gitster@pobox.com>
Junio C Hamano1a4e8412005-12-27 08:17:2353
54
55Documentation
56--------------
57Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
58
59GIT
60---
Junio C Hamanof7c042d2008-06-06 22:50:5361Part of the linkgit:git[1] suite