git-commit-vandalism/Documentation/git-mailsplit.txt
Jonathan Nieder b1889c36d8 Documentation: be consistent about "git-" versus "git "
Since the git-* commands are not installed in $(bindir), using
"git-command <parameters>" in examples in the documentation is
not a good idea. On the other hand, it is nice to be able to
refer to each command using one hyphenated word. (There is no
escaping it, anyway: man page names cannot have spaces in them.)

This patch retains the dash in naming an operation, command,
program, process, or action. Complete command lines that can
be entered at a shell (i.e., without options omitted) are
made to use the dashless form.

The changes consist only of replacing some spaces with hyphens
and vice versa. After a "s/ /-/g", the unpatched and patched
versions are identical.

Signed-off-by: Jonathan Nieder <jrnieder@uchicago.edu>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2008-07-01 17:20:15 -07:00

59 lines
1.3 KiB
Plaintext

git-mailsplit(1)
================
NAME
----
git-mailsplit - Simple UNIX mbox splitter program
SYNOPSIS
--------
'git mailsplit' [-b] [-f<nn>] [-d<prec>] -o<directory> [--] [<mbox>|<Maildir>...]
DESCRIPTION
-----------
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>::
Mbox file to split. If not given, the mbox is read from
the standard input.
<Maildir>::
Root of the Maildir to split. This directory should contain the cur, tmp
and new subdirectories.
-o<directory>::
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<prec>::
Instead of the default 4 digits with leading zeros,
different precision can be specified for the generated
filenames.
-f<nn>::
Skip the first <nn> numbers, for example if -f3 is specified,
start the numbering with 0004.
Author
------
Written by Linus Torvalds <torvalds@osdl.org>
and Junio C Hamano <junkio@cox.net>
Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
GIT
---
Part of the linkgit:git[1] suite