5 .TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 forw \- forward messages
14 .RB [ \-annotate " | " \-noannotate ]
17 .RB [ \-format " | " \-noformat ]
20 .RB [ \-inplace " | " \-noinplace ]
21 .RB [ \-mime " | " \-nomime ]
26 .RB [ \-nodraftfolder ]
32 .RB [ \-nowhatnowproc ]
33 .RB [ \-dashstuffing " | " \-nodashstuffing ]
50 [other\ switches\ for\
57 may be used to prepare a message containing other messages.
59 It constructs the new message from a forms (components) file, with a
60 body composed of the message(s) to be forwarded. An editor is invoked
63 and after editing is complete, the user is prompted
64 before the message is sent.
66 The default message form contains the following elements:
75 .RI \*(lq forwcomps \*(rq
76 exists in the user's nmh directory,
77 it will be used instead of this default form. You may also specify an
78 alternate forms file with the switch
82 If the draft already exists,
84 will ask you as to the disposition
85 of the draft. A reply of
89 leaving the draft intact;
91 will replace the existing draft with a blank skeleton; and
93 will display the draft.
97 switch is given, each message being forwarded will
98 be annotated with the lines:
107 where each address list contains as many lines as required. This
108 annotation will be done only if the message is sent directly from
110 If the message is not sent immediately from
114 may be used to re\-edit and send the constructed
115 message, but the annotations won't take place. Normally annotations
116 are done inplace in order to preserve any links to the message. You may
117 change this by using the
123 for a description of the
131 uses a forms (components) file to direct it how to
132 construct the beginning of the draft, it uses a message filter file to
133 direct it as to how each forwarded message should be formatted in the
134 body of the draft. The filter file for \fIforw\fR should be a standard
141 to filter (re\-format) the forwarded messages prior to being output to
142 the body of the draft.
150 specify which message filter file to use.
154 is specified (this is the default), then each forwarded
155 message is output into the draft exactly as it appears with no
161 is specified, then a default message filter file is used.
162 This default message filter should be adequate for most users.
164 .RI \*(lq mhl.forward \*(rq
174 .RI \*(lq mhl.forward \*(rq
175 exists in the user's nmh
176 directory, it will be used instead of this form. You may specify an
177 alternate message filter file with the switch
181 Each forwarded message is separated with an encapsulation delimiter.
182 By default, any dashes in the first column of the forwarded messages
183 will be prepended with `\-\ ' so that when received, the message is
184 suitable for bursting by
186 This follows the Internet RFC\-934 guidelines. You may use the flag
189 to suppress this form of quoting to the forwarded messages.
198 file, any commentary text is entered
199 before the forwarded messages. (A major win!)
201 To use the MIME rules for encapsulation, specify the
207 composition file. Note that
211 automatically, unless you
212 add this line to your
222 Otherwise, you must specifically give the command
230 prior to sending the draft.
240 draft folder facility. This is an advanced (and highly
241 useful) feature. Consult the
243 man page for more information.
248 switch indicates the editor to use for the
249 initial edit. Upon exiting from the editor,
256 available options. The invocation of this program can be inhibited
259 switch. (In truth of fact, it is
262 program which starts the initial edit. Hence,
264 will prevent any edit from occurring.)
268 switch is intended to be used by the Emacs mh-e interface to
270 and is only present if
272 was compiled with support for mh-e. It implies
273 .BR \-nowhatnowproc .
274 It causes a file <mh\-dir>/draft
275 to be created, containing the draft message that would normally be presented
276 to the user for editing.
277 No mail is actually sent. Note that this switch is not guaranteed to
278 be present or to have the same effects in future versions of
280 it is documented here only for completeness.
285 switch specifies the message to be forwarded as an
286 exact filename rather than as an
288 folder and message number. It is
289 intended to be used by the
295 The forwarded message is simply
296 copied verbatim into the draft; the processing implied by
302 switches is bypassed, and the usual leading and
303 trailing 'Forwarded Message' delimiters are not added.
304 The same caveats apply to this option as to the
316 switches implement a digest facility for
318 Specifying these switches enables and/or overloads the following escapes:
322 .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
323 .I Type Escape Returns Description
324 component digest string Argument to `\-digest'
325 function cur integer Argument to `\-volume'
326 function msg integer Argument to `\-issue'
331 .I "Advanced Features"
334 User's Manual for more information on making digests.
339 .ta \w'%etcdir%/ExtraBigFileName 'u
340 ^%etcdir%/forwcomps~^The standard message skeleton
341 ^or <mh\-dir>/forwcomps~^Rather than the standard skeleton
342 ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
343 ^or <mh\-dir>/digestcomps~^Rather than the standard skeleton
344 ^%etcdir%/mhl.forward~^The standard message filter
345 ^or <mh\-dir>/mhl.forward~^Rather than the standard filter
346 ^$HOME/\&.mh\(ruprofile~^The user profile
347 ^<mh\-dir>/draft~^The draft file
350 .SH "PROFILE COMPONENTS"
354 .ta \w'ExtraBigProfileName 'u
355 ^Path:~^To determine the user's nmh directory
356 ^Current\-Folder:~^To find the default current folder
357 ^Draft\-Folder:~^To find the default draft\-folder
358 ^Editor:~^To override the default editor
359 ^Msg\-Protect:~^To set mode when creating a new message (draft)
360 ^fileproc:~^Program to refile the message
361 ^mhlproc:~^Program to filter messages being forwarded
362 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
366 mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
367 .I "Proposed Standard for Message Encapsulation"
372 .RB ` +folder "' defaults to the current folder"
373 .RB ` msgs "' defaults to cur"
375 .RB ` \-nodraftfolder '
378 .RB ` \-dashstuffing '
383 If a folder is given, it will become the current folder.
384 The first message forwarded will become the current message.
395 it does not actually run the
398 Hence, if you define your own
408 is told to annotate the messages it forwards, it
409 doesn't actually annotate them until the draft is successfully sent.
416 it's possible to confuse
418 by re\-ordering the file (e.g. by using
421 before the message is successfully sent.
425 don't have this problem.