."\ Master source for mailsplit : /usr/src/local/man/src/mailsplit.rof
.TH 78bit P "Manual V1.1 for Program V1.1" "Julian Stacey" "Julian Stacey, Vector Systems Ltd"
.\" A4 the cludgy way.
.pl 29.6c
.UC 4
.SH NAME
mailsplit \- Split mail and news concatenations into separate files.
.SH SYNTAX
.B mailsplit
[-c cut_str] [-r] [-o] [-v] [-?] [-- or files]
.SH SUMMARY
Split mail and news archives into separate files
.SH DESCRIPTION
Designed to be used with 
.I name_date, (
see example below).
.SH OPTIONS
Parameters must precede file names.
Parameters may be in any order.
Parameters available include :-
.TP
.B \-?
.br
Print allowable syntax, then exit(0).
.TP
.B \-c cut_str
.br
Specify the string to initiate the cutting between output files,
if you dont want the default "From ". Example: 
.ce
mailsplit -c ">From " pc532_archive_from_dlr
.TP
.B \-r
.br
Specify this if you want input file to be deleted.
Not to be used with -- option.
.TP
.B \--
.br
Take input from stdin pipe rather than files.
No files may be specified if this option is specified.
Not to be used with -r option.
.TP
.B \-o
.br
Overwrite pre-existing output files, if extant.
.TP
.B \-v
.br
Verbose mode.
.TP
.B \-?
.br
print allowable syntax, then exit(0).
.SH EXAMPLE
mkdir tmp_mail ; cd tmp_mail ; mailsplit mbox ; name_date *
.SH EXIT CODE
0 if no problems, else cumulative total of input files that could not be opened.
.SH BUGS
Goes wrong on zero size input files.
.br
If you set your inter article delimeter to ">From "
and text such as ">From my experience, "
occurs in the middle of a collation, this inevitably causes
an undesired split.
.\" Happened in one of the early nsc 32k news collections from daver.
.SH HOST OP SYSTEM
This utility runs on Unix BSD 4.2.
.SH COPYRIGHT
Program & Document Copyright Julian H. Stacey, Munich, 10th April 1991.
.so author.jhs
.SH SEE ALSO
mailname
.SH FILES
ms_pid_sequential
where pid is process identity number, & sequential increments from 0
upward.
.\ End of file