blob: 8bb948f54e036abc3429fe0871b51b0a7b730112 [file] [log] [blame]
'\" t
.\" Title: git-mailsplit
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 02/13/2019
.\" Manual: Git Manual
.\" Source: Git 2.21.0.rc1
.\" Language: English
.\"
.TH "GIT\-MAILSPLIT" "1" "02/13/2019" "Git 2\&.21\&.0\&.rc1" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-mailsplit \- Simple UNIX mbox splitter program
.SH "SYNOPSIS"
.sp
.nf
\fIgit mailsplit\fR [\-b] [\-f<nn>] [\-d<prec>] [\-\-keep\-cr] [\-\-mboxrd]
\-o<directory> [\-\-] [(<mbox>|<Maildir>)\&...]
.fi
.sp
.SH "DESCRIPTION"
.sp
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\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBImportant\fR
.ps -1
.br
.sp
Maildir splitting relies upon filenames being sorted to output patches in the correct order\&.
.sp .5v
.RE
.SH "OPTIONS"
.PP
<mbox>
.RS 4
Mbox file to split\&. If not given, the mbox is read from the standard input\&.
.RE
.PP
<Maildir>
.RS 4
Root of the Maildir to split\&. This directory should contain the cur, tmp and new subdirectories\&.
.RE
.PP
\-o<directory>
.RS 4
Directory in which to place the individual messages\&.
.RE
.PP
\-b
.RS 4
If any file doesn\(cqt begin with a From line, assume it is a single mail message instead of signaling error\&.
.RE
.PP
\-d<prec>
.RS 4
Instead of the default 4 digits with leading zeros, different precision can be specified for the generated filenames\&.
.RE
.PP
\-f<nn>
.RS 4
Skip the first <nn> numbers, for example if \-f3 is specified, start the numbering with 0004\&.
.RE
.PP
\-\-keep\-cr
.RS 4
Do not remove
\fB\er\fR
from lines ending with
\fB\er\en\fR\&.
.RE
.PP
\-\-mboxrd
.RS 4
Input is of the "mboxrd" format and "^>+From " line escaping is reversed\&.
.RE
.SH "GIT"
.sp
Part of the \fBgit\fR(1) suite