X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fsendfiles.man;h=f8aec3fcaa96b435e0aabd0dca8c2929c5d70acb;hb=cbaaccc109298129f33411909d68e772d138bb1b;hp=0e4c385e0f4607d7458b86aa7fbdcb4b6c34a549;hpb=fc25a4f840747685117a482f9a0cf6296224ea1a;p=mmh diff --git a/man/sendfiles.man b/man/sendfiles.man index 0e4c385..f8aec3f 100644 --- a/man/sendfiles.man +++ b/man/sendfiles.man @@ -1,4 +1,4 @@ -.TH SENDFILES %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] +.TH SENDFILES %manext1% "October 21, 2012" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -8,16 +8,22 @@ sendfiles \- send multiple files via a MIME message .HP 5 .na .B sendfiles -.RB [ \-bzip2 " | " \-compress " | " \-gzip " | " \-lzma " | " \-none " | " -zip ] +.RB [ -compress +.IR bzip2 " | " compress " | " gzip " | " lzma " | " none " | " zip ] .br .RB [ \-from .IR sender ] -.RI [ \-delay ] +.RI [ "\-delay n" " | " \-n ] .RB [ \-version ] .RB [ \-help ] .br +.B \-to +.I recipient +.B \-subject +.IR subject " | " .I recipient .I subject +.br .I file/directory1 .RI [ file/directory2 \&...] @@ -29,7 +35,7 @@ is used to send a collection of files and directories via electronic mail. .PP .RS 5 -sendfiles recipient \*(lqsubject\*(rq files\0... +sendfiles -to recipient -subject \*(lqsubject\*(rq files\0... .RE .PP .B sendfiles @@ -43,6 +49,13 @@ will be automatically split up into as many messages as necessary in order to get past most mailers. .PP The +.B \-to +switch specifies the recipient. The +.B \-subject +switch specifies the subject. Alternatively, these two required values +can be provided without their corresponding switch names. +.PP +The .B \-from switch can, and should, be used to specify the sender's mailbox (name and email address). Alternatively, the @@ -54,30 +67,37 @@ will supply a \*(lqFrom:\*(rq header field using the sender's local mailbox, see .I localmbox in -.BR mh-format (5). +.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 +The +.B \-compress +command line switch can be used to override the run-time determination +of the compression program by .BR sendfiles . +.B \-compress +.I none +(alternatively, +.BR \-none ) +disables compression. .PP Sometimes you want .B sendfiles to pause after posting a partial message. This is usually the case when you are running .B sendmail -and expect to generate a lot of partial messages. If the first -argument given to -.B sendfiles -starts with a dash, then it is -interpreted as the number of seconds to pause in between postings, +and expect to generate a lot of partial messages. The +.B \-delay +switch specifies the number of seconds to pause in between postings, e.g., .PP .RS 5 -sendfiles -30 recipient \*(lqsubject\*(rq files\0... +sendfiles -delay 30 -to recipient -subject \*(lqsubject\*(rq files\0... .RE .PP -will pause 30 seconds in between each posting. +will pause 30 seconds in between each posting. An alternate form of +the switch with just the delay time, +.BR \-30 , +for example, is also supported. .PP .SS "Extracting the Received Files" When these messages are received, invoke @@ -157,14 +177,12 @@ to find out what will be extracted. Then 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 @@ -173,17 +191,19 @@ to perform the extraction. ^Path:~^To determine the user's nmh directory ^Current\-Folder:~^To find the default current folder .fi - .SH "SEE ALSO" -mhbuild(1), mh-format(5), 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 ` "\-delay\ 0" ' .RB ` "\-from localmbox" ' .fi - .SH CONTEXT None