Autogenerated manpages for v2.39.1-231-ga7caae
[git-manpages.git] / man1 / git-mailsplit.1
blob96fe546d5b8164fffa1f3b7173e95a2a873afc8a
1 '\" t
2 .\"     Title: git-mailsplit
3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\"      Date: 01/17/2023
6 .\"    Manual: Git Manual
7 .\"    Source: Git 2.39.1.231.ga7caae2729
8 .\"  Language: English
9 .\"
10 .TH "GIT\-MAILSPLIT" "1" "01/17/2023" "Git 2\&.39\&.1\&.231\&.ga7caae" "Git Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 git-mailsplit \- Simple UNIX mbox splitter program
32 .SH "SYNOPSIS"
33 .sp
34 .nf
35 \fIgit mailsplit\fR [\-b] [\-f<nn>] [\-d<prec>] [\-\-keep\-cr] [\-\-mboxrd]
36                 \-o<directory> [\-\-] [(<mbox>|<Maildir>)\&...]
37 .fi
38 .sp
39 .SH "DESCRIPTION"
40 .sp
41 Splits a mbox file or a Maildir into a list of files: "0001" "0002" \&.\&. in the specified directory so you can process them further from there\&.
42 .if n \{\
43 .sp
44 .\}
45 .RS 4
46 .it 1 an-trap
47 .nr an-no-space-flag 1
48 .nr an-break-flag 1
49 .br
50 .ps +1
51 \fBImportant\fR
52 .ps -1
53 .br
54 .sp
55 Maildir splitting relies upon filenames being sorted to output patches in the correct order\&.
56 .sp .5v
57 .RE
58 .SH "OPTIONS"
59 .PP
60 <mbox>
61 .RS 4
62 Mbox file to split\&. If not given, the mbox is read from the standard input\&.
63 .RE
64 .PP
65 <Maildir>
66 .RS 4
67 Root of the Maildir to split\&. This directory should contain the cur, tmp and new subdirectories\&.
68 .RE
69 .PP
70 \-o<directory>
71 .RS 4
72 Directory in which to place the individual messages\&.
73 .RE
74 .PP
75 \-b
76 .RS 4
77 If any file doesn\(cqt begin with a From line, assume it is a single mail message instead of signaling error\&.
78 .RE
79 .PP
80 \-d<prec>
81 .RS 4
82 Instead of the default 4 digits with leading zeros, different precision can be specified for the generated filenames\&.
83 .RE
84 .PP
85 \-f<nn>
86 .RS 4
87 Skip the first <nn> numbers, for example if \-f3 is specified, start the numbering with 0004\&.
88 .RE
89 .PP
90 \-\-keep\-cr
91 .RS 4
92 Do not remove
93 \fB\er\fR
94 from lines ending with
95 \fB\er\en\fR\&.
96 .RE
97 .PP
98 \-\-mboxrd
99 .RS 4
100 Input is of the "mboxrd" format and "^>+From " line escaping is reversed\&.
102 .SH "GIT"
104 Part of the \fBgit\fR(1) suite