4 .TH REPL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 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 ]
36 .RB [ \-nowhatnowproc ]
45 may be used to produce a reply to an existing message.
47 In its simplest form (with no arguments),
50 message\-form skeleton in reply to the current message in the current
51 folder, and invoke the whatnow shell.
53 In order to construct the message draft of the reply,
56 a reply template to guide its actions. A reply template is simply a
64 is given (it is on by default), then
66 will use the standard forms file \*(lqreplcomps\*(rq. This will construct
67 a draft message that is intended to be sent only to the author of the
68 message to which you are replying. If a file named \*(lqreplcomps\*(rq
71 directory, it will be used instead of this
74 The default reply template \*(lqreplcomps\*(rq will direct
76 to construct the reply message draft as follows:
80 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
81 cc: <To> and <cc> and <personal address>
82 Fcc: {fcc switch} or +outbox
83 Subject: Re: <Subject>
84 In\-Reply\-To: <Message\-Id>
85 References: <Message\-Id>
86 Comments: In\-Reply\-To <From> or <apparently from> or <Sender>
93 where field names enclosed in angle brackets (<\ >) indicate the
94 contents of the named field from the message to which the reply is
97 By default, the \*(lqcc:\*(rq field is empty. You may selectively add
98 addresses to this default with the
101 switch. This switch takes an
103 .IR all / to / cc / me )
104 which specifies who gets added to the default
105 \*(lqcc:\*(rq list of the reply. You may give this switch multiple times (with
106 different arguments) if you wish to add multiple types of addresses.
113 standard forms file \*(lqreplgroupcomps\*(rq. This will construct a
114 draft message that is intended as a group or followup reply. If a file
115 named \*(lqreplgroupcomps\*(rq exists in the user's mmh directory, it
116 will be used instead of this default forms file.
118 The default group reply template \*(lqreplgroupcomps\*(rq will direct
120 to construct the reply message draft as follows:
124 To: <Mail\-Followup\-To>
125 Subject: Re: <Subject>
126 In\-Reply\-To: Message from <From> of <Date>.
127 .ti +\w'In\-Reply\-To: 'u
133 or if the field <Mail\-Followup\-To> is not available:
137 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
138 cc: <To> and <cc> and <personal address>
139 Subject: Re: <Subject>
140 In\-Reply\-To: Message from <From> of <Date>.
141 .ti +\w'In\-Reply\-To: 'u
147 By default, the \*(lqcc:\*(rq contains all the addresses shown. You may
148 selectively remove addresses from this default with the
152 This switch takes an argument (
153 .IR all / to / cc / me )
154 which specifies who gets removed
155 from the default \*(lqcc:\*(rq list of the reply. You may give this switch
156 multiple times (with different arguments) if you wish to remove multiple types
159 In any case, you may specify an alternate forms file with the switch
165 switch modifies the action of
169 interactively asking you if each address that normally would be placed in
170 the \*(lqTo:\*(rq and \*(lqcc:\*(rq list should actually be sent a copy.
171 This is useful for special\-purpose replies. Note that the position of
176 switches, like all other switches which take a
177 positive and negative form, is important.
179 Lines beginning with the fields \*(lqTo:\*(rq, \*(lqcc:\*(rq, and
180 \*(rqBcc:\*(rq will be standardized and have duplicate addresses removed.
186 formatting of these fields.
190 for a description of the
194 switches. Note that while in the editor, the message being replied
195 to is available through a link named \*(lq@\*(rq (assuming the default
197 In addition, the actual pathname of the message is
198 stored in the environment variable
201 the folder containing the message is stored in the environment variable
206 uses a forms file to direct it how to construct
207 the beginning of the draft, it uses a message filter file to direct
208 it as to how the message to which you are replying should be filtered
209 (re\-formatted) in the body of the draft. The filter file for
211 should be a standard form file for
217 to format the message to which you are replying.
226 which message filter file to use.
230 is given (it is the default), then the message
231 to which you are replying is not included in the body of the draft.
235 is given, then a default message filter file
236 is used. This default message filter should be adequate for most users.
238 .RI \*(lq mhl.reply \*(rq
247 which outputs each line of the body of the message prefaced with the
248 \*(lq>\*(rq character and a space.
251 .RI \*(lq mhl.reply \*(rq
255 it will be used instead of this form. You may specify an alternate
256 message filter file with the switch
260 Other reply filters are commonly used, such as:
265 body:nocomponent,compwidth=9,offset=9
269 which says to output a blank line and then the body of the message
270 being replied\-to, indented by one tab\-stop. Another popular format
275 message-id:nocomponent,\|nonewline,\\
276 formatfield=\*(lqIn message %{text},\ \*(rq
277 from:nocomponent,\|formatfield=\*(lq%(decode(friendly{text})) writes:\*(rq
278 body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
282 This message filter file cites the Message-ID and author of the message
283 being replied\-to, and then outputs each line of the body prefaced with
284 the \*(lq>\*(rq character.
286 To use the MIME rules for encapsulation, specify the
298 automatically, unless you
299 add this line to your profile:
305 Otherwise, you must specifically give the command
311 prior to sending the draft.
315 switch is given, the message being replied\-to will
316 be annotated with the lines
323 where the address list contains one line for each addressee.
324 The annotation will be done only if the message is sent directly from
326 If the message is not sent immediately from
328 .RB \*(lq "comp\ \-use" \*(rq
329 may be used to re\-edit and send the constructed
330 message, but the annotations won't take place. Normally annotations are
331 done inplace in order to preserve any links to the message. You may use
334 switch to change this.
336 Although the default template specifies that a copy of the reply will be
342 switch is given it will override the default value.
343 More than one folder, each preceded by
348 In addition to the standard
352 also recognizes the following additional
358 .ta \w'Escape 'u +\w'Returns 'u
359 .I Escape Returns Description
360 fcc string Any folders specified with `\-fcc\ folder'
364 To avoid reiteration,
366 strips any leading `Re: ' strings from
376 Upon exiting from the editor,
382 for a discussion of available
383 options. The invocation of this program can be inhibited by using the
385 switch. (In truth of fact, it is the
387 program which starts the initial edit. Hence,
390 prevent any edit from occurring.)
394 switch is intended to be used by the Emacs mh-e interface
397 and is only present if
399 was compiled with support
401 .BR \-nowhatnowproc .
403 .I reply (in the mail storage root)
404 to be created, containing the draft message that would normally be presented
405 to the user for editing.
406 No mail is actually sent. Note that this switch is not guaranteed to
407 be present or to have the same effects in future versions of
409 it is documented here only for completeness.
414 switch specifies the message to be replied to as an
415 exact filename rather than as an
417 folder and message number. It is
418 intended to be used by the
422 The same caveats apply to this option as to the
429 .ta \w'%etcdir%/ExtraBigFileName 'u
430 ^%etcdir%/replcomps~^The standard reply template
431 ^or $HOME/.mmh/replcomps~^Rather than the standard template
432 ^%etcdir%/replgroupcomps~^The standard `reply -group' template
433 ^or $HOME/.mmh/replgroupcomps~^Rather than the standard template
434 ^%etcdir%/mhl.reply~^The standard message filter
435 ^or $HOME/.mmh/mhl.reply~^Rather than the standard filter
436 ^$HOME/.mmh/profile~^The user profile
437 ^+drafts~^The draft folder
440 .SH "PROFILE COMPONENTS"
444 .ta \w'ExtraBigProfileName 'u
445 ^Path:~^To determine the user's mail storage
446 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
447 ^Current\-Folder:~^To find the default current folder
448 ^Draft\-Folder:~^To set the default draft\-folder
449 ^Editor:~^To override the default editor
450 ^Msg\-Protect:~^To set mode when creating a new message (draft)
451 ^fileproc:~^Program to refile the message
452 ^mhlproc:~^Program to filter message being replied\-to
453 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
457 mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
461 .RB ` +folder "' defaults to the current folder"
462 .RB ` msg "' defaults to cur"
464 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
470 .RB ` "\-width\ 72" '
474 If a folder is given, it will become the current folder. The message
475 replied\-to will become the current message.
478 If any addresses occur in the reply template, addresses in the template
479 that do not contain hosts are defaulted incorrectly. Instead of using
480 the localhost for the default,
482 uses the sender's host.
483 Moral of the story: if you're going to include addresses in a reply
484 template, include the host portion of the address.
489 switch is only used to do address-folding; other
490 headers are not line\-wrapped.
500 it does not actually run the
503 Hence, if you define your own
511 If your current working directory is not writable, the link named
512 \*(lq@\*(rq is not available.
projects / mmh / blob