5 .TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 forw \- forward messages
13 .RB [ \-annotate " | " \-noannotate ]
16 .RB [ \-format " | " \-noformat ]
19 .RB [ \-inplace " | " \-noinplace ]
20 .RB [ \-mime " | " \-nomime ]
25 .RB [ \-nodraftfolder ]
31 .RB [ \-nowhatnowproc ]
32 .RB [ \-dashstuffing " | " \-nodashstuffing ]
49 [other\ switches\ for\
55 may be used to prepare a message containing other messages.
57 It constructs the new message from a forms (components) file, with a
58 body composed of the message(s) to be forwarded. An editor is invoked
61 and after editing is complete, the user is prompted
62 before the message is sent.
64 The default message form contains the following elements:
73 .RI \*(lq forwcomps \*(rq
74 exists in the user's nmh directory,
75 it will be used instead of this default form. You may also specify an
76 alternate forms file with the switch
80 If the draft already exists,
82 will ask you as to the disposition
83 of the draft. A reply of
87 leaving the draft intact;
89 will replace the existing draft with a blank skeleton; and
91 will display the draft.
95 switch is given, each message being forwarded will
96 be annotated with the lines:
101 where each address list contains as many lines as required. This
102 annotation will be done only if the message is sent directly from
104 If the message is not sent immediately from
108 may be used to re\-edit and send the constructed
109 message, but the annotations won't take place. Normally annotations
110 are done inplace in order to preserve any links to the message. You may
111 change this by using the
117 for a description of the
125 uses a forms (components) file to direct it how to
126 construct the beginning of the draft, it uses a message filter file to
127 direct it as to how each forwarded message should be formatted in the
128 body of the draft. The filter file for \fIforw\fR should be a standard
135 to filter (re\-format) the forwarded messages prior to being output to
136 the body of the draft.
144 specify which message filter file to use.
148 is specified (this is the default), then each forwarded
149 message is output into the draft exactly as it appears with no
155 is specified, then a default message filter file is used.
156 This default message filter should be adequate for most users.
158 .RI \*(lq mhl.forward \*(rq
168 .RI \*(lq mhl.forward \*(rq
169 exists in the user's nmh
170 directory, it will be used instead of this form. You may specify an
171 alternate message filter file with the switch
175 Each forwarded message is separated with an encapsulation delimiter.
176 By default, any dashes in the first column of the forwarded messages
177 will be prepended with `\-\ ' so that when received, the message is
178 suitable for bursting by
180 This follows the Internet RFC\-934 guidelines. You may use the flag
183 to suppress this form of quoting to the forwarded messages.
192 file, any commentary text is entered
193 before the forwarded messages. (A major win!)
195 To use the MIME rules for encapsulation, specify the
201 composition file. Note that
205 automatically, unless you
206 add this line to your
216 Otherwise, you must specifically give the command
224 prior to sending the draft.
234 draft folder facility. This is an advanced (and highly
235 useful) feature. Consult the
237 man page for more information.
242 switch indicates the editor to use for the
243 initial edit. Upon exiting from the editor,
250 available options. The invocation of this program can be inhibited
253 switch. (In truth of fact, it is
256 program which starts the initial edit. Hence,
258 will prevent any edit from occurring.)
262 switch is intended to be used by the Emacs mh-e interface to
264 and is only present if
266 was compiled with support for mh-e. It implies
267 .BR \-nowhatnowproc .
268 It causes a file <mh\-dir>/draft
269 to be created, containing the draft message that would normally be presented
270 to the user for editing.
271 No mail is actually sent. Note that this switch is not guaranteed to
272 be present or to have the same effects in future versions of
274 it is documented here only for completeness.
279 switch specifies the message to be forwarded as an
280 exact filename rather than as an
282 folder and message number. It is
283 intended to be used by the
289 The forwarded message is simply
290 copied verbatim into the draft; the processing implied by
296 switches is bypassed, and the usual leading and trailing
297 'Forwarded Message' delimiters are not added.
298 The same caveats apply to this option as to the
310 switches implement a digest facility for
312 Specifying these switches enables and/or overloads the following escapes:
316 .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
317 .I Type Escape Returns Description
318 component digest string Argument to `\-digest'
319 function cur integer Argument to `\-volume'
320 function msg integer Argument to `\-issue'
325 .I "Advanced Features"
328 User's Manual for more information on making digests.
333 .ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
334 ^%etcdir%/forwcomps~^The standard message skeleton
335 ^or <mh\-dir>/forwcomps~^Rather than the standard skeleton
336 ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
337 ^or <mh\-dir>/digestcomps~^Rather than the standard skeleton
338 ^%etcdir%/mhl.forward~^The standard message filter
339 ^or <mh\-dir>/mhl.forward~^Rather than the standard filter
340 ^$HOME/\&.mh\(ruprofile~^The user profile
341 ^<mh\-dir>/draft~^The draft file
343 .SH "PROFILE COMPONENTS"
347 .ta \w'ExtraBigProfileName 'u
348 ^Path:~^To determine the user's nmh directory
349 ^Current\-Folder:~^To find the default current folder
350 ^Draft\-Folder:~^To find the default draft\-folder
351 ^Editor:~^To override the default editor
352 ^Msg\-Protect:~^To set mode when creating a new message (draft)
353 ^fileproc:~^Program to refile the message
354 ^mhlproc:~^Program to filter messages being forwarded
355 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
358 mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
359 .I "Proposed Standard for Message Encapsulation"
364 .RB ` +folder "' defaults to the current folder"
365 .RB ` msgs "' defaults to cur"
367 .RB ` \-nodraftfolder '
370 .RB ` \-dashstuffing '
374 If a folder is given, it will become the current folder.
375 The first message forwarded will become the current message.
386 it does not actually run the
389 Hence, if you define your own
399 is told to annotate the messages it forwards, it
400 doesn't actually annotate them until the draft is successfully sent.
407 it's possible to confuse
409 by re\-ordering the file (e.g. by using
412 before the message is successfully sent.
416 don't have this problem.