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:
103 where each address list contains as many lines as required. This
104 annotation will be done only if the message is sent directly from
106 If the message is not sent immediately from
110 may be used to re\-edit and send the constructed
111 message, but the annotations won't take place. Normally annotations
112 are done inplace in order to preserve any links to the message. You may
113 change this by using the
119 for a description of the
127 uses a forms (components) file to direct it how to
128 construct the beginning of the draft, it uses a message filter file to
129 direct it as to how each forwarded message should be formatted in the
130 body of the draft. The filter file for \fIforw\fR should be a standard
137 to filter (re\-format) the forwarded messages prior to being output to
138 the body of the draft.
146 specify which message filter file to use.
150 is specified (this is the default), then each forwarded
151 message is output into the draft exactly as it appears with no
157 is specified, then a default message filter file is used.
158 This default message filter should be adequate for most users.
160 .RI \*(lq mhl.forward \*(rq
170 .RI \*(lq mhl.forward \*(rq
171 exists in the user's nmh
172 directory, it will be used instead of this form. You may specify an
173 alternate message filter file with the switch
177 Each forwarded message is separated with an encapsulation delimiter.
178 By default, any dashes in the first column of the forwarded messages
179 will be prepended with `\-\ ' so that when received, the message is
180 suitable for bursting by
182 This follows the Internet RFC\-934 guidelines. You may use the flag
185 to suppress this form of quoting to the forwarded messages.
194 file, any commentary text is entered
195 before the forwarded messages. (A major win!)
197 To use the MIME rules for encapsulation, specify the
203 composition file. Note that
207 automatically, unless you
208 add this line to your
218 Otherwise, you must specifically give the command
226 prior to sending the draft.
236 draft folder facility. This is an advanced (and highly
237 useful) feature. Consult the
239 man page for more information.
244 switch indicates the editor to use for the
245 initial edit. Upon exiting from the editor,
252 available options. The invocation of this program can be inhibited
255 switch. (In truth of fact, it is
258 program which starts the initial edit. Hence,
260 will prevent any edit from occurring.)
264 switch is intended to be used by the Emacs mh-e interface to
266 and is only present if
268 was compiled with support for mh-e. It implies
269 .BR \-nowhatnowproc .
270 It causes a file <mh\-dir>/draft
271 to be created, containing the draft message that would normally be presented
272 to the user for editing.
273 No mail is actually sent. Note that this switch is not guaranteed to
274 be present or to have the same effects in future versions of
276 it is documented here only for completeness.
281 switch specifies the message to be forwarded as an
282 exact filename rather than as an
284 folder and message number. It is
285 intended to be used by the
291 The forwarded message is simply
292 copied verbatim into the draft; the processing implied by
298 switches is bypassed, and the usual leading and trailing
299 'Forwarded Message' delimiters are not added.
300 The same caveats apply to this option as to the
312 switches implement a digest facility for
314 Specifying these switches enables and/or overloads the following escapes:
318 .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
319 .I Type Escape Returns Description
320 component digest string Argument to `\-digest'
321 function cur integer Argument to `\-volume'
322 function msg integer Argument to `\-issue'
327 .I "Advanced Features"
330 User's Manual for more information on making digests.
335 .ta \w'%etcdir%/ExtraBigFileName 'u
336 ^%etcdir%/forwcomps~^The standard message skeleton
337 ^or <mh\-dir>/forwcomps~^Rather than the standard skeleton
338 ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
339 ^or <mh\-dir>/digestcomps~^Rather than the standard skeleton
340 ^%etcdir%/mhl.forward~^The standard message filter
341 ^or <mh\-dir>/mhl.forward~^Rather than the standard filter
342 ^$HOME/\&.mh\(ruprofile~^The user profile
343 ^<mh\-dir>/draft~^The draft file
346 .SH "PROFILE COMPONENTS"
350 .ta \w'ExtraBigProfileName 'u
351 ^Path:~^To determine the user's nmh directory
352 ^Current\-Folder:~^To find the default current folder
353 ^Draft\-Folder:~^To find the default draft\-folder
354 ^Editor:~^To override the default editor
355 ^Msg\-Protect:~^To set mode when creating a new message (draft)
356 ^fileproc:~^Program to refile the message
357 ^mhlproc:~^Program to filter messages being forwarded
358 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
362 mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
363 .I "Proposed Standard for Message Encapsulation"
368 .RB ` +folder "' defaults to the current folder"
369 .RB ` msgs "' defaults to cur"
371 .RB ` \-nodraftfolder '
374 .RB ` \-dashstuffing '
379 If a folder is given, it will become the current folder.
380 The first message forwarded will become the current message.
391 it does not actually run the
394 Hence, if you define your own
404 is told to annotate the messages it forwards, it
405 doesn't actually annotate them until the draft is successfully sent.
412 it's possible to confuse
414 by re\-ordering the file (e.g. by using
417 before the message is successfully sent.
421 don't have this problem.