.RB [ \-annotate " | " \-noannotate ]
.RB [ \-form
.IR formfile ]
-.RB [ \-format " | " \-noformat ]
-.RB [ \-filter
-.IR filterfile ]
-.RB [ \-mime " | " \-nomime ]
.RB [ \-editor
.IR editor ]
-.RB [ \-noedit ]
.RB [ \-whatnowproc
.IR program ]
-.RB [ \-nowhatnowproc ]
.RB [ \-build ]
-.RB [ \-file
-.IR msgfile ]
-.RB [ \-version ]
+.RB [ \-Version ]
.RB [ \-help ]
.PP
.HP 5
.IR number ]
[other\ switches\ for
.BR forw ]
-.RB [ \-version ]
+.RB [ \-Version ]
.RB [ \-help ]
.ad
.SH DESCRIPTION
.RE
.PP
If a file named
-.RI \*(lq forwcomps \*(rq
+.RI ` forwcomps '
exists in the user's mmh directory,
it will be used instead of this default form. You may also specify an
alternate forms file with the switch
.BR forw .
If the message is not sent immediately from
.BR forw ,
-.RB \*(lq comp
-.BR \-use \*(rq
+.RB ` comp
+.BR \-use '
may be used to re\-edit and send the constructed
message, but the annotations won't take place. Annotations
are always done inplace in order to preserve any links to the message.
.BR comp (1)
for a description of the
.B \-editor
-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.
+switch.
.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
program. See
.BR whatnow (1)
for a discussion of
-available options. The invocation of this program can be inhibited
-by using the
-.B \-nowhatnowproc
-switch. (In truth of fact, it is
-the
-.I whatnow
-program which starts the initial edit. Hence,
-.B \-nowhatnowproc
-will prevent any edit from occurring.)
+available options.
.PP
The
.B \-build
switch is intended to be used by the Emacs mh-e interface to
-.BR nmh ,
-and is only present if
-.B nmh
-was compiled with support for mh-e. It implies
-.BR \-nowhatnowproc .
+.BR nmh .
It causes a file `draft' in the mail storage root
to be created, containing the draft message that would normally be presented
to the user for editing.
-No mail is actually sent. Note that this switch is not guaranteed to
-be present or to have the same effects in future versions of
-.BR nmh :
-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.
+No
+.B whatnow
+program is invoked.
+No mail is actually sent.
.PP
The
.B \-digest
.RS 5
.nf
.ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
-.I Type Escape Returns Description
+.I "Type Escape Returns Description
component digest string Argument to `\-digest'
function cur integer Argument to `\-volume'
function msg integer Argument to `\-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
^Draft\-Folder:~^To set the default draft\-folder
^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
+^whatnowproc:~^Program to ask the `What now?' questions
.fi
.SH "SEE ALSO"
.RB ` +folder "' defaults to the current folder"
.RB ` msgs "' defaults to cur"
.RB ` \-noannotate '
-.RB ` \-noformat '
-.RB ` \-nomime '
.fi
.SH CONTEXT
it's possible to confuse
.B forw
by re\-ordering the file (e.g. by using
-.RB \*(lq folder
-.BR \-pack \*(rq)
+.RB ` folder
+.BR \-pack ')
before the message is successfully sent.
.B Dist
and