blob: c4f4cabbdcdaae18491c301d44fd68ae89b18352 [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 Hamanob7ed57a2007-05-25 05:01:3010'git-mailsplit' [-b] [-f<nn>] [-d<prec>] -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 Hamano1a4e8412005-12-27 08:17:2330<directory>::
31Directory 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
46Author
47------
48Written by Linus Torvalds <torvalds@osdl.org>
49and Junio C Hamano <junkio@cox.net>
50
51
52Documentation
53--------------
54Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
55
56GIT
57---
58Part of the gitlink:git[7] suite