1 01/20/86 read_mail request: list, ls
2
3 Syntax: ls message_specifiers -selection_args -control_args
4
5
6 Syntax as an active request:
7 ls message_specifiers -selection_args -control_args
8
9
10 Function: displays a tabular summary of the selected messages. As an
11 active request, returns the message numbers of the selected messages.
12
13
14 Arguments:
15 message_specifiers
16 identifies which messages are to be listed. If no
17 message_specifiers and no selection_args are specified, all messages
18 are listed. For more information on message specifiers, type:
19 help message_specifiers.gi
20
21
22 Control arguments:
23 -include_deleted, -idl
24 includes all messages in the mailbox whether or not they have been
25 deleted when processing message_specifiers and selection_args to
26 determine which messages will be listed.
27 -only_deleted, -odl
28 includes only those messages which have been deleted.
29 -only_non_deleted, -ondl
30 includes only those messages which have not been deleted. Default
31
32
33 -header, -he
34 preceeds the message listing by a header line which identifies the
35 columns of the list. Default
36 -no_header, -nhe
37 omits the header line from the listing.
38 -line_length N, -ll N
39 uses the supplied line length when determining where and if to
40 truncate the message subject. Default-- the terminal's line
41 length
42 -no_line_length, -nll
43 does not truncate the message subject.
44 -reverse, -rv
45 lists the messages in descending numeric order.
46 -no_reverse, -nrv
47 lists the messages in ascending numeric order. Default
48
49
50 List of message selection control arguments:
51 The following control arguments are used to further refine the
52 list of messages to be listed. For more detailed information,
53 type:
54 help selection_control_args.gi
55
56 -case_sensitive, -cs
57 causes subject selections and qedx regular expression searches for
58 author and recipient selections to be case sensitive. Default
59 -non_case_sensitive, -ncs
60 causes subject selections and qedx regular expression searches for
61 author and recipient selections to be case insensitive.
62
63
64 -subject STR,
65 -subject /STR/,
66 -sj STR,
67 -sj /STR/
68 selects any messages whose Subject field contains STR.
69 -in_reply_to STR,
70 -in_reply_to /STR/,
71 -irt STR,
72 -irt /STR/
73 selects any messages whose In-Reply-To field contains STR.
74
75
76 -between DT1 DT2, -bt DT1 DT2
77 selects any messages which were created between the dates DT1 and
78 DT2 inclusively.
79 -after DT, -af DT
80 selects any messages which were created on or after the date
81 specified by DT.
82 -before DT, -be DT
83 selects any messages which were created before the date specified
84 by DT.
85 -date DT, -dt DT
86 selects any messages which were created on the date specified by DT.
87
88
89 -between_time DT1 DT2, -btt DT1 DT2
90 selects any messages which were created between the date/times
91 specified by DT1 and DT2 inclusively.
92 -before_time DT, -bet DT
93 selects any messages which were created before the date/time
94 specified by DT.
95 -after_time DT, -aft DT
96 selects any messages which were created after the date/time
97 specified by DT.
98
99
100 -from address,
101 -from /STR/,
102 -fm address,
103 -fm /STR/
104 selects any messages whose From field either contains the specified
105 address or matches the given qedx regular expression.
106 -reply_to address,
107 -reply_to /STR/,
108 -rpt address,
109 -rpt /STR/
110 selects any messages whose Reply-To field either contains the
111 specified address or matches the given qedx regular expression.
112
113
114 -recipient address,
115 -recipient /STR/,
116 -rcp address,
117 -rcp /STR/
118 selects any messages whose To, cc, bcc, or Redistributed-To fields
119 either contains the specified address or matches the given qedx
120 regular expression.
121 -to address, -to /STR/
122 selects any messages whose To field either contains the specified
123 address or matches the given regular expression.
124 -cc address, -cc /STR/
125 selects any messages whose cc field either contains the specified
126 address or matches the given qedx regular expression.
127
128
129 -bcc address, -bcc /STR/
130 selects any messages whose bcc field either contains the specified
131 address or matches the given qedx regular expression.
132 -forwarded_to address,
133 -forwarded_to /STR/,
134 -fwdt address,
135 -fwdt /STR/
136 selects any messages whose Redistributed-To field either contains
137 the specified address or matches the given qedx regular expression.
138
139
140 Notes on listing format:
141 One line is printed for each message. Its format is:
142
143 N*SA LF MM/DD/YY HH:MM AUTHOR SUBJECT
144
145 where N is the message number and L is the number of lines in the body
146 of the message. The "*", "S", "A", and "F" are optional flags and are
147 described below. MM/DD/YY HH:MM is the date/time when the message was
148 created. AUTHOR is that part of the first author's name which will fit
149 in the space provided; if the first author does not have a name, the
150 printed representation of his address is used instead; the authors of a
151 message are listed in the From field. SUBJECT is that part of the
152 message's subject which will fit on the remainder of the line; if the
153 message is an interactive message and does not have a subject, the
154 actual text of the message is used instead.
155
156
157 The * after the message number appears if this is the current message.
158 If "-idl" or "-odl" is specified and this message has been marked for
159 deletion, an exclamation point ! appears here instead. If this
160 message cannot be deleted because its access class is not equal to
161 the user's process authorization, an ampersand & appears here
162 instead.
163
164 An "S" appears in the next column if the message has previously been
165 printed by the print request. The "S" indicates a "seen" message, as
166 referred to by the "seen", "unseen", and "new" message specifier
167 keywords.
168
169 An "A" appears in the next column if the message requires an
170 acknowledgement and one has not yet been delivered.
171
172 An "F" appears after the line count if the message was forwarded by
173 one of its recipients to the mailbox being examined.
174
175
176 Examples of listing lines:
177
178 34* & 56 03/27/83 12:56 Peter Kelley Mail system in<MORE>
179
180 6 A 150F 10/01/83 10:27 GMP at MIT-MC First draft of<MORE>