.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 ]
.IR program ]
.RB [ \-nowhatnowproc ]
.RB [ \-build ]
-.RB [ \-file
-.IR msgfile ]
.RB [ \-version ]
.RB [ \-help ]
.PP
.IR number ]
.RB [ \-volume
.IR number ]
-[other\ switches\ for\
+[other\ switches\ for
.BR forw ]
.RB [ \-version ]
.RB [ \-help ]
.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)
.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.
-.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
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
^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
^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
.RB ` +folder "' defaults to the current folder"
.RB ` msgs "' defaults to cur"
.RB ` \-noannotate '
-.RB ` \-noformat '
-.RB ` \-inplace '
-.RB ` \-nomime '
.fi
.SH CONTEXT
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