|
|
1.1 root 1: .\" This file is automatically generated. Do not edit!
2: .SC REPL 1
3: .NA
4: repl \- reply to a message
5: .SY
6: repl
7: \%[+folder] \%[msg]
8: \%[\-annotate] \%[\-noannotate]
9: \%[\-cc\ all/to/cc/me] \%[\-nocc\ all/to/cc/me]
10: \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
11: \%[\-editor\ editor] \%[\-noedit]
12: \%[\-fcc\ +folder]
13: \%[\-filter\ filterfile]
14: \%[\-form\ formfile]
15: \%[\-format] \%[\-noformat]
16: \%[\-inplace] \%[\-noinplace]
17: \%[\-query] \%[\-noquery]
18: \%[\-width\ columns]
19: \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
20: \%[\-help]
21: .DE
22: \fIRepl\fR aids a user in producing a reply to an existing
23: message.
24: \fIRepl\fR uses a reply template to guide its actions when constructing
25: the message draft of the reply.
26: In its simplest form (with no arguments),
27: it will set up
28: a message\-form skeleton in reply to the current message in the
29: current folder, and invoke the whatnow shell.
30: The default reply template will direct \fIrepl\fR to construct
31: the composed message as follows:
32:
33: .nf
34: .in 1i
35: To: <Reply\-To> or <From>
36: cc: <cc>, <To>, and yourself
37: Subject: Re: <Subject>
38: In\-reply\-to: Your message of <Date>.
39: .ti +\w'In\-reply\-to: 'u
40: <Message\-Id>
41: .in .5i
42: .fi
43:
44: where field names enclosed in angle brackets (<\ >) indicate the
45: contents of the named field from the message to which the reply
46: is being made. The `\-cc\ type' switch takes an argument which specifies
47: who gets placed on the \*(lqcc:\*(rq list of the reply.
48: The `\-query' switch modifies the action of `\-cc\ type' switch by
49: interactively asking you if each address that normally would be placed
50: in the \*(lqTo:\*(rq and \*(lqcc:\*(rq list should actually be sent a copy.
51: (This is useful for special\-purpose replies.)
52: Note that the position of the `\-cc' and `\-nocc' switches,
53: like all other switches which take a positive and negative form,
54: is important.
55:
56: If the file named \*(lqreplcomps\*(rq exists in the user's MH directory,
57: it will be used instead of the default form.
58: In either case, the file specified by `\-form\ formfile' will be used
59: if given.
60:
61: If the draft already exists,
62: \fIrepl\fR will ask you as to the disposition of the draft.
63: A reply of \fBquit\fR will abort \fIrepl\fR, leaving the draft intact;
64: \fBreplace\fR will replace the existing draft with a blank skeleton;
65: and \fBlist\fR will display the draft.
66:
67: See \fIcomp\fR\0(1) for a description of the `\-editor' and `\-noedit'
68: switches.
69: Note that while in the editor,
70: the message being replied to is available through a link named \*(lq@\*(rq
71: (assuming the default \fIwhatnowproc\fR\0).
72: In addition, the actual pathname of the message is stored in the environment variable
73: \fB$editalt\fR,
74: and the pathname of the folder containing the message is stored in the
75: environment variable \fB$mhfolder\fR.
76:
77: Although \fIrepl\fR uses the `\-form\ formfile' switch to direct it how
78: to construct the beginning of the draft, the `\-filter\ filterfile'
79: switch directs \fIrepl\fR as to how the message being replied\-to
80: should be formatted in the body of the draft.
81: If `\-filter' is not specified,
82: then the message being replied\-to is not included in the body of the
83: draft.
84: If `\-filter\ filterfile' is specified,
85: then the message being replied\-to is filtered (re\-formatted) prior to
86: being output to the body of the draft.
87: The filter file for \fIrepl\fR should be a standard form file for
88: \fImhl\fR, as \fIrepl\fR will invoke \fImhl\fR to format the message
89: being replied\-to.
90: There is no default message filter (`\-filter' must be followed by a
91: file name).
92: A filter file that is commonly used is:
93:
94: .nf
95: .in +.5i
96: :
97: body:nocomponent,compwidth=9,offset=9
98: .in -.5i
99: .fi
100:
101: which says to output a blank line and then the body of the message
102: being replied\-to, indented by one tab\-stop.
103:
104: If the `\-annotate' switch is given,
105: the message being replied\-to will be annotated with the lines
106:
107: Replied:\ date
108: Replied:\ addrs
109:
110: where the address list contains one line for each addressee.
111: The annotation
112: will be done only if the message is sent directly from \fIrepl\fR.
113: If the message is not sent immediately from \fIrepl\fR,
114: \*(lqcomp\ \-use\*(rq may be used to re\-edit and send the constructed message,
115: but the annotations won't take place.
116: The `\-inplace' switch causes annotation to
117: be done in place in order to preserve links to the annotated message.
118:
119: With the `\-format' switch one can indicate if Internet\-style
120: formatting should be used (or not be used with `\-noformat').
121: If present (the default), then lines beginning with the fields
122: \*(lqTo:\*(rq, \*(lqcc:\*(rq, and \*(rqBcc:\*(rq
123: will be standardized and have duplicate addresses removed.
124: In addition, the `\-width\ columns' switch will guide \fIrepl\fR's formatting
125: of these fields.
126:
127: The `\-fcc\ +folder' switch can be used to automatically specify a folder to
128: receive Fcc:s.
129: More than one folder, each preceeded by `\-fcc' can be named.
130:
131: A reply template is simply a format file.
132: See \fImh\-format\fR\0(5) for the details.
133:
134: In addition to the standard escapes,
135: \fIrepl\fR also recognizes the following additional escape:
136: .nf
137: .ta \w'escape 'u
138: \fIescape\fR \fIsubstitution\fR
139: fcc any `\-fcc\ folder' switches
140: .re
141: .fi
142:
143: The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
144: \fIMH\fR draft folder facility.
145: This is an advanced (and highly useful) feature.
146: Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
147: information.
148:
149: Upon exiting from the editor,
150: \fIrepl\fR will invoke the \fIwhatnow\fR program.
151: See \fIwhatnow\fR\0(1) for a discussion of available options.
152: The invocation of this program can be inhibited by using the `\-nowhatnowproc'
153: switch.
154: (In truth of fact,
155: it is the \fIwhatnow\fR program which starts the initial edit.
156: Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
157: .Fi
158: ^/usr/new/lib/mh/replcomps~^The reply template
159: ^or <mh\-dir>/replcomps~^Rather than the standard template
160: ^$HOME/\&.mh\(ruprofile~^The user profile
161: ^<mh\-dir>/draft~^The draft file
162: .Pr
163: ^Path:~^To determine the user's MH directory
164: .Ps
165: ^Alternate\-Mailboxes:~^To determine the user's mailboxes
166: .Ps
167: ^Current\-Folder:~^To find the default current folder
168: .Ps
169: ^Draft\-Folder:~^To find the default draft\-folder
170: .Ps
171: ^Editor:~^To override the default editor
172: .Ps
173: ^Msg\-Protect:~^To set mode when creating a new message (draft)
174: .Ps
175: ^fileproc:~^Program to refile the message
176: .Ps
177: ^mhlproc:~^Program to filter message being replied\-to
178: .Ps
179: ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
180: .Sa
181: comp(1), dist(1), forw(1), send(1), whatnow(1), mh\-format(5)
182: .De
183: `+folder' defaults to the current folder
184: .Ds
185: `msg' defaults to cur
186: .Ds
187: `\-nocc\ all' at ATHENA sites, `\-cc\ all' otherwise
188: .Ds
189: `\-format'
190: .Ds
191: `\-noannotate'
192: .Ds
193: `\-nodraftfolder'
194: .Ds
195: `\-noinplace'
196: .Ds
197: `\-noquery'
198: .Ds
199: `\-width\ 72'
200: .Co
201: If a folder is given, it will become the current folder.
202: The message replied\-to will become the current message.
203: .Bu
204: If any addresses occur in the reply template,
205: addresses in the template that do not contain hosts are defaulted incorrectly.
206: Instead of using the localhost for the default,
207: \fIrepl\fR uses the sender's host.
208: Moral of the story: if you're going to include addresses in a reply template,
209: include the host portion of the address.
210:
211: If \fIwhatnowproc\fR is \fIwhatnow\fR,
212: then \fIrepl\fR uses a built\-in \fIwhatnow\fR,
213: it does not actually run the \fIwhatnow\fR program.
214: Hence, if you define your own \fIwhatnowproc\fR,
215: don't call it \fIwhatnow\fR since \fIrepl\fR won't run it.
216:
217: If your current working directory is not writable,
218: the link named \*(lq@\*(rq is not available.
219: .En
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.