5 .TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 repl \- reply to a message
14 .RB [ \-annotate " | " \-noannotate ]
15 .RB [ \-group " | " \-nogroup ]
20 .RB [ \-query " | " \-noquery ]
23 .RB [ \-format " | " \-noformat ]
26 .RB [ \-inplace " | " \-noinplace ]
27 .RB [ \-mime " | " \-nomime ]
36 .RB [ \-nodraftfolder ]
42 .RB [ \-nowhatnowproc ]
51 may be used to produce a reply to an existing message.
53 In its simplest form (with no arguments),
56 message\-form skeleton in reply to the current message in the current
57 folder, and invoke the whatnow shell.
59 In order to construct the message draft of the reply,
62 a reply template to guide its actions. A reply template is simply a
70 is given (it is on by default), then
72 will use the standard forms file \*(lqreplcomps\*(rq. This will construct
73 a draft message that is intended to be sent only to the author of the
74 message to which you are replying. If a file named \*(lqreplcomps\*(rq
77 directory, it will be used instead of this
80 The default reply template \*(lqreplcomps\*(rq will direct
82 to construct the reply message draft as follows:
86 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
87 cc: <To> and <cc> and <personal address>
88 Subject: Re: <Subject>
89 In\-Reply\-To: Your message of <Date>.
90 .ti +\w'In\-Reply\-To: 'u
96 where field names enclosed in angle brackets (<\ >) indicate the
97 contents of the named field from the message to which the reply is
100 By default, the \*(lqcc:\*(rq field is empty. You may selectively add
101 addresses to this default with the
104 switch. This switch takes an
106 .IR all / to / cc / me )
107 which specifies who gets added to the default
108 \*(lqcc:\*(rq list of the reply. You may give this switch multiple times (with
109 different arguments) if you wish to add multiple types of addresses.
116 standard forms file \*(lqreplgroupcomps\*(rq. This will construct a
117 draft message that is intended as a group or followup reply. If a file
118 named \*(lqreplgroupcomps\*(rq exists in the user's nmh directory, it
119 will be used instead of this default forms file.
121 The default group reply template \*(lqreplgroupcomps\*(rq will direct
123 to construct the reply message draft as follows:
127 To: <Mail\-Followup\-To>
128 Subject: Re: <Subject>
129 In\-Reply\-To: Message from <From> of <Date>.
130 .ti +\w'In\-Reply\-To: 'u
136 or if the field <Mail\-Followup\-To> is not available:
140 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
141 cc: <To> and <cc> and <personal address>
142 Subject: Re: <Subject>
143 In\-Reply\-To: Message from <From> of <Date>.
144 .ti +\w'In\-Reply\-To: 'u
150 By default, the \*(lqcc:\*(rq contains all the addresses shown. You may
151 selectively remove addresses from this default with the
155 This switch takes an argument (
156 .IR all / to / cc / me )
157 which specifies who gets removed
158 from the default \*(lqcc:\*(rq list of the reply. You may give this switch
159 multiple times (with different arguments) if you wish to remove multiple types
162 In any case, you may specify an alternate forms file with the switch
168 switch modifies the action of
172 interactively asking you if each address that normally would be placed in
173 the \*(lqTo:\*(rq and \*(lqcc:\*(rq list should actually be sent a copy.
174 This is useful for special\-purpose replies. Note that the position of
179 switches, like all other switches which take a
180 positive and negative form, is important.
182 Lines beginning with the fields \*(lqTo:\*(rq, \*(lqcc:\*(rq, and
183 \*(rqBcc:\*(rq will be standardized and have duplicate addresses removed.
189 formatting of these fields.
191 If the draft already exists,
193 will ask you as to the disposition
194 of the draft. A reply of
201 will replace the existing draft with a blank
204 will display the draft.
208 for a description of the
212 switches. Note that while in the editor, the message being replied
213 to is available through a link named \*(lq@\*(rq (assuming the default
215 In addition, the actual pathname of the message is
216 stored in the environment variable
219 the folder containing the message is stored in the environment variable
224 uses a forms file to direct it how to construct
225 the beginning of the draft, it uses a message filter file to direct
226 it as to how the message to which you are replying should be filtered
227 (re\-formatted) in the body of the draft. The filter file for
229 should be a standard form file for
235 to format the message to which you are replying.
244 which message filter file to use.
248 is given (it is the default), then the message
249 to which you are replying is not included in the body of the draft.
253 is given, then a default message filter file
254 is used. This default message filter should be adequate for most users.
256 .RI \*(lq mhl.reply \*(rq
265 which outputs each line of the body of the message prefaced with the
266 \*(lq>\*(rq character and a space.
269 .RI \*(lq mhl.reply \*(rq
273 it will be used instead of this form. You may specify an alternate
274 message filter file with the switch
278 Other reply filters are commonly used, such as:
283 body:nocomponent,compwidth=9,offset=9
287 which says to output a blank line and then the body of the message
288 being replied\-to, indented by one tab\-stop. Another popular format
293 message-id:nocomponent,\|nonewline,\\
294 formatfield=\*(lqIn message %{text},\ \*(rq
295 from:nocomponent,\|formatfield=\*(lq%(friendly{text}) writes:\*(rq
296 body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
300 This message filter file cites the Message-ID and author of the message
301 being replied\-to, and then outputs each line of the body prefaced with
302 the \*(lq>\*(rq character.
304 To use the MIME rules for encapsulation, specify the
316 automatically, unless you
317 add this line to your
325 Otherwise, you must specifically give the command
331 prior to sending the draft.
335 switch is given, the message being replied\-to will
336 be annotated with the lines
343 where the address list contains one line for each addressee.
344 The annotation will be done only if the message is sent directly from
346 If the message is not sent immediately from
348 .RB \*(lq "comp\ \-use" \*(rq
349 may be used to re\-edit and send the constructed
350 message, but the annotations won't take place. Normally annotations are
351 done inplace in order to preserve any links to the message. You may use
354 switch to change this.
359 switch can be used to automatically specify a folder
360 to receive Fcc:s. More than one folder, each preceded by
365 In addition to the standard
369 also recognizes the following additional
375 .ta \w'Escape 'u +\w'Returns 'u
376 .I Escape Returns Description
377 fcc string Any folders specified with `\-fcc\ folder'
381 To avoid reiteration,
383 strips any leading `Re: ' strings from
397 draft folder facility. This is an advanced (and highly
398 useful) feature. Consult the
403 Upon exiting from the editor,
409 for a discussion of available
410 options. The invocation of this program can be inhibited by using the
412 switch. (In truth of fact, it is the
414 program which starts the initial edit. Hence,
417 prevent any edit from occurring.)
421 switch is intended to be used by the Emacs mh-e interface
424 and is only present if
426 was compiled with support
428 .BR \-nowhatnowproc .
431 to be created, containing the draft message that would normally be presented
432 to the user for editing.
433 No mail is actually sent. Note that this switch is not guaranteed to
434 be present or to have the same effects in future versions of
436 it is documented here only for completeness.
441 switch specifies the message to be replied to as an
442 exact filename rather than as an
444 folder and message number. It is
445 intended to be used by the
449 The same caveats apply to this option as to the
456 .ta \w'%etcdir%/ExtraBigFileName 'u
457 ^%etcdir%/replcomps~^The standard reply template
458 ^or <mh\-dir>/replcomps~^Rather than the standard template
459 ^%etcdir%/replgroupcomps~^The standard `reply -group' template
460 ^or <mh\-dir>/replgroupcomps~^Rather than the standard template
461 ^%etcdir%/mhl.reply~^The standard message filter
462 ^or <mh\-dir>/mhl.reply~^Rather than the standard filter
463 ^$HOME/\&.mh\(ruprofile~^The user profile
464 ^<mh\-dir>/draft~^The draft file
467 .SH "PROFILE COMPONENTS"
471 .ta \w'ExtraBigProfileName 'u
472 ^Path:~^To determine the user's nmh directory
473 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
474 ^Current\-Folder:~^To find the default current folder
475 ^Draft\-Folder:~^To find the default draft\-folder
476 ^Editor:~^To override the default editor
477 ^Msg\-Protect:~^To set mode when creating a new message (draft)
478 ^fileproc:~^Program to refile the message
479 ^mhlproc:~^Program to filter message being replied\-to
480 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
484 mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
488 .RB ` +folder "' defaults to the current folder"
489 .RB ` msg "' defaults to cur"
491 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
493 .RB ` \-nodraftfolder '
498 .RB ` "\-width\ 72" '
502 If a folder is given, it will become the current folder. The message
503 replied\-to will become the current message.
506 If any addresses occur in the reply template, addresses in the template
507 that do not contain hosts are defaulted incorrectly. Instead of using
508 the localhost for the default,
510 uses the sender's host.
511 Moral of the story: if you're going to include addresses in a reply
512 template, include the host portion of the address.
517 switch is only used to do address-folding; other
518 headers are not line\-wrapped.
528 it does not actually run the
531 Hence, if you define your own
539 If your current working directory is not writable, the link named
540 \*(lq@\*(rq is not available.