From bc98f50649fe2a742d2872e1d0f7cdc4b2951644 Mon Sep 17 00:00:00 2001 From: David Levine Date: Tue, 16 Oct 2012 13:23:43 -0500 Subject: [PATCH] Updated sendfiles(1) man page to reflect upcoming code update. --- man/mhmail.man | 2 +- man/sendfiles.man | 45 ++++++++++++++++++++++++++++++++++++--------- 2 files changed, 37 insertions(+), 10 deletions(-) diff --git a/man/mhmail.man b/man/mhmail.man index 1546d9e..6cf4f71 100644 --- a/man/mhmail.man +++ b/man/mhmail.man @@ -238,7 +238,7 @@ dist(1), inc(1), mh-format(5), post(8), send(1) .SH DEFAULTS .nf -.RB ` \-from "' defaults to sender's local mailbox (localmbox)" +.RB ` "\-from localmbox" ' .RB ` \-profile "' is enabled by default only with " \-attach .RB ` \-send ' .fi diff --git a/man/sendfiles.man b/man/sendfiles.man index 94f193e..7aeb901 100644 --- a/man/sendfiles.man +++ b/man/sendfiles.man @@ -8,11 +8,18 @@ sendfiles \- send multiple files via a MIME message .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 @@ -22,7 +29,7 @@ is used to send a collection 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 @@ -30,11 +37,30 @@ will archive the files and directories you name 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 +.BR 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 @@ -48,7 +74,7 @@ interpreted as the number of seconds to pause in between postings, 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. @@ -149,13 +175,14 @@ to perform the extraction. .fi .SH "SEE ALSO" -mhbuild(1), mhlist(1), mhshow(1), mhstore(1). +mhbuild(1), mh-format(5), mhlist(1), mhshow(1), mhstore(1) .I "Proposed Standard for Message Encapsulation" (RFC\-934) .SH DEFAULTS .nf -.RB ` \-noverbose ' +.RB ` "\-delay\ 0" ' +.RB ` "\-from localmbox" ' .fi .SH CONTEXT -- 1.7.10.4