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