X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-mailsplit.txt;h=c4f4cabbdcdaae18491c301d44fd68ae89b18352;hb=2729cadca22dce2b5bb994581c45a6a71daf7998;hp=557d2e9056f028409be78d086c96f9b8de4b16a9;hpb=0493a3fd5204a36bc961a8611770ddb9ec1ed8ed;p=git.git diff --git a/Documentation/git-mailsplit.txt b/Documentation/git-mailsplit.txt index 557d2e905..c4f4cabbd 100644 --- a/Documentation/git-mailsplit.txt +++ b/Documentation/git-mailsplit.txt @@ -3,28 +3,51 @@ git-mailsplit(1) NAME ---- -git-mailsplit - Totally braindamaged mbox splitter program. +git-mailsplit - Simple UNIX mbox splitter program SYNOPSIS -------- -'git-mailsplit' +'git-mailsplit' [-b] [-f] [-d] -o [--] [|...] DESCRIPTION ----------- -Splits a mbox file into a list of files: "0001" "0002" .. in the specified -directory so you can process them further from there. +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. + +IMPORTANT: Maildir splitting relies upon filenames being sorted to output +patches in the correct order. OPTIONS ------- :: - Mbox file to split. + Mbox file to split. If not given, the mbox is read from + the standard input. + +:: + Root of the Maildir to split. This directory should contain the cur, tmp + and new subdirectories. :: Directory in which to place the individual messages. +-b:: + If any file doesn't begin with a From line, assume it is a + single mail message instead of signaling error. + +-d:: + Instead of the default 4 digits with leading zeros, + different precision can be specified for the generated + filenames. + +-f:: + Skip the first numbers, for example if -f3 is specified, + start the numbering with 0004. + Author ------ Written by Linus Torvalds +and Junio C Hamano + Documentation -------------- @@ -33,4 +56,3 @@ Documentation by Junio C Hamano and the git-list . GIT --- Part of the gitlink:git[7] suite -