1 10/20/83 read_mail request: print, pr, p
2
3 Syntax: p message_specifiers -selection_args -control_args
4
5
6 Function: prints the selected messages.
7
8
9 Arguments:
10 message_specifiers
11 identifies which messages are to be printed. If no
12 message_specifiers and no selection_args are specified, the current
13 message is printed. For more information on message specifiers,
14 type:
15 help message_specifiers.gi
16
17
18 Control arguments:
19 -long_header, -lghe
20 specifies that the print request is to display all information from
21 the message header including network tracing information even if
22 some of the information is redundant. Ie: if the From Sender and
23 Delivery-By fields are all equal this option will force the print
24 request to display all three fields when it prints the message.
25 -header, -he
26 specifies that the print request is to display all information from
27 the message header including user-defined fields while excluding the
28 message trace and redundant information. This is the default unless
29 a different default was specified on the read_mail command line.
30
31
32 -brief_header, -bfhe
33 specifies that the print request is to display the minimal amount of
34 information from the message header. The date and authors are
35 always displayed; the subject is displayed if it isn't blank; the
36 number of recipients is displayed either if there is more than one
37 recipient or the user is not the sole recipient of the message; if
38 the message was ever forwarded with comments, these comments will be
39 displayed.
40 -no_header, -nhe
41 specifies that the print request is to display absolutely no
42 information from the message header. Only the message number,
43 message body line count, and message body will be displayed.
44
45
46 -include_deleted, -idl
47 includes all messages in the mailbox whether or not they have been
48 deleted when processing message_specifiers and selection_args to
49 determine which messages will be printed.
50 -only_deleted, -odl
51 includes only those messages which have been deleted.
52 -only_non_deleted, -ondl
53 includes only those messages which have not been deleted. Default
54
55
56 -delete, -dl
57 marks the specified messages for deletion on exit from read_mail if
58 all messages are successfully printed.
59 -no_delete, -ndl
60 does not mark the messages for deletion. Default
61 -reverse, -rv
62 prints the messages in descending numeric order.
63 -no_reverse, -nrv
64 prints the messages in ascending numeric order. Default
65
66
67 List of message selection control arguments:
68 The following control arguments are used to further refine the
69 list of messages to be printed. For more detailed information,
70 type:
71 help selection_control_args.gi
72
73 -case_sensitive, -cs
74 causes subject selections and qedx regular expression searches for
75 author and recipient selections to be case sensitive. Default
76 -non_case_sensitive, -ncs
77 causes subject selections and qedx regular expression searches for
78 author and recipient selections to be case insensitive.
79
80
81 -subject STR,
82 -subject /STR/,
83 -sj STR,
84 -sj /STR/
85 selects any messages whose Subject field contains STR.
86 -in_reply_to STR,
87 -in_reply_to /STR/,
88 -irt STR,
89 -irt /STR/
90 selects any messages whose In-Reply-To field contains STR.
91
92
93 -between DT1 DT2, -bt DT1 DT2
94 selects any messages which were created between the dates DT1 and
95 DT2 inclusively.
96 -after DT, -af DT
97 selects any messages which were created on or after the date
98 specified by DT.
99 -before DT, -be DT
100 selects any messages which were created before the date specified
101 by DT.
102 -date DT, -dt DT
103 selects any messages which were created on the date specified by DT.
104
105
106 -between_time DT1 DT2, -btt DT1 DT2
107 selects any messages which were created between the date/times
108 specified by DT1 and DT2 inclusively.
109 -before_time DT, -bet DT
110 selects any messages which were created before the date/time
111 specified by DT.
112 -after_time DT, -aft DT
113 selects any messages which were created after the date/time
114 specified by DT.
115
116
117 -from address,
118 -from /STR/,
119 -fm address,
120 -fm /STR/
121 selects any messages whose From field either contains the specified
122 address or matches the given qedx regular expression.
123 -reply_to address,
124 -reply_to /STR/,
125 -rpt address,
126 -rpt /STR/
127 selects any messages whose Reply-To field either contains the
128 specified address or matches the given qedx regular expression.
129
130
131 -recipient address,
132 -recipient /STR/,
133 -rcp address,
134 -rcp /STR/
135 selects any messages whose To, cc, bcc, or Redistributed-To fields
136 either contains the specified address or matches the given qedx
137 regular expression.
138 -to address, -to /STR/
139 selects any messages whose To field either contains the specified
140 address or matches the given regular expression.
141 -cc address, -cc /STR/
142 selects any messages whose cc field either contains the specified
143 address or matches the given qedx regular expression.
144
145
146 -bcc address, -bcc /STR/
147 selects any mesages whose bcc field either contains the specified
148 address or matches the given qedx regular expression.
149 -forwarded_to address,
150 -forwarded_to /STR/,
151 -fwdt address,
152 -fwdt /STR/
153 selects any messages whose Redistributed-To field either contains
154 the specified address or matches the given qedx regular expression.
155
156
157 Notes:
158 This request will acknowledge any messages requiring acknowledgement
159 unless -no_acknowledge is specified on the read_mail command line.