git-mailsplit.1 (2827B)
- '\" t
- .\" Title: git-mailsplit
- .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
- .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
- .\" Date: 2025-03-14
- .\" Manual: Git Manual
- .\" Source: Git 2.49.0
- .\" Language: English
- .\"
- .TH "GIT\-MAILSPLIT" "1" "2025-03-14" "Git 2\&.49\&.0" "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
- .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 an 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 \er from lines ending with \er\en\&.
- .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