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 line:
86 This annotation will be done only if the message is sent directly from
88 If the message is not sent immediately from
92 may be used to re\-edit and send the constructed
93 message, but the annotations won't take place. Normally annotations
94 are done inplace in order to preserve any links to the message. You may
95 change this by using the
101 for a description of the
109 uses a forms (components) file to direct it how to
110 construct the beginning of the draft, it uses a message filter file to
111 direct it as to how each forwarded message should be formatted in the
112 body of the draft. The filter file for \fIforw\fR should be a standard
119 to filter (re\-format) the forwarded messages prior to being output to
120 the body of the draft.
128 specify which message filter file to use.
132 is specified (this is the default), then each forwarded
133 message is output into the draft exactly as it appears with no
139 is specified, then a default message filter file is used.
140 This default message filter should be adequate for most users.
142 .RI \*(lq mhl.forward \*(rq
152 .RI \*(lq mhl.forward \*(rq
153 exists in the user's mmh
154 directory, it will be used instead of this form. You may specify an
155 alternate message filter file with the switch
159 Each forwarded message is separated with an encapsulation delimiter.
160 By default, any dashes in the first column of the forwarded messages
161 will be prepended with `\-\ ' so that when received, the message is
162 suitable for bursting by
164 This follows the Internet RFC\-934 guidelines.
173 file, any commentary text is entered
174 before the forwarded messages. (A major win!)
176 To use the MIME rules for encapsulation, specify the
180 to generate an attachment header field.
182 will care for everything else.
187 switch indicates the editor to use for the
188 initial edit. Upon exiting from the editor,
195 available options. The invocation of this program can be inhibited
198 switch. (In truth of fact, it is
201 program which starts the initial edit. Hence,
203 will prevent any edit from occurring.)
207 switch is intended to be used by the Emacs mh-e interface to
209 and is only present if
211 was compiled with support for mh-e. It implies
212 .BR \-nowhatnowproc .
213 It causes a file `draft' in the mail storage root
214 to be created, containing the draft message that would normally be presented
215 to the user for editing.
216 No mail is actually sent. Note that this switch is not guaranteed to
217 be present or to have the same effects in future versions of
219 it is documented here only for completeness.
224 switch specifies the message to be forwarded as an
225 exact filename rather than as an
227 folder and message number. It is
228 intended to be used by the
234 The forwarded message is simply
235 copied verbatim into the draft; the processing implied by
241 switches is bypassed, and the usual leading and
242 trailing 'Forwarded Message' delimiters are not added.
243 The same caveats apply to this option as to the
255 switches implement a digest facility for
257 Specifying these switches enables and/or overloads the following escapes:
261 .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
262 .I Type Escape Returns Description
263 component digest string Argument to `\-digest'
264 function cur integer Argument to `\-volume'
265 function msg integer Argument to `\-issue'
270 .I "Advanced Features"
273 User's Manual for more information on making digests.
278 .ta \w'%etcdir%/ExtraBigFileName 'u
279 ^%etcdir%/forwcomps~^The standard message skeleton
280 ^or $HOME/.mmh/forwcomps~^Rather than the standard skeleton
281 ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
282 ^or $HOME/.mmh/digestcomps~^Rather than the standard skeleton
283 ^%etcdir%/mhl.forward~^The standard message filter
284 ^or $HOME/.mmh/mhl.forward~^Rather than the standard filter
285 ^$HOME/.mmh/profile~^The user profile
286 ^+drafts~^The draft folder
289 .SH "PROFILE COMPONENTS"
293 .ta \w'ExtraBigProfileName 'u
294 ^Path:~^To determine the user's mail storage
295 ^Current\-Folder:~^To find the default current folder
296 ^Draft\-Folder:~^To set the default draft\-folder
297 ^Editor:~^To override the default editor
298 ^Msg\-Protect:~^To set mode when creating a new message (draft)
299 ^fileproc:~^Program to refile the message
300 ^mhlproc:~^Program to filter messages being forwarded
301 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
305 mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
306 .I "Proposed Standard for Message Encapsulation"
311 .RB ` +folder "' defaults to the current folder"
312 .RB ` msgs "' defaults to cur"
320 If a folder is given, it will become the current folder.
321 The first message forwarded will become the current message.
332 it does not actually run the
335 Hence, if you define your own
345 is told to annotate the messages it forwards, it
346 doesn't actually annotate them until the draft is successfully sent.
353 it's possible to confuse
355 by re\-ordering the file (e.g. by using
358 before the message is successfully sent.
362 don't have this problem.