1 01/14/87  print_mail, prm
  2 
  3 Syntax as a command:  prm {mbx_specification} {-control_args}
  4 
  5 
  6 Function:  prints the messages in a mailbox, querying you whether to
  7 delete each one after it is printed.
  8 
  9 
 10 Arguments:
 11 mbx_specification
 12    specifies the mailbox from which messages are to be printed.  If not
 13    given, the user's default mailbox
 14    (>udd>Project_id>Person_id>Person_id.mbx) is used.
 15 
 16 
 17 Control arguments:
 18 -accessible, -acc
 19    selects only those messages in the mailbox that you are permitted to
 20    read.  If you have read (r) extended access on the mailbox,
 21    print_mail selects all messages in the mailbox; if you have own (o)
 22    extended access on the mailbox, it selects only those messages that
 23    you sent to the mailbox.  (Default)
 24 -acknowledge, -ack
 25    acknowledges messages that request acknowledgement.  (Default)
 26 -all, -a
 27    selects all messages in the mailbox regardless of who sent them.  It
 28    requires read (r) extended access on the mailbox.
 29 -brief, -bf
 30    shortens the greeting message.  This message indicates the number of
 31    messages in the mailbox.
 32 -brief_header, -bfhe
 33    displays the minimal amount of information from the message header.
 34    The date and authors are always displayed; the subject is displayed
 35    if it is not blank; the number of recipients is displayed either if
 36    there is more than one recipient or if you are not the sole
 37    recipient of the message; if the message is forwarded with comments,
 38    they are also displayed.
 39 -count, -ct
 40    displays the number of messages read from the mailbox before
 41    printing the first message.  (Default)
 42 -debug, -db
 43    enables print_mail's debugging facilities.  It is not recommended
 44    for normal users of print_mail.
 45 -header, -he
 46    displays all information from the message header, including
 47    user-defined fields and excluding the message trace and redundant
 48    information.  (Default)
 49 -interactive_messages, -im
 50    includes interactive messages (as sent by the send_message command)
 51    along with regular mail.  (Default)
 52 -list, -ls
 53    prints a summary of all the messages before printing the first
 54    message.  This summary is identical to that produced by the
 55    read_mail list request.
 56 -long, -lg
 57    prints the long form of the greeting message.  (Default)
 58 -long_header, -lghe
 59    displays all information from the message header, including
 60    network-tracing information, even if some of it is redundant (e.g.,
 61    if the From, Sender, and Delivery-By fields are all equal,
 62    -long_header forces print_mail to display them when it prints the
 63    message).
 64 -mail, -ml
 65    prints ordinary messages in the mailbox.  (Default)
 66 -no_acknowledge, -nack
 67    does not acknowledge messages that request acknowledgement.
 68 -no_count, -nct
 69    does not display the message count.
 70 -no_debug, -ndb
 71    disables print_mail's debugging facilities.  (Default)
 72 -no_header, -nhe
 73    displays no information from the message header.  Only the message
 74    number, message body line count, and message body are displayed.
 75 -no_interactive_messages, -nim
 76    does not include interactive messages.  It is incompatible with
 77    -no_mail.
 78 -no_list, -nls
 79    does not print a summary of the messages.  (Default)
 80 -no_mail, -nml
 81    does not print ordinary messages.
 82 -no_reverse, -nrv
 83    prints the messages in ascending numeric order.  (Default)
 84 -not_own
 85    selects only those messages in the mailbox that were not sent by
 86    you.  It requires read (r) extended access on the mailbox.
 87 -own
 88    selects only those messages in the mailbox that you sent to the
 89    mailbox.  It requires own (o) extended access on the mailbox.
 90 -reverse, -rv
 91    prints the messages in descending numeric order.
 92 
 93 
 94 List of mbx specifications:
 95 -log
 96    specifies the user's logbox and is equivalent to
 97 
 98          -mailbox >udd>Project_id>Person_id>Person_id.sv.mbx
 99 
