X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/b78be76b63889ea7973369a8fddc42ec5389726a..9f8418e870a70c264eda1598f2d470e5428c216d:/man/forw.man diff --git a/man/forw.man b/man/forw.man index 1e0c0c39..6534f050 100644 --- a/man/forw.man +++ b/man/forw.man @@ -1,4 +1,4 @@ -.TH FORW %manext1% "February 28, 2012" "%nmhversion%" +.TH FORW %manext1% "October 10, 2016" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -8,9 +8,11 @@ forw \- forward messages .HP 5 .na .B forw +.RB [ \-help ] +.RB [ \-version ] .RI [ +folder ] .RI [ msgs ] -.RB [ \-annotate " | " \-noannotate ] +.RB [ \-annotate " | " \-noannotate ] .RB [ \-form .IR formfile ] .RB [ \-format " | " \-noformat ] @@ -45,11 +47,11 @@ forw \- forward messages .RB [ \-build ] .RB [ \-file .IR msgfile ] -.RB [ \-version ] -.RB [ \-help ] .PP .HP 5 .B forw +.RB [ \-help ] +.RB [ \-version ] .RI [ +folder ] .RI [ msgs ] .RB [ \-digest @@ -60,8 +62,6 @@ forw \- forward messages .IR number ] [other\ switches\ for\ .BR forw ] -.RB [ \-version ] -.RB [ \-help ] .ad .SH DESCRIPTION .B Forw @@ -250,7 +250,7 @@ By default, any dashes in the first column of the forwarded messages will be prepended with `\-\ ' so that when received, the message is suitable for bursting by .BR burst . -This follows the Internet RFC\-934 guidelines. You may use the flag +This follows the Internet RFC 934 guidelines. You may use the flag .B \-nodashstuffing in order to suppress this form of quoting to the forwarded messages. @@ -267,26 +267,15 @@ before the forwarded messages. (A major win!) .PP To use the MIME rules for encapsulation, specify the .B \-mime -switch. This directs +switch. This directs .B forw to generate an .B mhbuild -composition file. Note that +composition file. Note that .B nmh will not invoke .B mhbuild -automatically, unless you -add this line to your -.I \&.mh\(ruprofile -file: -.PP -.RS 5 -.nf -automimeproc: 1 -.fi -.RE -.PP -Otherwise, you must specifically give the command +automatically; you must specifically give the command .PP .RS 5 .nf @@ -344,14 +333,10 @@ No mail is actually sent. The .B \-file .I msgfile -switch specifies the message to be forwarded as an +switch specifies the message to be forwarded as an exact filename rather than as an .B nmh -folder and message number. It is -intended to be used by the -.B msh -interface to -.BR nmh . +folder and message number. This switch implies .BR \-noannotate . The forwarded message is simply @@ -389,21 +374,25 @@ function msg integer Argument to `\-issue' .fi .RE .PP -Consult the -.I "Advanced Features" -section of the -.B nmh -User's Manual for more information on making digests. .SH FILES +.B forw +looks for format and filter files in multiple locations: absolute +pathnames are accessed directly, tilde expansion is done on usernames, +and files are searched for in the user's +.I Mail +directory as specified in their profile. If not found there, the directory +.RI \*(lq %nmhetcdir% \*(rq +is checked. +.PP .PD 0 .TP 25 -%etcdir%/forwcomps +%nmhetcdir%/forwcomps The standard message skeleton. .TP /forwcomps Rather than the standard skeleton. .TP -%etcdir%/digestcomps +%nmhetcdir%/digestcomps The message skeleton if .B \-digest is given. @@ -411,13 +400,13 @@ is given. /digestcomps Rather than the standard skeleton. .TP -^%etcdir%/mhl.forward +^%nmhetcdir%/mhl.forward The standard message filter. .TP /mhl.forward Rather than the standard filter. .TP -^$HOME/.mh\-profile +^$HOME/.mh_profile The user's profile. .PD .SH "PROFILE COMPONENTS" @@ -457,7 +446,7 @@ Program to ask the \*(lqWhat now?\*(rq questions. .PP .I Proposed Standard for Message Encapsulation -(RFC\-934) +(RFC 934) .SH DEFAULTS .PD 0 .TP 25 @@ -514,7 +503,7 @@ instead of .BR send , it's possible to confuse .B forw -by re\-ordering the file (e.g. by using +by re\-ordering the file (e.g.\& by using .RB \*(lq folder .BR \-pack \*(rq) before the message is successfully sent.