8 date 96.02.09.00.25.00; author jromine; state Exp;
13 date 96.02.08.19.01.16; author jromine; state Exp;
18 date 95.12.06.21.07.03; author jromine; state Exp;
23 date 92.11.18.01.18.54; author jromine; state Exp;
28 date 90.12.17.16.00.35; author mh; state Exp;
33 date 90.04.05.15.09.27; author sources; state Exp;
38 date 90.03.22.11.31.46; author sources; state Exp;
43 date 90.03.20.23.32.13; author sources; state Exp;
48 date 90.03.20.19.42.28; author sources; state Exp;
53 date 90.03.20.17.36.42; author sources; state Exp;
58 date 90.03.18.20.49.33; author sources; state Exp;
63 date 90.03.16.14.22.06; author sources; state Exp;
68 date 90.03.16.14.17.36; author sources; state Exp;
73 date 90.03.16.14.07.20; author sources; state Exp;
88 .\" @@(#)$Id: repl.rf,v 1.13 1996/02/08 19:01:16 jromine Exp jromine $
91 repl \- reply to a message
95 \%[\-annotate] \%[\-noannotate]
96 \%[\-cc\ all/to/cc/me] \%[\-nocc\ all/to/cc/me]
97 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
98 \%[\-editor\ editor] \%[\-noedit]
100 \%[\-filter\ filterfile]
102 .\" \%[\-format] \%[\-noformat]
103 \%[\-inplace] \%[\-noinplace]
105 \%[\-mime] \%[\-nomime]
107 \%[\-query] \%[\-noquery]
109 \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
112 \fIRepl\fR aids a user in producing a reply to an existing
114 \fIRepl\fR uses a reply template to guide its actions when constructing
115 the message draft of the reply.
116 In its simplest form (with no arguments),
118 a message\-form skeleton in reply to the current message in the
119 current folder, and invoke the whatnow shell.
120 The default reply template will direct \fIrepl\fR to construct
121 the composed message as follows:
125 To: <Reply\-To> or <From>
126 cc: <cc>, <To>, and yourself
127 Subject: Re: <Subject>
128 In\-reply\-to: Your message of <Date>.
129 .ti +\w'In\-reply\-to: 'u
134 where field names enclosed in angle brackets (<\ >) indicate the
135 contents of the named field from the message to which the reply
136 is being made. A reply template is simply a format file.
137 See \fImh\-format\fR\0(5) for the details.
139 The `\-cc\ type' switch takes an argument which specifies
140 who gets placed on the \*(lqcc:\*(rq list of the reply.
141 The `\-query' switch modifies the action of `\-cc\ type' switch by
142 interactively asking you if each address that normally would be placed
143 in the \*(lqTo:\*(rq and \*(lqcc:\*(rq list should actually be sent a copy.
144 (This is useful for special\-purpose replies.)
145 Note that the position of the `\-cc' and `\-nocc' switches,
146 like all other switches which take a positive and negative form,
149 .\" --this seems to not be used anymore. /JLR
150 .\" With the `\-format' switch one can indicate if Internet\-style
151 .\" formatting should be used (or not be used with `\-noformat').
152 .\" If present (the default), then
153 Lines beginning with the fields
154 \*(lqTo:\*(rq, \*(lqcc:\*(rq, and \*(rqBcc:\*(rq
155 will be standardized and have duplicate addresses removed.
156 In addition, the `\-width\ columns' switch will guide \fIrepl\fR's formatting
159 If the file named \*(lqreplcomps\*(rq exists in the user's MH directory,
160 it will be used instead of the default form.
161 In either case, the file specified by `\-form\ formfile' will be used
164 If the draft already exists,
165 \fIrepl\fR will ask you as to the disposition of the draft.
166 A reply of \fBquit\fR will abort \fIrepl\fR, leaving the draft intact;
167 \fBreplace\fR will replace the existing draft with a blank skeleton;
168 and \fBlist\fR will display the draft.
170 See \fIcomp\fR\0(1) for a description of the `\-editor' and `\-noedit'
172 Note that while in the editor,
173 the message being replied to is available through a link named \*(lq@@\*(rq
174 (assuming the default \fIwhatnowproc\fR\0).
175 In addition, the actual pathname of the message is stored in the envariable
177 and the pathname of the folder containing the message is stored in the
178 envariable \fB$mhfolder\fR.
180 Although \fIrepl\fR uses the `\-form\ formfile' switch to direct it how
181 to construct the beginning of the draft, the `\-filter\ filterfile'
182 switch directs \fIrepl\fR as to how the message being replied\-to
183 should be formatted in the body of the draft.
184 If `\-filter' is not specified,
185 then the message being replied\-to is not included in the body of the
187 If `\-filter\ filterfile' is specified,
188 then the message being replied\-to is filtered (re\-formatted) prior to
189 being output to the body of the draft.
190 The filter file for \fIrepl\fR should be a standard form file for
191 \fImhl\fR, as \fIrepl\fR will invoke \fImhl\fR to format the message
193 There is no default message filter (`\-filter' must be followed by a
195 A filter file that is commonly used is:
200 body:nocomponent,compwidth=9,offset=9
204 which says to output a blank line and then the body of the message
205 being replied\-to, indented by one tab\-stop.
206 Another format popular on USENET is:
211 message-id:nocomponent,\|nonewline,\\
212 formatfield=\*(lqIn message %{text},\ \*(rq \}
213 .el message-id:nocomponent,\|nonewline,\|formatfield=\*(lqIn message %{text},\ \*(rq
214 from:nocomponent,\|formatfield=\*(lq%(friendly{text}) writes:\*(rq
215 body:component=\*(lq>\*(rq,\|overflowtext=\*(lq>\*(rq,\|overflowoffset=0
219 Which cites the Message-ID and author
220 of the message being replied\-to,
221 and then outputs each line of the body prefaced
222 with the \*(lq>\*(rq character.
225 To use the MIME rules for encapsulation,
226 specify the `\-mime' switch.
227 This directs \fIrepl\fR to generate an \fImhn\fR composition file.
228 Note that MH will not invoke \fImhn\fR automatically,
229 unless you add this line to your \&.mh\(ruprofile file:
236 you must specifically give the command
242 prior to sending the draft.
244 If you don't want to use this feature,
245 the manual page for \fIforw\fR contains another idea on how you can
246 automate this somewhat.
249 If the `\-annotate' switch is given,
250 the message being replied\-to will be annotated with the lines
255 where the address list contains one line for each addressee.
257 will be done only if the message is sent directly from \fIrepl\fR.
258 If the message is not sent immediately from \fIrepl\fR,
259 \*(lqcomp\ \-use\*(rq may be used to re\-edit and send the constructed message,
260 but the annotations won't take place.
261 The `\-inplace' switch causes annotation to
262 be done in place in order to preserve links to the annotated message.
264 The `\-fcc\ +folder' switch can be used to automatically specify a folder to
266 More than one folder, each preceeded by `\-fcc' can be named.
268 In addition to the standard \fImh\-format\fR\0(5) escapes,
269 \fIrepl\fR also recognizes the following additional
270 \fIcomponent\fR escape:
273 .ta \w'Escape 'u +\w'Returns 'u
274 \fIEscape\fR \fIReturns\fR \fIDescription\fR
275 \fIfcc\fR string Any folders specified with `\-fcc\ folder'
279 To avoid reiteration,
280 \fIrepl\fR strips any leading `Re: ' strings from
281 the \fIsubject\fR component.
283 The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
284 \fIMH\fR draft folder facility.
285 This is an advanced (and highly useful) feature.
286 Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
289 Upon exiting from the editor,
290 \fIrepl\fR will invoke the \fIwhatnow\fR program.
291 See \fIwhatnow\fR\0(1) for a discussion of available options.
292 The invocation of this program can be inhibited by using the `\-nowhatnowproc'
295 it is the \fIwhatnow\fR program which starts the initial edit.
296 Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
298 ^@@(MHETCPATH)/replcomps~^The reply template
299 ^or <mh\-dir>/replcomps~^Rather than the standard template
300 ^$HOME/\&.mh\(ruprofile~^The user profile
301 ^<mh\-dir>/draft~^The draft file
303 ^Path:~^To determine the user's MH directory
305 ^Alternate\-Mailboxes:~^To determine the user's mailboxes
307 ^Current\-Folder:~^To find the default current folder
309 ^Draft\-Folder:~^To find the default draft\-folder
311 ^Editor:~^To override the default editor
313 ^Msg\-Protect:~^To set mode when creating a new message (draft)
315 ^fileproc:~^Program to refile the message
317 ^mhlproc:~^Program to filter message being replied\-to
319 ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
321 comp(1), dist(1), forw(1), send(1), whatnow(1), mh\-format(5)
323 `+folder' defaults to the current folder
325 `msg' defaults to cur
327 `\-nocc\ all' at ATHENA sites, `\-cc\ all' otherwise
343 If a folder is given, it will become the current folder.
344 The message replied\-to will become the current message.
346 Prior to using the format string mechanism,
347 `\-noformat' used to cause address headers to be output as\-is.
348 Now all address fields are formatted using Internet standard guidelines.
350 If any addresses occur in the reply template,
351 addresses in the template that do not contain hosts are defaulted incorrectly.
352 Instead of using the localhost for the default,
353 \fIrepl\fR uses the sender's host.
354 Moral of the story: if you're going to include addresses in a reply template,
355 include the host portion of the address.
357 The `\-width columns' switch is only used
358 to do address-folding; other headers are not line\-wrapped.
360 If \fIwhatnowproc\fR is \fIwhatnow\fR,
361 then \fIrepl\fR uses a built\-in \fIwhatnow\fR,
362 it does not actually run the \fIwhatnow\fR program.
363 Hence, if you define your own \fIwhatnowproc\fR,
364 don't call it \fIwhatnow\fR since \fIrepl\fR won't run it.
366 If your current working directory is not writable,
367 the link named \*(lq@@\*(rq is not available.
379 .\" @@(#)$Id: repl.rf,v 1.12 1995/12/06 21:07:03 jromine Exp jromine $
382 This directs \fIreply\fR to generate an \fImhn\fR composition file.
393 .\" @@(#)$Id: repl.rf,v 1.11 1992/11/18 01:18:54 jromine Exp jromine $
396 If you don't want to use this featuer,
399 automate this somewhat
405 @demo using "nonewline"; pretty output for troff
410 .\" @@(#)$Id: repl.rf,v 1.10 1990/12/17 16:00:35 mh Exp jromine $
419 @remove default "-format"
425 .\" @@(#)$Id: repl.rf,v 1.9 90/04/05 15:09:27 sources Exp Locker: mh $
428 message-id:nocomponent,formatfield=\\
429 "In message %{text}you write:"
430 body:component=">",overflowtext=">",overflowoffset=0
433 Which cites the Message-ID of the message being replied\-to,
453 @put things back, do .NA stuff another way
462 @update USENET repl filter example
467 .TH REPL 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
485 Which prefaces each line of the body with the \*(lq>\*(rq character.
491 @fixup for makewhatis
503 mention {subject} semantics
523 \%[\-format] \%[\-noformat]
526 With the `\-format' switch one can indicate if Internet\-style
527 formatting should be used (or not be used with `\-noformat').
528 If present (the default), then lines beginning with the fields
529 \*(lqTo:\*(rq, \*(lqcc:\*(rq, and \*(rqBcc:\*(rq
530 will be standardized and have duplicate addresses removed.
531 In addition, the `\-width\ columns' switch will guide \fIrepl\fR's formatting
536 In addition to the standard escapes,
552 \fIEscape\fR \fISubstitution\fR
553 \fIfcc\fR Any folders specified with `\-fcc\ folder'
566 is being made. The `\-cc\ type' switch takes an argument which specifies
570 A reply template is simply a format file.
571 See \fImh\-format\fR\0(5) for the details.
575 \fIrepl\fR also recognizes the following additional escape:
579 \fIescape\fR \fIsubstitution\fR
580 fcc any `\-fcc\ folder' switches