X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fforw.man1;h=0d5cd40d62dafd2c14590911335b65e49cf99bd5;hp=5f99bfaf58788453ecf2de460e04498772be2ff5;hb=dfa0332c4e6144699dedd5c9795219adc0f9c0d2;hpb=1b91fa72064a70b6ecf24c085cead38ff91fedb9 diff --git a/man/forw.man1 b/man/forw.man1 index 5f99bfa..0d5cd40 100644 --- a/man/forw.man1 +++ b/man/forw.man1 @@ -13,21 +13,13 @@ forw \- forward messages .RB [ \-annotate " | " \-noannotate ] .RB [ \-form .IR formfile ] -.RB [ \-format " | " \-noformat ] -.RB [ \-filter -.IR filterfile ] -.RB [ \-inplace " | " \-noinplace ] -.RB [ \-mime " | " \-nomime ] .RB [ \-editor .IR editor ] .RB [ \-noedit ] .RB [ \-whatnowproc .IR program ] .RB [ \-nowhatnowproc ] -.RB [ \-dashstuffing " | " \-nodashstuffing ] .RB [ \-build ] -.RB [ \-file -.IR msgfile ] .RB [ \-version ] .RB [ \-help ] .PP @@ -41,7 +33,7 @@ forw \- forward messages .IR number ] .RB [ \-volume .IR number ] -[other\ switches\ for\ +[other\ switches\ for .BR forw ] .RB [ \-version ] .RB [ \-help ] @@ -76,28 +68,23 @@ alternate forms file with the switch If the .B \-annotate switch is given, each message being forwarded will -be annotated with the lines: +be annotated with the line: .PP .RS 5 .nf Forwarded:\ date -Forwarded:\ addrs .fi .RE .PP -where each address list contains as many lines as required. This -annotation will be done only if the message is sent directly from +This annotation will be done only if the message is sent directly from .BR forw . If the message is not sent immediately from .BR forw , .RB \*(lq comp .BR \-use \*(rq may be used to re\-edit and send the constructed -message, but the annotations won't take place. Normally annotations -are done inplace in order to preserve any links to the message. You may -change this by using the -.B \-noinplace -switch. +message, but the annotations won't take place. Annotations +are always done inplace in order to preserve any links to the message. .PP See .BR comp (1) @@ -107,86 +94,20 @@ and .B \-noedit switches. .PP -Although -.B forw -uses a forms (components) file to direct it how to -construct the beginning of the draft, it uses a message filter file to -direct it as to how each forwarded message should be formatted in the -body of the draft. The filter file for \fIforw\fR should be a standard -form file for -.BR mhl , -as -.B forw -will invoke -.B mhl -to filter (re\-format) the forwarded messages prior to being output to -the body of the draft. -.PP -The switches -.BR \-noformat , -.BR \-format , -and -.B \-filter -.I filterfile -specify which message filter file to use. -.PP -If -.B \-noformat -is specified (this is the default), then each forwarded -message is output into the draft exactly as it appears with no -.B mhl -filtering. +.B Forw +generates an attachment header field for the messages to be forwarded. +.B Send +will care to encapsulate them using MIME rules. .PP -If -.B \-format -is specified, then a default message filter file is used. -This default message filter should be adequate for most users. -This default filter -.RI \*(lq mhl.forward \*(rq -is: +To send non-MIME forwarded messages, compose a new message (e.g. with +.B comp ) +and read in the output of: .PP .RS 5 -.nf -%mhl_forward% -.fi +mhl \-forwall \-form mhl.forward `mhpath +.I MSGS... ` .RE .PP -If a file named -.RI \*(lq mhl.forward \*(rq -exists in the user's mmh -directory, it will be used instead of this form. You may specify an -alternate message filter file with the switch -.B \-filter -.IR filterfile . -.PP -Each forwarded message is separated with an encapsulation delimiter. -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 -.B \-nodashstuffing -in order -to suppress this form of quoting to the forwarded messages. -.PP -For users of -.BR prompter , -by specifying -.BR prompter 's -.B \-prepend -switch in the -.I .mmh/profile -file, any commentary text is entered -before the forwarded messages. (A major win!) -.PP -To use the MIME rules for encapsulation, specify the -.B \-mime -switch. This directs -.B forw -to generate an attachment header field. -.B send -will care for everything else. -.PP The .B \-editor .I editor @@ -225,32 +146,6 @@ be present or to have the same effects in future versions of it is documented here only for completeness. .PP The -.B \-file -.I msgfile -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 . -This switch implies -.BR \-noannotate . -The forwarded message is simply -copied verbatim into the draft; the processing implied by -the -.BR \-filter , -.BR \-mime , -and -.B \-digest -switches is bypassed, and the usual leading and -trailing 'Forwarded Message' delimiters are not added. -The same caveats apply to this option as to the -.B \-build -switch. -.PP -The .B \-digest .IR list , .B \-issue @@ -286,8 +181,6 @@ User's Manual for more information on making digests. ^or $HOME/.mmh/forwcomps~^Rather than the standard skeleton ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given ^or $HOME/.mmh/digestcomps~^Rather than the standard skeleton -^%etcdir%/mhl.forward~^The standard message filter -^or $HOME/.mmh/mhl.forward~^Rather than the standard filter ^$HOME/.mmh/profile~^The user profile ^+drafts~^The draft folder .fi @@ -303,7 +196,6 @@ User's Manual for more information on making digests. ^Editor:~^To override the default editor ^Msg\-Protect:~^To set mode when creating a new message (draft) ^fileproc:~^Program to refile the message -^mhlproc:~^Program to filter messages being forwarded ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions .fi @@ -317,10 +209,6 @@ mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5), .RB ` +folder "' defaults to the current folder" .RB ` msgs "' defaults to cur" .RB ` \-noannotate ' -.RB ` \-noformat ' -.RB ` \-inplace ' -.RB ` \-dashstuffing ' -.RB ` \-nomime ' .fi .SH CONTEXT @@ -328,25 +216,6 @@ If a folder is given, it will become the current folder. The first message forwarded will become the current message. .SH BUGS -If -.I whatnowproc -is -.BR whatnow , -then -.B forw -uses a built\-in -.BR whatnow , -it does not actually run the -.B whatnow -program. -Hence, if you define your own -.IR whatnowproc , -don't call it -.B whatnow -since -.B forw -won't run it. -.PP When .B forw is told to annotate the messages it forwards, it