4 .TH FORW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 forw \- forward messages
13 .RB [ \-annotate " | " \-noannotate ]
16 .RB [ \-format " | " \-noformat ]
19 .RB [ \-mime " | " \-nomime ]
25 .RB [ \-nowhatnowproc ]
49 may be used to prepare a message containing other messages.
51 It constructs the new message from a forms (components) file, with a
52 body composed of the message(s) to be forwarded. An editor is invoked
55 and after editing is complete, the user is prompted
56 before the message is sent.
58 The default message form contains the following elements:
67 .RI \*(lq forwcomps \*(rq
68 exists in the user's mmh directory,
69 it will be used instead of this default form. You may also specify an
70 alternate forms file with the switch
76 switch is given, each message being forwarded will
77 be annotated with the line:
85 This annotation will be done only if the message is sent directly from
87 If the message is not sent immediately from
91 may be used to re\-edit and send the constructed
92 message, but the annotations won't take place. Annotations
93 are always done inplace in order to preserve any links to the message.
97 for a description of the
105 uses a forms (components) file to direct it how to
106 construct the beginning of the draft, it uses a message filter file to
107 direct it as to how each forwarded message should be formatted in the
108 body of the draft. The filter file for \fIforw\fR should be a standard
115 to filter (re\-format) the forwarded messages prior to being output to
116 the body of the draft.
124 specify which message filter file to use.
128 is specified (this is the default), then each forwarded
129 message is output into the draft exactly as it appears with no
135 is specified, then a default message filter file is used.
136 This default message filter should be adequate for most users.
138 .RI \*(lq mhl.forward \*(rq
148 .RI \*(lq mhl.forward \*(rq
149 exists in the user's mmh
150 directory, it will be used instead of this form. You may specify an
151 alternate message filter file with the switch
155 Each forwarded message is separated with an encapsulation delimiter.
156 By default, any dashes in the first column of the forwarded messages
157 will be prepended with `\-\ ' so that when received, the message is
158 suitable for bursting by
160 This follows the Internet RFC\-934 guidelines.
169 file, any commentary text is entered
170 before the forwarded messages. (A major win!)
172 To use the MIME rules for encapsulation, specify the
176 to generate an attachment header field.
178 will care for everything else.
183 switch indicates the editor to use for the
184 initial edit. Upon exiting from the editor,
191 available options. The invocation of this program can be inhibited
194 switch. (In truth of fact, it is
197 program which starts the initial edit. Hence,
199 will prevent any edit from occurring.)
203 switch is intended to be used by the Emacs mh-e interface to
205 and is only present if
207 was compiled with support for mh-e. It implies
208 .BR \-nowhatnowproc .
209 It causes a file `draft' in the mail storage root
210 to be created, containing the draft message that would normally be presented
211 to the user for editing.
212 No mail is actually sent. Note that this switch is not guaranteed to
213 be present or to have the same effects in future versions of
215 it is documented here only for completeness.
220 switch specifies the message to be forwarded as an
221 exact filename rather than as an
223 folder and message number. It is
224 intended to be used by the
230 The forwarded message is simply
231 copied verbatim into the draft; the processing implied by
237 switches is bypassed, and the usual leading and
238 trailing 'Forwarded Message' delimiters are not added.
239 The same caveats apply to this option as to the
251 switches implement a digest facility for
253 Specifying these switches enables and/or overloads the following escapes:
257 .ta \w'Component 'u +\w'Escape 'u +\w'Returns 'u
258 .I Type Escape Returns Description
259 component digest string Argument to `\-digest'
260 function cur integer Argument to `\-volume'
261 function msg integer Argument to `\-issue'
266 .I "Advanced Features"
269 User's Manual for more information on making digests.
274 .ta \w'%etcdir%/ExtraBigFileName 'u
275 ^%etcdir%/forwcomps~^The standard message skeleton
276 ^or $HOME/.mmh/forwcomps~^Rather than the standard skeleton
277 ^%etcdir%/digestcomps~^The message skeleton if `\-digest' is given
278 ^or $HOME/.mmh/digestcomps~^Rather than the standard skeleton
279 ^%etcdir%/mhl.forward~^The standard message filter
280 ^or $HOME/.mmh/mhl.forward~^Rather than the standard filter
281 ^$HOME/.mmh/profile~^The user profile
282 ^+drafts~^The draft folder
285 .SH "PROFILE COMPONENTS"
289 .ta \w'ExtraBigProfileName 'u
290 ^Path:~^To determine the user's mail storage
291 ^Current\-Folder:~^To find the default current folder
292 ^Draft\-Folder:~^To set the default draft\-folder
293 ^Editor:~^To override the default editor
294 ^Msg\-Protect:~^To set mode when creating a new message (draft)
295 ^fileproc:~^Program to refile the message
296 ^mhlproc:~^Program to filter messages being forwarded
297 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
301 mhbuild(1), comp(1), repl(1), send(1), whatnow(1), mh\-format(5),
302 .I "Proposed Standard for Message Encapsulation"
307 .RB ` +folder "' defaults to the current folder"
308 .RB ` msgs "' defaults to cur"
315 If a folder is given, it will become the current folder.
316 The first message forwarded will become the current message.
321 is told to annotate the messages it forwards, it
322 doesn't actually annotate them until the draft is successfully sent.
329 it's possible to confuse
331 by re\-ordering the file (e.g. by using
334 before the message is successfully sent.
338 don't have this problem.