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 Fcc: {fcc switch} or +outbox
89 Subject: Re: <Subject>
90 In\-Reply\-To: <Message\-Id>
91 References: <Message\-Id>
92 Comments: In\-Reply\-To <From> or <apparently from> or <Sender>
99 where field names enclosed in angle brackets (<\ >) indicate the
100 contents of the named field from the message to which the reply is
103 By default, the \*(lqcc:\*(rq field is empty. You may selectively add
104 addresses to this default with the
107 switch. This switch takes an
109 .IR all / to / cc / me )
110 which specifies who gets added to the default
111 \*(lqcc:\*(rq list of the reply. You may give this switch multiple times (with
112 different arguments) if you wish to add multiple types of addresses.
119 standard forms file \*(lqreplgroupcomps\*(rq. This will construct a
120 draft message that is intended as a group or followup reply. If a file
121 named \*(lqreplgroupcomps\*(rq exists in the user's nmh directory, it
122 will be used instead of this default forms file.
124 The default group reply template \*(lqreplgroupcomps\*(rq will direct
126 to construct the reply message draft as follows:
130 To: <Mail\-Followup\-To>
131 Subject: Re: <Subject>
132 In\-Reply\-To: Message from <From> of <Date>.
133 .ti +\w'In\-Reply\-To: 'u
139 or if the field <Mail\-Followup\-To> is not available:
143 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
144 cc: <To> and <cc> and <personal address>
145 Subject: Re: <Subject>
146 In\-Reply\-To: Message from <From> of <Date>.
147 .ti +\w'In\-Reply\-To: 'u
153 By default, the \*(lqcc:\*(rq contains all the addresses shown. You may
154 selectively remove addresses from this default with the
158 This switch takes an argument (
159 .IR all / to / cc / me )
160 which specifies who gets removed
161 from the default \*(lqcc:\*(rq list of the reply. You may give this switch
162 multiple times (with different arguments) if you wish to remove multiple types
165 In any case, you may specify an alternate forms file with the switch
171 switch modifies the action of
175 interactively asking you if each address that normally would be placed in
176 the \*(lqTo:\*(rq and \*(lqcc:\*(rq list should actually be sent a copy.
177 This is useful for special\-purpose replies. Note that the position of
182 switches, like all other switches which take a
183 positive and negative form, is important.
185 Lines beginning with the fields \*(lqTo:\*(rq, \*(lqcc:\*(rq, and
186 \*(rqBcc:\*(rq will be standardized and have duplicate addresses removed.
192 formatting of these fields.
194 If the draft already exists,
196 will ask you as to the disposition
197 of the draft. A reply of
204 will replace the existing draft with a blank
207 will display the draft.
211 for a description of the
215 switches. Note that while in the editor, the message being replied
216 to is available through a link named \*(lq@\*(rq (assuming the default
218 In addition, the actual pathname of the message is
219 stored in the environment variable
222 the folder containing the message is stored in the environment variable
227 uses a forms file to direct it how to construct
228 the beginning of the draft, it uses a message filter file to direct
229 it as to how the message to which you are replying should be filtered
230 (re\-formatted) in the body of the draft. The filter file for
232 should be a standard form file for
238 to format the message to which you are replying.
247 which message filter file to use.
251 is given (it is the default), then the message
252 to which you are replying is not included in the body of the draft.
256 is given, then a default message filter file
257 is used. This default message filter should be adequate for most users.
259 .RI \*(lq mhl.reply \*(rq
268 which outputs each line of the body of the message prefaced with the
269 \*(lq>\*(rq character and a space.
272 .RI \*(lq mhl.reply \*(rq
276 it will be used instead of this form. You may specify an alternate
277 message filter file with the switch
281 Other reply filters are commonly used, such as:
286 body:nocomponent,compwidth=9,offset=9
290 which says to output a blank line and then the body of the message
291 being replied\-to, indented by one tab\-stop. Another popular format
296 message-id:nocomponent,\|nonewline,\\
297 formatfield=\*(lqIn message %{text},\ \*(rq
298 from:nocomponent,\|formatfield=\*(lq%(friendly{text}) writes:\*(rq
299 body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
303 This message filter file cites the Message-ID and author of the message
304 being replied\-to, and then outputs each line of the body prefaced with
305 the \*(lq>\*(rq character.
307 To use the MIME rules for encapsulation, specify the
319 automatically, unless you
320 add this line to your
328 Otherwise, you must specifically give the command
334 prior to sending the draft.
338 switch is given, the message being replied\-to will
339 be annotated with the lines
346 where the address list contains one line for each addressee.
347 The annotation will be done only if the message is sent directly from
349 If the message is not sent immediately from
351 .RB \*(lq "comp\ \-use" \*(rq
352 may be used to re\-edit and send the constructed
353 message, but the annotations won't take place. Normally annotations are
354 done inplace in order to preserve any links to the message. You may use
357 switch to change this.
359 Although the default template specifies that a copy of the reply will be
365 switch is given it will override the default value.
366 More than one folder, each preceded by
371 In addition to the standard
375 also recognizes the following additional
381 .ta \w'Escape 'u +\w'Returns 'u
382 .I Escape Returns Description
383 fcc string Any folders specified with `\-fcc\ folder'
387 To avoid reiteration,
389 strips any leading `Re: ' strings from
403 draft folder facility. This is an advanced (and highly
404 useful) feature. Consult the
409 Upon exiting from the editor,
415 for a discussion of available
416 options. The invocation of this program can be inhibited by using the
418 switch. (In truth of fact, it is the
420 program which starts the initial edit. Hence,
423 prevent any edit from occurring.)
427 switch is intended to be used by the Emacs mh-e interface
430 and is only present if
432 was compiled with support
434 .BR \-nowhatnowproc .
437 to be created, containing the draft message that would normally be presented
438 to the user for editing.
439 No mail is actually sent. Note that this switch is not guaranteed to
440 be present or to have the same effects in future versions of
442 it is documented here only for completeness.
447 switch specifies the message to be replied to as an
448 exact filename rather than as an
450 folder and message number. It is
451 intended to be used by the
455 The same caveats apply to this option as to the
462 .ta \w'%etcdir%/ExtraBigFileName 'u
463 ^%etcdir%/replcomps~^The standard reply template
464 ^or <mh\-dir>/replcomps~^Rather than the standard template
465 ^%etcdir%/replgroupcomps~^The standard `reply -group' template
466 ^or <mh\-dir>/replgroupcomps~^Rather than the standard template
467 ^%etcdir%/mhl.reply~^The standard message filter
468 ^or <mh\-dir>/mhl.reply~^Rather than the standard filter
469 ^$HOME/\&.mh\(ruprofile~^The user profile
470 ^<mh\-dir>/draft~^The draft file
473 .SH "PROFILE COMPONENTS"
477 .ta \w'ExtraBigProfileName 'u
478 ^Path:~^To determine the user's nmh directory
479 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
480 ^Current\-Folder:~^To find the default current folder
481 ^Draft\-Folder:~^To find the default draft\-folder
482 ^Editor:~^To override the default editor
483 ^Msg\-Protect:~^To set mode when creating a new message (draft)
484 ^fileproc:~^Program to refile the message
485 ^mhlproc:~^Program to filter message being replied\-to
486 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
490 mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
494 .RB ` +folder "' defaults to the current folder"
495 .RB ` msg "' defaults to cur"
497 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
499 .RB ` \-nodraftfolder '
504 .RB ` "\-width\ 72" '
508 If a folder is given, it will become the current folder. The message
509 replied\-to will become the current message.
512 If any addresses occur in the reply template, addresses in the template
513 that do not contain hosts are defaulted incorrectly. Instead of using
514 the localhost for the default,
516 uses the sender's host.
517 Moral of the story: if you're going to include addresses in a reply
518 template, include the host portion of the address.
523 switch is only used to do address-folding; other
524 headers are not line\-wrapped.
534 it does not actually run the
537 Hence, if you define your own
545 If your current working directory is not writable, the link named
546 \*(lq@\*(rq is not available.