| '\" 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-09-29 |
| .\" Manual: Git Manual |
| .\" Source: Git 2.51.0.372.g821f583da6 |
| .\" Language: English |
| .\" |
| .TH "GIT\-MAILSPLIT" "1" "2025-09-29" "Git 2\&.51\&.0\&.372\&.g821f58" "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 |
| \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 |
