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 ]
24 .RB " | " \-nofilter ]
25 .RB [ \-mime " | " \-nomime ]
38 may be used to produce a reply to an existing message.
40 In its simplest form (with no arguments),
43 message\-form skeleton in reply to the current message in the current
44 folder, and invoke the whatnow shell.
46 In order to construct the message draft of the reply,
49 a reply template to guide its actions. A reply template is simply a
57 is given (it is on by default), then
59 will use the standard forms file `replcomps'. This will construct
60 a draft message that is intended to be sent only to the author of the
61 message to which you are replying. If a file named `replcomps'
64 directory, it will be used instead of this
67 The default reply template `replcomps' will direct
69 to construct the reply message draft as follows:
73 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
74 Cc: <To> and <Cc> and <personal address>
76 Subject: Re: <Subject>
77 In\-Reply\-To: <Message\-Id>
78 References: <Message\-Id>
79 Comments: In\-Reply\-To <From> or <apparently from> or <Sender>
86 where field names enclosed in angle brackets (<\ >) indicate the
87 contents of the named field from the message to which the reply is
90 By default, the `Cc:' field is empty. You may selectively add
91 addresses to this default with the
94 switch. This switch takes an
96 .IR all / to / cc / me )
97 which specifies who gets added to the default
98 `Cc:' list of the reply. You may give this switch multiple times (with
99 different arguments) if you wish to add multiple types of addresses.
106 standard forms file `replgroupcomps'. This will construct a
107 draft message that is intended as a group or followup reply. If a file
108 named `replgroupcomps' exists in the user's mmh directory, it
109 will be used instead of this default forms file.
111 The default group reply template `replgroupcomps' will direct
113 to construct the reply message draft as follows:
117 To: <Mail\-Followup\-To>
118 Subject: Re: <Subject>
119 In\-Reply\-To: Message from <From> of <Date>.
120 .ti +\w'In\-Reply\-To: 'u
126 or if the field <Mail\-Followup\-To> is not available:
130 To: <Mail\-Reply\-To> or <Reply\-To> or <From>
131 Cc: <To> and <Cc> and <personal address>
132 Subject: Re: <Subject>
133 In\-Reply\-To: Message from <From> of <Date>.
134 .ti +\w'In\-Reply\-To: 'u
140 By default, the `Cc:' contains all the addresses shown. You may
141 selectively remove addresses from this default with the
145 This switch takes an argument (
146 .IR all / to / cc / me )
147 which specifies who gets removed
148 from the default `Cc:' list of the reply. You may give this switch
149 multiple times (with different arguments) if you wish to remove multiple types
152 In any case, you may specify an alternate forms file with the switch
158 switch modifies the action of
162 interactively asking you if each address that normally would be placed in
163 the `To:' and `Cc:' list should actually be sent a copy.
164 This is useful for special\-purpose replies. Note that the position of
169 switches, like all other switches which take a
170 positive and negative form, is important.
172 Lines beginning with the fields `To:', `Cc:', and
173 'Bcc:' will be standardized and have duplicate addresses removed.
174 In addition, these fields will be wrapped at a reasonable length.
178 for a description of the
180 switch. Note that while in the editor, the message being replied
181 to is available through a link named `@' (assuming the default
183 In addition, the actual pathname of the message is
184 stored in the environment variable
187 the folder containing the message is stored in the environment variable
192 uses a forms file to direct it how to construct
193 the beginning of the draft, it uses a message filter file to direct
194 it as to how the message to which you are replying should be filtered
195 (re\-formatted) in the body of the draft. The filter file for
197 should be a standard form file for
203 to format the message to which you are replying.
205 By default, the original message gets filtered
206 through a default message filter file and then included into the draft body
208 This should be adequate for most users.
219 which outputs each line of the body of the message prefaced with the
220 `>' character and a space.
226 it will be used instead of this form.
228 You may specify an alternate message filter file with the switch
232 Other reply filters are commonly used, such as:
237 body:nocomponent,compwidth=9,offset=9
241 which says to output a blank line and then the body of the message
242 being replied\-to, indented by one tab\-stop. Another popular format
247 message-id:nocomponent,\|nonewline,\\
248 formatfield=`In message %{text},\ '
249 from:nocomponent,\|formatfield=`%(decode(friendly{text})) writes:'
250 body:component=`>',\|overflowtext=`>',\|overflowoffset=0
254 This message filter file cites the Message-ID and author of the message
255 being replied\-to, and then outputs each line of the body prefaced with
260 is given, then the message
261 to which you are replying will not be formated and thus not included in
262 the body of the draft.
263 (It may be added as MIME attachment with
267 To MIME-attach the original message, specify the
270 Note: In mmh, the \-mime switch is unrelated to
271 the \-filter and \-nofilter switches.
272 It is therefore possible to have the original message quoted in the body
274 attached as MIME part.
275 However, using the \-mime switch is discouraged.
276 It may get removed in the future.
280 switch is given, the message being replied\-to will
281 be annotated with the line:
289 The annotation will be done only if the message is sent directly from
291 If the message is not sent immediately from
293 .RB ` "comp\ \-use" '
294 may be used to re\-edit and send the constructed
295 message, but the annotations won't take place. Annotations are always
296 done inplace in order to preserve any links to the message.
298 The default template specifies that a copy of the reply will be
302 To avoid reiteration,
304 strips any leading `Re: ' strings from
314 Upon exiting from the editor,
320 for a discussion of available
325 switch is intended to be used by the Emacs mh-e interface
329 .I reply (in the mail storage root)
330 to be created, containing the draft message that would normally be presented
331 to the user for editing.
335 No mail is actually sent.
340 switch specifies the message to be replied to as an
341 exact filename rather than as an
343 folder and message number. It is
344 intended to be used by the
348 The same caveats apply to this option as to the
355 .ta \w'%etcdir%/ExtraBigFileName 'u
356 ^%etcdir%/replcomps~^The standard reply template
357 ^or $HOME/.mmh/replcomps~^Rather than the standard template
358 ^%etcdir%/replgroupcomps~^The standard `reply -group' template
359 ^or $HOME/.mmh/replgroupcomps~^Rather than the standard template
360 ^%etcdir%/mhl.reply~^The standard message filter
361 ^or $HOME/.mmh/mhl.reply~^Rather than the standard filter
362 ^$HOME/.mmh/profile~^The user profile
363 ^+drafts~^The draft folder
366 .SH "PROFILE COMPONENTS"
370 .ta \w'ExtraBigProfileName 'u
371 ^Path:~^To determine the user's mail storage
372 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
373 ^Current\-Folder:~^To find the default current folder
374 ^Draft\-Folder:~^To set the default draft\-folder
375 ^Editor:~^To override the default editor
376 ^Msg\-Protect:~^To set mode when creating a new message (draft)
377 ^whatnowproc:~^Program to ask the `What now?' questions
381 mhbuild(1), comp(1), forw(1), send(1), whatnow(1), mh\-format(5)
385 .RB ` +folder "' defaults to the current folder"
386 .RB ` msg "' defaults to cur"
388 .RB ` "\-nocc\ all" "' with `\-nogroup', `\-cc\ all' with `\-group'"
395 If a folder is given, it will become the current folder. The message
396 replied\-to will become the current message.
399 If any addresses occur in the reply template, addresses in the template
400 that do not contain hosts are defaulted incorrectly. Instead of using
401 the localhost for the default,
403 uses the sender's host.
404 Moral of the story: if you're going to include addresses in a reply
405 template, include the host portion of the address.
407 If your current working directory is not writable, the link named
408 `@' is not available.
410 The quotation of the original message does not get transfer-decoded, yet.