.\"
.\" %nmhwarning%
-.\" $Id$
.\"
.TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
forw \- forward messages
.SH SYNOPSIS
.HP 5
+.na
.B forw
.RI [ +folder ]
.RI [ msgs ]
-.RB [ \-annotate " | " \-noannotate ]
+.RB [ \-annotate " | " \-noannotate ]
.RB [ \-form
.IR formfile ]
.RB [ \-format " | " \-noformat ]
.IR filterfile ]
.RB [ \-inplace " | " \-noinplace ]
.RB [ \-mime " | " \-nomime ]
-.RB [ \-draftfolder
-.IR +folder ]
-.RB [ \-draftmessage
-.IR msg ]
-.RB [ \-nodraftfolder ]
.RB [ \-editor
.IR editor ]
.RB [ \-noedit ]
.IR number ]
.RB [ \-volume
.IR number ]
-[other\ switches\ for\
+[other\ switches\ for\
.BR forw ]
.RB [ \-version ]
.RB [ \-help ]
+.ad
.SH DESCRIPTION
.B Forw
may be used to prepare a message containing other messages.
.PP
If a file named
.RI \*(lq forwcomps \*(rq
-exists in the user's nmh directory,
+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
.B \-form
.IR formfile .
.PP
-If the draft already exists,
-.B forw
-will ask you as to the disposition
-of the draft. A reply of
-.B quit
-will abort
-.BR forw ,
-leaving the draft intact;
-.B replace
-will replace the existing draft with a blank skeleton; and
-.B list
-will display the draft.
-.PP
If the
.B \-annotate
switch is given, each message being forwarded will
be annotated with the lines:
-
- Forwarded:\ date
- Forwarded:\ addrs
-
+.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
.BR forw .
.PP
If a file named
.RI \*(lq mhl.forward \*(rq
-exists in the user's nmh
+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
.BR prompter 's
.B \-prepend
switch in the
-.I \&.mh\(ruprofile
+.I .mmh/profile
file, any commentary text is entered
before the forwarded messages. (A major win!)
.PP
.B mhbuild
automatically, unless you
add this line to your
-.I \&.mh\(ruprofile
+.I .mmh/profile
file:
.PP
.RS 5
.PP
prior to sending the draft.
.PP
-The
-.B \-draftfolder
-.I +folder
-and
-.B \-draftmessage
-.I msg
-switches invoke the
-.B nmh
-draft folder facility. This is an advanced (and highly
-useful) feature. Consult the
+Consult the
.BR mh-draft (5)
man page for more information.
.PP
.B nmh
was compiled with support for mh-e. It implies
.BR \-nowhatnowproc .
-It causes a file <mh\-dir>/draft
+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
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
+folder and message number. It is
intended to be used by the
.B msh
interface to
-.BR nmh .
+.BR nmh .
This switch implies
.BR \-noannotate .
The forwarded message is simply
.BR \-mime ,
and
.B \-digest
-switches is bypassed, and the usual leading and trailing
-'Forwarded Message' delimiters are not added.
+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.
.SH FILES
.fc ^ ~
.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
+.ta \w'%etcdir%/ExtraBigFileName 'u
^%etcdir%/forwcomps~^The standard message skeleton
-^or <mh\-dir>/forwcomps~^Rather than the standard skeleton
+^or $HOME/.mmh/forwcomps~^Rather than the standard skeleton
^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
-^or <mh\-dir>/digestcomps~^Rather than the standard skeleton
+^or $HOME/.mmh/digestcomps~^Rather than the standard skeleton
^%etcdir%/mhl.forward~^The standard message filter
-^or <mh\-dir>/mhl.forward~^Rather than the standard filter
-^$HOME/\&.mh\(ruprofile~^The user profile
-^<mh\-dir>/draft~^The draft file
+^or $HOME/.mmh/mhl.forward~^Rather than the standard filter
+^$HOME/.mmh/profile~^The user profile
+^+drafts~^The draft folder
+.fi
.SH "PROFILE COMPONENTS"
.fc ^ ~
.nf
.ta 2.4i
.ta \w'ExtraBigProfileName 'u
-^Path:~^To determine the user's nmh directory
+^Path:~^To determine the user's mail storage
^Current\-Folder:~^To find the default current folder
-^Draft\-Folder:~^To find the default draft\-folder
+^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
+.fi
.SH "SEE ALSO"
mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
.I "Proposed Standard for Message Encapsulation"
(RFC\-934)
-.SH "DEFAULTS"
+.SH DEFAULTS
.nf
.RB ` +folder "' defaults to the current folder"
.RB ` msgs "' defaults to cur"
.RB ` \-noannotate '
-.RB ` \-nodraftfolder '
.RB ` \-noformat '
.RB ` \-inplace '
.RB ` \-dashstuffing '
.RB ` \-nomime '
+.fi
.SH CONTEXT
If a folder is given, it will become the current folder.