+.TH SENDFILES %manext1% "October 16, 2012" "%nmhversion%"
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.TH SENDFILES %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
sendfiles \- send multiple files via a MIME message
.SH SYNOPSIS
-.HP
+.HP 5
.na
.B sendfiles
-.RB [ delay ]
-.I mailpath
+.RB [ \-bzip2 " | " \-compress " | " \-gzip " | " \-lzma " | " \-none " | " -zip ]
+.br
+.RB [ \-from
+.IR sender ]
+.RI [ \-delay ]
+.RB [ \-version ]
+.RB [ \-help ]
+.br
+.I recipient
.I subject
-.I file1
-.RI [ file2
+.I file/directory1
+.RI [ file/directory2
\&...]
.ad
.SH DESCRIPTION
of files and directories via electronic mail.
.PP
.RS 5
-sendfiles mailpath \*(lqsubject\*(rq files\0...
+sendfiles recipient \*(lqsubject\*(rq files\0...
.RE
.PP
.B sendfiles
with the
.B tar
command, and then mail the compressed
-archive to the \*(lqmailpath\*(rq with the given \*(lqsubject\*(rq.
+archive to the \*(lqrecipient\*(rq with the given \*(lqsubject\*(rq.
The archive
will be automatically split up into as many messages as necessary
in order to get past most mailers.
.PP
+The
+.B \-from
+switch can, and should, be used to specify the sender's mailbox (name
+and email address). Alternatively, the
+.B PERSON
+environment variable can be used for the same purpose.
+If neither is used,
+.B sendfiles
+will supply a \*(lqFrom:\*(rq header field using the sender's local
+mailbox, see
+.I localmbox
+in
+.IR mh-format (5).
+.PP
+The remaining command line switches select the compression program.
+One of these can be used to override the run-time determination of
+the compression program by
+.BR sendfiles .
+.PP
Sometimes you want
.B sendfiles
to pause after posting a partial
e.g.,
.PP
.RS 5
-sendfiles -30 mailpath \*(lqsubject\*(rq files\0...
+sendfiles -30 recipient \*(lqsubject\*(rq files\0...
.RE
.PP
will pause 30 seconds in between each posting.
can be invoked with
.B \-auto
to perform the extraction.
-
.SH FILES
.fc ^ ~
.nf
.ta \w'%etcdir%/ExtraBigFileName 'u
^$HOME/\&.mh\(ruprofile~^The user profile
.fi
-
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
^Path:~^To determine the user's nmh directory
^Current\-Folder:~^To find the default current folder
.fi
-
.SH "SEE ALSO"
-mhbuild(1), mhlist(1), mhshow(1), mhstore(1).
+.IR mhbuild (1),
+.IR mhlist (1),
+.IR mhshow (1),
+.IR mhstore (1),
+.IR mh-format (5)
+.PP
.I "Proposed Standard for Message Encapsulation"
(RFC\-934)
-
.SH DEFAULTS
.nf
-.RB ` \-noverbose '
+.RB ` "\-delay\ 0" '
+.RB ` "\-from localmbox" '
.fi
-
.SH CONTEXT
None