1 10/20/83  read_mail request:  reply, rp
  2 
  3 Syntax:
  4    rp {message_specifiers} {-control_args} {-to destinations}
  5       {-control_args additional_destinations}
  6 
  7 
  8 Function:  composes a single reply to the specified messages by
  9 invoking the send_mail subsystem.
 10 
 11 
 12 Arguments:
 13 message_specifiers
 14    identifies the messages which are to be answered.  If no
 15    message_specifiers are supplied, the current message is answered.
 16    For more information on message specifiers, type:
 17          help message_specifiers.gi
 18 destinations
 19    identifies the primary recipients of the reply.  See "Notes on
 20    recipients" below for more information.  These arguments are
 21    addresses.  Type:
 22          help addresses.gi -section control argument
 23    for a description of the syntax of addresses.
 24 additional_destinations
 25    identifies additional recipients for the reply.  These arguments are
 26    addresses.
 27 
 28 
 29 Control arguments:
 30 -include_original, -io
 31    includes the text of the messages being answered at the beginning of
 32    the reply message.
 33 -no_include_original, -nio
 34    does not include the original texts in the reply.  (Default)
 35 -refill, -rfi
 36    reformats the original texts according the to the fill-on and
 37    align-left modes of compose.
 38 -no_refill, -nrfi
 39    does not reformat the original texts.  (Default)
 40 -indent N, -ind N
 41    indents the original texts (after reformatting) by N columns in the
 42    reply message.  (Default -- 4)
 43 
 44 
 45 -include_deleted, -idl
 46    includes all messages in the mailbox whether or not they have been
 47    deleted when processing the message_specifiers to determine which
 48    messages will be answered.
 49 -only_deleted, -odl
 50    includes only those messages which have been deleted.
 51 -only_non_deleted, -ondl
 52    includes only those messages which have not been deleted.  (Default)
 53 -delete, -dl
 54    marks the specified messages for deletion on exit from read_mail
 55    if all messages are successfully answered.
 56 -no_delete, -ndl
 57    does not mark the messages for deletion.  (Default)
 58 
 59 
 60 -include_authors, -iat
 61    includes the authors of the original messages as primary recipients
 62    of the reply.  See "Notes on recipients" below for more information.
 63 -no_include_authors, -niat
 64    does not include the original authors as primary recipients.
 65 -include_recipients, -irc
 66    includes all recipients of the original messages as secondary or
 67    "blind" recipients of the reply.
 68 -no_include_recipients, -nirc
 69    does not include the original recipients.
 70 
 71 
 72 -include_self, -is
 73    allows a copy of the reply to be sent to the person composing the
 74    reply if this request determines that such a copy should be sent
 75    from the use of -include_authors or -include_recipients.
 76 -no_include_self, -nis
 77    specifies that a copy of the reply only be sent to the person
 78    composing the reply if explicitly requested by use of the -to, -cc,
 79    or -bcc control arguments.  (Default)
 80 -to addresses
 81    specifies the primary recipients of the reply.  See "Notes on
 82    recipients" for more information.
 83 -cc addresses
 84    specifies the secondary recipients of the reply.
 85 -bcc addresses
 86    specifies the "blind" recipients of the reply.
 87 
 88 
 89 List of send_mail control arguments accepted by reply:
 90    The following send_mail control arguments are accepted by this
 91    request to tailor the invocation of send_mail created to compose the
 92    reply.  For a detailed explanation of these control arguments, type:
 93          .. help send_mail
 94 
 95 
 96 -abbrev, -ab
 97 -no_abbrev, -nab
 98 -profile path, -pf path
 99    controls abbreviation processing within send_mail.  See the Notes.
