4 .TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 forw \- forward messages
13 .RB [ \-annotate " | " \-noannotate ]
16 .RB [ \-format " | " \-noformat ]
19 .RB [ \-inplace " | " \-noinplace ]
20 .RB [ \-mime " | " \-nomime ]
26 .RB [ \-nowhatnowproc ]
43 [other\ switches\ for\
50 may be used to prepare a message containing other messages.
52 It constructs the new message from a forms (components) file, with a
53 body composed of the message(s) to be forwarded. An editor is invoked
56 and after editing is complete, the user is prompted
57 before the message is sent.
59 The default message form contains the following elements:
68 .RI \*(lq forwcomps \*(rq
69 exists in the user's mmh directory,
70 it will be used instead of this default form. You may also specify an
71 alternate forms file with the switch
77 switch is given, each message being forwarded will
78 be annotated with the lines:
87 where each address list contains as many lines as required. This
88 annotation will be done only if the message is sent directly from
90 If the message is not sent immediately from
94 may be used to re\-edit and send the constructed
95 message, but the annotations won't take place. Normally annotations
96 are done inplace in order to preserve any links to the message. You may
97 change this by using the
103 for a description of the
111 uses a forms (components) file to direct it how to
112 construct the beginning of the draft, it uses a message filter file to
113 direct it as to how each forwarded message should be formatted in the
114 body of the draft. The filter file for \fIforw\fR should be a standard
121 to filter (re\-format) the forwarded messages prior to being output to
122 the body of the draft.
130 specify which message filter file to use.
134 is specified (this is the default), then each forwarded
135 message is output into the draft exactly as it appears with no
141 is specified, then a default message filter file is used.
142 This default message filter should be adequate for most users.
144 .RI \*(lq mhl.forward \*(rq
154 .RI \*(lq mhl.forward \*(rq
155 exists in the user's mmh
156 directory, it will be used instead of this form. You may specify an
157 alternate message filter file with the switch
161 Each forwarded message is separated with an encapsulation delimiter.
162 By default, any dashes in the first column of the forwarded messages
163 will be prepended with `\-\ ' so that when received, the message is
164 suitable for bursting by
166 This follows the Internet RFC\-934 guidelines.
175 file, any commentary text is entered
176 before the forwarded messages. (A major win!)
178 To use the MIME rules for encapsulation, specify the
182 to generate an attachment header field.
184 will care for everything else.
189 switch indicates the editor to use for the
190 initial edit. Upon exiting from the editor,
197 available options. The invocation of this program can be inhibited
200 switch. (In truth of fact, it is
203 program which starts the initial edit. Hence,
205 will prevent any edit from occurring.)
209 switch is intended to be used by the Emacs mh-e interface to
211 and is only present if
213 was compiled with support for mh-e. It implies
214 .BR \-nowhatnowproc .
215 It causes a file `draft' in the mail storage root
216 to be created, containing the draft message that would normally be presented
217 to the user for editing.
218 No mail is actually sent. Note that this switch is not guaranteed to
219 be present or to have the same effects in future versions of
221 it is documented here only for completeness.
226 switch specifies the message to be forwarded as an
227 exact filename rather than as an
229 folder and message number. It is
230 intended to be used by the
236 The forwarded message is simply
237 copied verbatim into the draft; the processing implied by
243 switches is bypassed, and the usual leading and
244 trailing 'Forwarded Message' delimiters are not added.
245 The same caveats apply to this option as to the
257 switches implement a digest facility for
259 Specifying these switches enables and/or overloads the following escapes:
263 .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
264 .I Type Escape Returns Description
265 component digest string Argument to `\-digest'
266 function cur integer Argument to `\-volume'
267 function msg integer Argument to `\-issue'
272 .I "Advanced Features"
275 User's Manual for more information on making digests.
280 .ta \w'%etcdir%/ExtraBigFileName 'u
281 ^%etcdir%/forwcomps~^The standard message skeleton
282 ^or $HOME/.mmh/forwcomps~^Rather than the standard skeleton
283 ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
284 ^or $HOME/.mmh/digestcomps~^Rather than the standard skeleton
285 ^%etcdir%/mhl.forward~^The standard message filter
286 ^or $HOME/.mmh/mhl.forward~^Rather than the standard filter
287 ^$HOME/.mmh/profile~^The user profile
288 ^+drafts~^The draft folder
291 .SH "PROFILE COMPONENTS"
295 .ta \w'ExtraBigProfileName 'u
296 ^Path:~^To determine the user's mail storage
297 ^Current\-Folder:~^To find the default current folder
298 ^Draft\-Folder:~^To set the default draft\-folder
299 ^Editor:~^To override the default editor
300 ^Msg\-Protect:~^To set mode when creating a new message (draft)
301 ^fileproc:~^Program to refile the message
302 ^mhlproc:~^Program to filter messages being forwarded
303 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
307 mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
308 .I "Proposed Standard for Message Encapsulation"
313 .RB ` +folder "' defaults to the current folder"
314 .RB ` msgs "' defaults to cur"
322 If a folder is given, it will become the current folder.
323 The first message forwarded will become the current message.
334 it does not actually run the
337 Hence, if you define your own
347 is told to annotate the messages it forwards, it
348 doesn't actually annotate them until the draft is successfully sent.
355 it's possible to confuse
357 by re\-ordering the file (e.g. by using
360 before the message is successfully sent.
364 don't have this problem.