100 -mailbox path, -mbx path
101    specifies the pathname of a mailbox.  The suffix mbx is added if
102    necessary.
103 -save path, -sv path
104    specifies the pathname of a savebox.  The suffix sv.mbx is added if
105    necessary.
106 -user STR
107    specifies either a user's default mailbox or an entry in the system
108    mail table (see "Notes on Mailbox Selection by User" below).
109 STR
110    is any noncontrol argument and is first interpreted as -mailbox STR;
111    if no mailbox is found, STR is then interpreted as -save STR; if no
112    savebox is found, it is interpreted as -user STR.
113 
114 
115 List of query responses:  After printing each message, print_mail asks
116 the question
117 
118       print_mail: Delete #N?
119 
120 The acceptable answers are
121 ?
122    prints the list of acceptable answers.
123 abort
124    exits print_mail without deleting any messages.
125 no, n
126    does not delete this message.
127 quit, q
128    deletes the indicated messages and exits print_mail; the message
129    just printed is not deleted (see "Notes").
130 reprint, print, pr, p
131    prints the message and asks the question again.
132 yes, y
133    deletes this message (see "Notes").
134 
135 
136 Notes:  Answering "yes" to the query after a message is printed does
137 not delete the message immediately but marks it as one for deletion.
138 
139 Messages are actually deleted either after you answered the query for
140 the last message (unless you typed "abort") or after you answered any
141 query with "quit."
142 
143 
144 Notes on mailbox selection by user:  A user's default mailbox is
145 specified in the form Person_id.Project_id.  For an entry in the mail
146 table, STR is usually in the form of Person_id.  The mail table permits
147 you to address mail by Person_id without knowing the Project_id of the
148 recipient.  The mail table is described in the _^HE_^Hx_^Ht_^He_^Hn_^Hd_^He_^Hd _^HM_^Ha_^Hi_^Hl _^HS_^Hy_^Hs_^Ht_^He_^Hm
149 _^HU_^Hs_^He_^Hr_^H'_^Hs _^HG_^Hu_^Hi_^Hd_^He (CH23) and the _^HM_^Hu_^Hl_^Ht_^Hi_^Hc_^Hs _^HS_^Hy_^Hs_^Ht_^He_^Hm _^HA_^Hd_^Hm_^Hi_^Hn_^Hi_^Hs_^Ht_^Hr_^Ha_^Ht_^Hi_^Ho_^Hn _^HP_^Hr_^Ho_^Hc_^He_^Hd_^Hu_^Hr_^He_^Hs
150 (AK50) manuals.
151 
152 If STR contains one period and no white space, it is interpreted as a
153 User_id that specifies a user's default mailbox; otherwise it is
154 interpreted as the name of an entry in the mail table.
155 
156 For example,
157 
158       -user DBuxtehude.SiteSA
159 
160 is interpreted as a User_id that identifies a default mailbox.  On the
161 other hand,
162 
163       -user "George G. Byron"
164       -user L.v.Beethoven
165       -user Burns
166 
167 are all interpreted as the names of entries in the mail table:  the
168 first because it contains white space; the second because it contains
169 more than one period; the third because it contains no period.
170 
171 When interpreted as a User_id, STR cannot contain any angle brackets
172 (<>) and must have the form Person_id.Project_id, where "Person_id"
173 cannot exceed 28 characters and "Project_id" 32 characters.  In this
174 case, "-user STR" is equivalent to the mbx_specification "-mailbox
175 >udd>Project_id>Person_id>Person_id.mbx."
176 
177 When interpreted as the name of a mail table entry, STR cannot contain
178 any commas, colons, semicolons, backslashes (\), parentheses, angle
179 brackets, braces ({}), quotes, commercial at-signs (@), or white space
180 other than spaces.  The query of the mail table is performed in a
181 case-insensitive manner.  Use the display_mailing_address command to
182 determine the actual address corresponding to STR.  The address in the
183 mail table must identify a mailbox.