100 -abort
101 -no_abort
102    controls whether the reply request will abort immediately if any of
103    the addresses given on the request line are invalid.
104    (Default -- -abort)
105 -acknowledge, -ack
106 -no_acknowledge, -nack
107    controls whether recipients of the reply will send an
108    acknowledgement when reading the reply.  (Default -- -nack)
109 
110 
111 -auto_write
112 -no_auto_write
113    controls whether the qedx request will require the use of the write
114    request before quitting the editor.  (Default -- -no_auto_write)
115 -brief, -bf
116 -long, -lg
117    controls the length of informative messages.  (Default -- -long)
118 -debug, -db
119 -no_debug, -ndb
120    enables/disables send_mail's debugging facilities.  See the Notes.
121 -fill, -fi
122 -no_fill, -nfi
123 -line_length N, -ll N
124    controls reformatting of the reply.  (Default -- -fill for terminal
125    input; -no_fill for file input; -ll 72)
126 
127 
128 -from addresses
129    specifies the authors of the reply.
130 -input_file path, -if path
131 -terminal_input, -ti
132    specifies the source of the reply's text.  (Default -- -ti)
133 -notify, -nt
134 -no_notify, -nnt
135    controls whether the recipients of the reply are to receive a
136    "You have mail." notification message.  (Default -- -notify)
137 -prompt STR
138 -no_prompt
139    controls prompting in send_mail's request loop. (Default -- -prompt)
140 -reply_to addresses, -rpt addresses
141    specifies the recipients of any replies to the reply.
142 
143 
144 -request STR, -rq STR
145    specifies an initial request line for send_mail.  (Default -- none)
146 -request_loop, -rql
147 -no_request_loop, -nrql
148    controls whether send_mail always enters it request loop or only
149    enters if it can't send the reply.  (Default -- -nrql for terminal
150    input; -rql for file input)
151 -subject STR, -sj STR
152 -no_subject, -nsj
153    specifies the subject of the reply.  See the Notes.
154 
155 
156 List of read_mail control arguments specifying reply defaults:
157    The following control arguments (described above) may be specified
158    on the read_mail command line in order to change the default
159    behavior of the reply request within an invocation of read_mail.
160 
161 
162 -fill, -fi
163 -no_fill, -nfi
164 -line_length N, -ll N
165    controls reformatting of the reply within send_mail.
166 -include_original, -io
167 -no_include_original, -nio
168 -indent N, -ind N
169    controls inclusion of the original texts in the reply.
170 -include_authors, -iat
171 -no_include_authors, -niat
172 -include_recipients, -irc
173 -no_include_recipients, -nirc
174 -include_self, -is
175 -no_include_self, -nis
176    specifies the recipients of the reply.
177 
178 
179 Notes on recipients:
180 By default, the reply will be sent only to the authors of the original
181 messages or to those recipients specified by the authors to receive
182 replies in place of the authors.  In the rest of this info file, the
183 term "authors of the original messages" acutally means either the
184 authors or their designated agents.
185 
186 The -to and -include_authors control arguments are used to specify the
187 primary recipients for the reply.  If the -to control argument is used
188 and -include_authors does not appear on the request line, only those
189 addresses specified after -to are used as the primary recipients of the
190 reply.  If both -to and -include_authors are used on the request line,
191 the primary recipients of the message will be the authors of the
192 original messages and the addresses specified after the -to control
193 argument.  Use of -include_authors on the read_mail command line does
194 not affect this interaction of -to and -include_authors on the reply
195 request line.
196 
197 
198 The -cc, -bcc, and -include_recipients control arguments are used to
199 specify the secondary and "blind" recipients for the reply.  If
200 -include_recipients is specified either on the reply request line or
201 the read_mail command line, all primary and secondary recipients of the
202 original messages are included as secondary recipients of the reply and
203 all "blind" recpients of the original messages are included as "blind"
204 recipients of the reply.  If -cc is used on the request line, the
205 addresses following the -cc control argument are added to the list of
206 secondary recipients of the reply.  If -bcc is used on the request
207 line, the addresses following the -bcc control argument are added to
208 the list of "blind" recipients of the reply.
209 
210 
211 For example, the command line
212 
213     read_mail -include_recipients
214 
215 in conjunction with the request line
216 
217     reply -to Palter.Multics -cc Sibert.Multics
218 
219 composes a reply for the current message which is sent to
220 Palter.Multics as the sole primary recipient, to all the primary and
221 secondary recipients of the current message plus Sibert.Multics as the
222 secondary recipients, and to all the "blind" recipients of the current
223 message again as "blind" recipients.
224 
225 
226 Notes:
227 This request will acknowledge any messages requiring acknowledgement
228 unless -no_acknowledge is specified on the read_mail command line.
229 
230 Unless overriden by use of the -abbrev, -no_abbrev, or -profile control
231 arguments, the send_mail invocation created by this request will have
232 the same state of request line abbreviation expansion and use the same
233 profile as the current read_mail invocation.
234 
235 Unless overriden by use of the -debug or -no_debug control arguments,
236 the send_mail invocation created by this request will have the same
237 debugging mode (on/off) as the current read_mail invocation.
238 
239 
240 Unless overriden by use of the -subject or -no_subject control
241 arguments, this request will use the first non-blank subject found in
242 the original messages as the subject of the reply.  Additionally, this
243 subject will be prefixed by the string "Re: " if not already present.
244 
245 This request will construct an In-Reply-To field for the reply message
246 identifying the original messages being answered by this reply.  For a
247 description of the contents of this field, type:
248       help message_format.gi -search in-reply-to