5 .TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 repl \- reply to a message
13 .RB [ \-annotate " | " \-noannotate ]
14 .RB [ \-group " | " \-nogroup ]
19 .RB [ \-query " | " \-noquery ]
22 .RB [ \-format " | " \-noformat ]
25 .RB [ \-inplace " | " \-noinplace ]
26 .RB [ \-mime " | " \-nomime ]
35 .RB [ \-nodraftfolder ]
41 .RB [ \-nowhatnowproc ]
49 may be used to produce a reply to an existing message.
51 In its simplest form (with no arguments),
54 message\-form skeleton in reply to the current message in the current
55 folder, and invoke the whatnow shell.
57 In order to construct the message draft of the reply,
60 a reply template to guide its actions. A reply template is simply a
68 is given (it is on by default), then
70 will use the standard forms file \*(lqreplcomps\*(rq. This will construct
71 a draft message that is intended to be sent only to the author of the
72 message to which you are replying. If a file named \*(lqreplcomps\*(rq
75 directory, it will be used instead of this
78 The default reply template \*(lqreplcomps\*(rq will direct
80 to construct the reply message draft as follows:
84 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
85 cc: <To> and <cc> and <personal address>
86 Subject: Re: <Subject>
87 In\-Reply\-To: Your message of <Date>.
88 .ti +\w'In\-Reply\-To: 'u
94 where field names enclosed in angle brackets (<\ >) indicate the
95 contents of the named field from the message to which the reply is
98 By default, the \*(lqcc:\*(rq field is empty. You may selectively add
99 addresses to this default with the
102 switch. This switch takes an
104 .IR all / to / cc / me )
105 which specifies who gets added to the default
106 \*(lqcc:\*(rq list of the reply. You may give this switch multiple times (with
107 different arguments) if you wish to add multiple types of addresses.
114 standard forms file \*(lqreplgroupcomps\*(rq. This will construct a
115 draft message that is intended as a group or followup reply. If a file
116 named \*(lqreplgroupcomps\*(rq exists in the user's nmh directory, it
117 will be used instead of this default forms file.
119 The default group reply template \*(lqreplgroupcomps\*(rq will direct
121 to construct the reply message draft as follows:
125 To: <Mail\-Followup\-To>
126 Subject: Re: <Subject>
127 In\-Reply\-To: Message from <From> of <Date>.
128 .ti +\w'In\-Reply\-To: 'u
134 or if the field <Mail\-Followup\-To> is not available:
138 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
139 cc: <To> and <cc> and <personal address>
140 Subject: Re: <Subject>
141 In\-Reply\-To: Message from <From> of <Date>.
142 .ti +\w'In\-Reply\-To: 'u
148 By default, the \*(lqcc:\*(rq contains all the addresses shown. You may
149 selectively remove addresses from this default with the
153 This switch takes an argument (
154 .IR all / to / cc / me )
155 which specifies who gets removed
156 from the default \*(lqcc:\*(rq list of the reply. You may give this switch
157 multiple times (with different arguments) if you wish to remove multiple types
160 In any case, you may specify an alternate forms file with the switch
166 switch modifies the action of
170 interactively asking you if each address that normally would be placed in
171 the \*(lqTo:\*(rq and \*(lqcc:\*(rq list should actually be sent a copy.
172 This is useful for special\-purpose replies. Note that the position of
177 switches, like all other switches which take a
178 positive and negative form, is important.
180 Lines beginning with the fields \*(lqTo:\*(rq, \*(lqcc:\*(rq, and
181 \*(rqBcc:\*(rq will be standardized and have duplicate addresses removed.
187 formatting of these fields.
189 If the draft already exists,
191 will ask you as to the disposition
192 of the draft. A reply of
199 will replace the existing draft with a blank
202 will display the draft.
206 for a description of the
210 switches. Note that while in the editor, the message being replied
211 to is available through a link named \*(lq@\*(rq (assuming the default
213 In addition, the actual pathname of the message is
214 stored in the environment variable
217 the folder containing the message is stored in the environment variable
222 uses a forms file to direct it how to construct
223 the beginning of the draft, it uses a message filter file to direct
224 it as to how the message to which you are replying should be filtered
225 (re\-formatted) in the body of the draft. The filter file for
227 should be a standard form file for
233 to format the message to which you are replying.
242 which message filter file to use.
246 is given (it is the default), then the message
247 to which you are replying is not included in the body of the draft.
251 is given, then a default message filter file
252 is used. This default message filter should be adequate for most users.
254 .RI \*(lq mhl.reply \*(rq
263 which outputs each line of the body of the message prefaced with the
264 \*(lq>\*(rq character and a space.
267 .RI \*(lq mhl.reply \*(rq
271 it will be used instead of this form. You may specify an alternate
272 message filter file with the switch
276 Other reply filters are commonly used, such as:
281 body:nocomponent,compwidth=9,offset=9
285 which says to output a blank line and then the body of the message
286 being replied\-to, indented by one tab\-stop. Another popular format
291 message-id:nocomponent,\|nonewline,\\
292 formatfield=\*(lqIn message %{text},\ \*(rq
293 from:nocomponent,\|formatfield=\*(lq%(friendly{text}) writes:\*(rq
294 body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
298 This message filter file cites the Message-ID and author of the message
299 being replied\-to, and then outputs each line of the body prefaced with
300 the \*(lq>\*(rq character.
302 To use the MIME rules for encapsulation, specify the
314 automatically, unless you
315 add this line to your
323 Otherwise, you must specifically give the command
329 prior to sending the draft.
333 switch is given, the message being replied\-to will
334 be annotated with the lines
341 where the address list contains one line for each addressee.
342 The annotation will be done only if the message is sent directly from
344 If the message is not sent immediately from
346 .RB \*(lq "comp\ \-use" \*(rq
347 may be used to re\-edit and send the constructed
348 message, but the annotations won't take place. Normally annotations are
349 done inplace in order to preserve any links to the message. You may use
352 switch to change this.
357 switch can be used to automatically specify a folder
358 to receive Fcc:s. More than one folder, each preceded by
363 In addition to the standard
367 also recognizes the following additional
373 .ta \w'Escape 'u +\w'Returns 'u
374 .I Escape Returns Description
375 fcc string Any folders specified with `\-fcc\ folder'
379 To avoid reiteration,
381 strips any leading `Re: ' strings from
395 draft folder facility. This is an advanced (and highly
396 useful) feature. Consult the
401 Upon exiting from the editor,
407 for a discussion of available
408 options. The invocation of this program can be inhibited by using the
410 switch. (In truth of fact, it is the
412 program which starts the initial edit. Hence,
415 prevent any edit from occurring.)
419 switch is intended to be used by the Emacs mh-e interface
422 and is only present if
424 was compiled with support
426 .BR \-nowhatnowproc .
429 to be created, containing the draft message that would normally be presented
430 to the user for editing.
431 No mail is actually sent. Note that this switch is not guaranteed to
432 be present or to have the same effects in future versions of
434 it is documented here only for completeness.
439 switch specifies the message to be replied to as an
440 exact filename rather than as an
442 folder and message number. It is
443 intended to be used by the
447 The same caveats apply to this option as to the
454 .ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
455 ^%etcdir%/replcomps~^The standard reply template
456 ^or <mh\-dir>/replcomps~^Rather than the standard template
457 ^%etcdir%/replgroupcomps~^The standard `reply -group' template
458 ^or <mh\-dir>/replgroupcomps~^Rather than the standard template
459 ^%etcdir%/mhl.reply~^The standard message filter
460 ^or <mh\-dir>/mhl.reply~^Rather than the standard filter
461 ^$HOME/\&.mh\(ruprofile~^The user profile
462 ^<mh\-dir>/draft~^The draft file
465 .SH "PROFILE COMPONENTS"
469 .ta \w'ExtraBigProfileName 'u
470 ^Path:~^To determine the user's nmh directory
471 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
472 ^Current\-Folder:~^To find the default current folder
473 ^Draft\-Folder:~^To find the default draft\-folder
474 ^Editor:~^To override the default editor
475 ^Msg\-Protect:~^To set mode when creating a new message (draft)
476 ^fileproc:~^Program to refile the message
477 ^mhlproc:~^Program to filter message being replied\-to
478 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
482 mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
486 .RB ` +folder "' defaults to the current folder"
487 .RB ` msg "' defaults to cur"
489 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
491 .RB ` \-nodraftfolder '
496 .RB ` "\-width\ 72" '
500 If a folder is given, it will become the current folder. The message
501 replied\-to will become the current message.
504 If any addresses occur in the reply template, addresses in the template
505 that do not contain hosts are defaulted incorrectly. Instead of using
506 the localhost for the default,
508 uses the sender's host.
509 Moral of the story: if you're going to include addresses in a reply
510 template, include the host portion of the address.
515 switch is only used to do address-folding; other
516 headers are not line\-wrapped.
526 it does not actually run the
529 Hence, if you define your own
537 If your current working directory is not writable, the link named
538 \*(lq@\*(rq is not available.