4 .TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 forw \- forward messages
13 .RB [ \-annotate " | " \-noannotate ]
16 .RB [ \-format " | " \-noformat ]
19 .RB [ \-mime " | " \-nomime ]
25 .RB [ \-nowhatnowproc ]
47 may be used to prepare a message containing other messages.
49 It constructs the new message from a forms (components) file, with a
50 body composed of the message(s) to be forwarded. An editor is invoked
53 and after editing is complete, the user is prompted
54 before the message is sent.
56 The default message form contains the following elements:
65 .RI \*(lq forwcomps \*(rq
66 exists in the user's mmh directory,
67 it will be used instead of this default form. You may also specify an
68 alternate forms file with the switch
74 switch is given, each message being forwarded will
75 be annotated with the line:
83 This annotation will be done only if the message is sent directly from
85 If the message is not sent immediately from
89 may be used to re\-edit and send the constructed
90 message, but the annotations won't take place. Annotations
91 are always done inplace in order to preserve any links to the message.
95 for a description of the
103 uses a forms (components) file to direct it how to
104 construct the beginning of the draft, it uses a message filter file to
105 direct it as to how each forwarded message should be formatted in the
106 body of the draft. The filter file for \fIforw\fR should be a standard
113 to filter (re\-format) the forwarded messages prior to being output to
114 the body of the draft.
122 specify which message filter file to use.
126 is specified (this is the default), then each forwarded
127 message is output into the draft exactly as it appears with no
133 is specified, then a default message filter file is used.
134 This default message filter should be adequate for most users.
136 .RI \*(lq mhl.forward \*(rq
146 .RI \*(lq mhl.forward \*(rq
147 exists in the user's mmh
148 directory, it will be used instead of this form. You may specify an
149 alternate message filter file with the switch
153 Each forwarded message is separated with an encapsulation delimiter.
154 By default, any dashes in the first column of the forwarded messages
155 will be prepended with `\-\ ' so that when received, the message is
156 suitable for bursting by
158 This follows the Internet RFC\-934 guidelines.
167 file, any commentary text is entered
168 before the forwarded messages. (A major win!)
170 To use the MIME rules for encapsulation, specify the
174 to generate an attachment header field.
176 will care for everything else.
181 switch indicates the editor to use for the
182 initial edit. Upon exiting from the editor,
189 available options. The invocation of this program can be inhibited
192 switch. (In truth of fact, it is
195 program which starts the initial edit. Hence,
197 will prevent any edit from occurring.)
201 switch is intended to be used by the Emacs mh-e interface to
203 and is only present if
205 was compiled with support for mh-e. It implies
206 .BR \-nowhatnowproc .
207 It causes a file `draft' in the mail storage root
208 to be created, containing the draft message that would normally be presented
209 to the user for editing.
210 No mail is actually sent. Note that this switch is not guaranteed to
211 be present or to have the same effects in future versions of
213 it is documented here only for completeness.
223 switches implement a digest facility for
225 Specifying these switches enables and/or overloads the following escapes:
229 .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
230 .I Type Escape Returns Description
231 component digest string Argument to `\-digest'
232 function cur integer Argument to `\-volume'
233 function msg integer Argument to `\-issue'
238 .I "Advanced Features"
241 User's Manual for more information on making digests.
246 .ta \w'%etcdir%/ExtraBigFileName 'u
247 ^%etcdir%/forwcomps~^The standard message skeleton
248 ^or $HOME/.mmh/forwcomps~^Rather than the standard skeleton
249 ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
250 ^or $HOME/.mmh/digestcomps~^Rather than the standard skeleton
251 ^%etcdir%/mhl.forward~^The standard message filter
252 ^or $HOME/.mmh/mhl.forward~^Rather than the standard filter
253 ^$HOME/.mmh/profile~^The user profile
254 ^+drafts~^The draft folder
257 .SH "PROFILE COMPONENTS"
261 .ta \w'ExtraBigProfileName 'u
262 ^Path:~^To determine the user's mail storage
263 ^Current\-Folder:~^To find the default current folder
264 ^Draft\-Folder:~^To set the default draft\-folder
265 ^Editor:~^To override the default editor
266 ^Msg\-Protect:~^To set mode when creating a new message (draft)
267 ^fileproc:~^Program to refile the message
268 ^mhlproc:~^Program to filter messages being forwarded
269 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
273 mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
274 .I "Proposed Standard for Message Encapsulation"
279 .RB ` +folder "' defaults to the current folder"
280 .RB ` msgs "' defaults to cur"
287 If a folder is given, it will become the current folder.
288 The first message forwarded will become the current message.
293 is told to annotate the messages it forwards, it
294 doesn't actually annotate them until the draft is successfully sent.
301 it's possible to confuse
303 by re\-ordering the file (e.g. by using
306 before the message is successfully sent.
310 don't have this problem.