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 ]
25 .RB [ \-nodraftfolder ]
43 .RB [ \-nowhatnowproc ]
44 .RB [ \-dashstuffing " | " \-nodashstuffing ]
61 [other\ switches\ for\
68 may be used to prepare a message containing other messages.
70 It constructs the new message from a forms (components) file, with a
71 body composed of the message(s) to be forwarded. An editor is invoked
74 and after editing is complete, the user is prompted
75 before the message is sent.
77 The default message template will direct
79 to construct the draft as follows:
83 From: {from switch} or <Local-Mailbox> or <username@hostname>
84 To: {to switch} or blank
85 Fcc: {fcc switch} or +outbox
86 Subject: {subject switch} or "{original subject} (fwd)"
92 .RI \*(lq forwcomps \*(rq
93 exists in the user's nmh directory,
94 it will be used instead of this default form. You may also specify an
95 alternate forms file with the switch
98 Forms are processed via the
102 for details. Components from the first forwarded message are available
103 as standard component escapes in the forms file.
105 In addition to the standard
107 escapes, the following
109 escapes are also supported:
113 .ta \w'nmh\-subject 'u +\w'Returns 'u
114 .I Escape Returns Description
115 fcc string Any folders specified with `\-fcc\ folder'
116 nmh\-from string Addresses specified with `\-from\ address'
117 nmh\-to string Addresses specified with `\-to\ address'
118 nmh\-cc string Addresses specified with `\-cc\ address'
119 nmh\-subject string Any text specified with `\-subject\ text'
123 By default the \*(lqTo:\*(rq and \*(lqcc:\*(rq fields are empty. You may
124 add addresses to these fields with the
130 switches. You may give these switches multiple times to add multiple
133 By default the \*(lqFrom:\*(rq field has either the value of the
135 profile entry a system default email address. This default can be overridden
139 switch. The default mailbox in the \*(lqFcc:\*(rq field is
141 This can be overridden by the
145 Any text you give to the
147 switch will be placed in the \*(lqSubject:\*(rq field in the draft.
149 If the draft already exists,
151 will ask you as to the disposition
152 of the draft. A reply of
156 leaving the draft intact;
158 will replace the existing draft with a blank skeleton; and
160 will display the draft.
164 switch is given, each message being forwarded will
165 be annotated with the lines:
174 where each address list contains as many lines as required. This
175 annotation will be done only if the message is sent directly from
177 If the message is not sent immediately from
181 may be used to re\-edit and send the constructed
182 message, but the annotations won't take place. Normally annotations
183 are done inplace in order to preserve any links to the message. You may
184 change this by using the
190 for a description of the
198 uses a forms (components) file to direct it how to
199 construct the beginning of the draft, it uses a message filter file to
200 direct it as to how each forwarded message should be formatted in the
201 body of the draft. The filter file for \fIforw\fR should be a standard
208 to filter (re\-format) the forwarded messages prior to being output to
209 the body of the draft.
217 specify which message filter file to use.
221 is specified (this is the default), then each forwarded
222 message is output into the draft exactly as it appears with no
228 is specified, then a default message filter file is used.
229 This default message filter should be adequate for most users.
231 .RI \*(lq mhl.forward \*(rq
241 .RI \*(lq mhl.forward \*(rq
242 exists in the user's nmh
243 directory, it will be used instead of this form. You may specify an
244 alternate message filter file with the switch
248 Each forwarded message is separated with an encapsulation delimiter.
249 By default, any dashes in the first column of the forwarded messages
250 will be prepended with `\-\ ' so that when received, the message is
251 suitable for bursting by
253 This follows the Internet RFC\-934 guidelines. You may use the flag
256 to suppress this form of quoting to the forwarded messages.
265 file, any commentary text is entered
266 before the forwarded messages. (A major win!)
268 To use the MIME rules for encapsulation, specify the
274 composition file. Note that
278 automatically, unless you
279 add this line to your
289 Otherwise, you must specifically give the command
297 prior to sending the draft.
307 draft folder facility. This is an advanced (and highly
308 useful) feature. Consult the
310 man page for more information.
315 switch indicates the editor to use for the
316 initial edit. Upon exiting from the editor,
323 available options. The invocation of this program can be inhibited
326 switch. (In truth of fact, it is
329 program which starts the initial edit. Hence,
331 will prevent any edit from occurring.)
335 switch is intended to be used by the Emacs mh-e interface to
338 .BR \-nowhatnowproc .
339 It causes a file <mh\-dir>/draft
340 to be created, containing the draft message that would normally be presented
341 to the user for editing.
342 No mail is actually sent.
347 switch specifies the message to be forwarded as an
348 exact filename rather than as an
350 folder and message number. It is
351 intended to be used by the
357 The forwarded message is simply
358 copied verbatim into the draft; the processing implied by
364 switches is bypassed, and the usual leading and
365 trailing 'Forwarded Message' delimiters are not added.
366 The same caveats apply to this option as to the
378 switches implement a digest facility for
380 Specifying these switches enables and/or overloads the following escapes:
384 .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
385 .I Type Escape Returns Description
386 component digest string Argument to `\-digest'
387 function cur integer Argument to `\-volume'
388 function msg integer Argument to `\-issue'
393 .I "Advanced Features"
396 User's Manual for more information on making digests.
401 .ta \w'%etcdir%/ExtraBigFileName 'u
402 ^%etcdir%/forwcomps~^The standard message skeleton
403 ^or <mh\-dir>/forwcomps~^Rather than the standard skeleton
404 ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
405 ^or <mh\-dir>/digestcomps~^Rather than the standard skeleton
406 ^%etcdir%/mhl.forward~^The standard message filter
407 ^or <mh\-dir>/mhl.forward~^Rather than the standard filter
408 ^$HOME/\&.mh\(ruprofile~^The user profile
409 ^<mh\-dir>/draft~^The draft file
412 .SH "PROFILE COMPONENTS"
416 .ta \w'ExtraBigProfileName 'u
417 ^Path:~^To determine the user's nmh directory
418 ^Current\-Folder:~^To find the default current folder
419 ^Draft\-Folder:~^To find the default draft\-folder
420 ^Editor:~^To override the default editor
421 ^Msg\-Protect:~^To set mode when creating a new message (draft)
422 ^fileproc:~^Program to refile the message
423 ^mhlproc:~^Program to filter messages being forwarded
424 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
428 mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
429 .I "Proposed Standard for Message Encapsulation"
434 .RB ` +folder "' defaults to the current folder"
435 .RB ` msgs "' defaults to cur"
437 .RB ` \-nodraftfolder '
440 .RB ` \-dashstuffing '
445 If a folder is given, it will become the current folder.
446 The first message forwarded will become the current message.
457 it does not actually run the
460 Hence, if you define your own
470 is told to annotate the messages it forwards, it
471 doesn't actually annotate them until the draft is successfully sent.
478 it's possible to confuse
480 by re\-ordering the file (e.g. by using
483 before the message is successfully sent.
487 don't have this problem.