-.TH FORW %manext1% "February 28, 2012" "%nmhversion%"
+.TH FORW %manext1% "October 10, 2016" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
.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 ]
.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
.IR number ]
[other\ switches\ for\
.BR forw ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Forw
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.
.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
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
.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
<mh\-dir>/forwcomps
Rather than the standard skeleton.
.TP
-%etcdir%/digestcomps
+%nmhetcdir%/digestcomps
The message skeleton if
.B \-digest
is given.
<mh\-dir>/digestcomps
Rather than the standard skeleton.
.TP
-^%etcdir%/mhl.forward
+^%nmhetcdir%/mhl.forward
The standard message filter.
.TP
<mh\-dir>/mhl.forward
Rather than the standard filter.
.TP
-^$HOME/.mh\-profile
+^$HOME/.mh_profile
The user's profile.
.PD
.SH "PROFILE COMPONENTS"
.PP
.I
Proposed Standard for Message Encapsulation
-(RFC\-934)
+(RFC 934)
.SH DEFAULTS
.PD 0
.TP 25
.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.