1 10/20/83  read_mail request:  delete, dl, d
  2 
  3 Syntax:  dl {message_specifiers} {-selection_args} {-control_args}
  4 
  5 
  6 Function:  marks the specified messages for deletion from the mailbox
  7 on exit from read_mail.
  8 
  9 
 10 Arguments:
 11 message_specifiers
 12    identifies which messages are to be deleted.  If no
 13    message_specifiers and selection_args are specified, the current
 14    message is deleted.  For more information on message specifiers,
 15    type:
 16          help message_specifiers.gi
 17 
 18 
 19 Control arguments:
 20 -force, -fc
 21    deletes unprocessed messages without querying for permission and
 22    ignores messages which can not be deleted due to insufficient
 23    access.
 24 -no_force, -nfc
 25    queries the user for permission to delete any unprocessed messages
 26    and does not delete any message if either the user answers "no" to
 27    a query or the user lacks sufficient access to delete one or more of
 28    the specified messages.
 29 
 30 
 31 List of message selection control arguments:
 32    The following control arguments are used to further refine the
 33    list of messages to be deleted.  For more detailed information,
 34    type:
 35          help selection_control_args.gi
 36 
 37 -case_sensitive, -cs
 38    causes subject selections and qedx regular expression searches for
 39    author and recipient selections to be case sensitive.  (Default)
 40 -non_case_sensitive, -ncs
 41    causes subject selections and qedx regular expression searches for
 42    author and recipient selections to be case insensitive.
 43 
 44 
 45 -subject STR,
 46 -subject /STR/,
 47 -sj STR,
 48 -sj /STR/
 49    selects any messages whose Subject field contains STR.
 50 -in_reply_to STR,
 51 -in_reply_to /STR/,
 52 -irt STR,
 53 -irt /STR/
 54    selects any messages whose In-Reply-To field contains STR.
 55 
 56 
 57 -between DT1 DT2, -bt DT1 DT2
 58    selects any messages which were created between the dates DT1 and
 59    DT2 inclusively.
 60 -after DT, -af DT
 61    selects any messages which were created on or after the date
 62    specified by DT.
 63 -before DT, -be DT
 64    selects any messages which were created before the date specified
 65    by DT.
 66 -date DT, -dt DT
 67    selects any messages which were created on the date specified by DT.
 68 
 69 
 70 -between_time DT1 DT2, -btt DT1 DT2
 71    selects any messages which were created between the date/times
 72    specified by DT1 and DT2 inclusively.
 73 -before_time DT, -bet DT
 74    selects any messages which were created before the date/time
 75    specified by DT.
 76 -after_time DT, -aft DT
 77    selects any messages which were created after the date/time
 78    specified by DT.
 79 
 80 
 81 -from address,
 82 -from /STR/,
 83 -fm address,
 84 -fm /STR/
 85    selects any messages whose From field either contains the specified
 86    address or matches the given qedx regular expression.
 87 -reply_to address,
 88 -reply_to /STR/,
 89 -rpt address,
 90 -rpt /STR/
 91    selects any messages whose Reply-To field either contains the
 92    specified address or matches the given qedx regular expression.
 93 
 94 
 95 -recipient address,
 96 -recipient /STR/,
 97 -rcp address,
 98 -rcp /STR/
 99    selects any messages whose To, cc, bcc, or Redistributed-To fields
100    either contains the specified address or matches the given qedx
101    regular expression.
102 -to address, -to /STR/
103    selects any messages whose To field either contains the specified
104    address or matches the given regular expression.
105 -cc address, -cc /STR/
106    selects any messages whose cc field either contains the specified
107    address or matches the given qedx regular expression.
108 
109 
110 -bcc address, -bcc /STR/
111    selects any messages whose bcc field either contains the specified
112    address or matches the given qedx regular expression.
113 -forwarded_to address,
114 -forwarded_to /STR/,
115 -fwdt address,
116 -fwdt /STR/
117    selects any messages whose Redistributed-To field either contains
118    the specified address or matches the given qedx regular expression.
119 
120 
121 Notes:
122 Messages which are marked for deletion by this request may be unmarked
123 by the retrieve request before exiting read_mail.
124 
125 This request will acknowledge any messages requiring acknowledgement
126 unless -no_acknowledge is specified on the read_mail command line.
127 
128 An unprocessed message is a message which has not been the subject of
129 any of the following requests:
130    print, print_header, list, forward, reply, log, save, write, copy,
131    append, preface, apply