1 10/20/83  read_mail request:  retrieve, rt
  2 
  3 Syntax:  rt {message_specifiers} {-selection_args}
  4 
  5 
  6 Function:  retrieves messages previously marked for deletion on exit
  7 from read_mail so that they will not be deleted.
  8 
  9 
 10 Arguments:
 11 message_specifiers
 12    identifies which messages are to be retrieved.  At least one
 13    message_specifier or one selection_arg must be specified.  For more
 14    information on message specifiers, type:
 15          help message_specifiers.gi
 16 
 17 
 18 List of message selection control arguments:
 19    The following control arguments are used to further refine the
 20    list of messages to be retrieved.  For more detailed information,
 21    type:
 22          help selection_control_args.gi
 23 
 24 -case_sensitive, -cs
 25    causes subject selections and qedx regular expression searches for
 26    author and recipient selections to be case sensitive.  (Default)
 27 -non_case_sensitive, -ncs
 28    causes subject selections and qedx regular expression searches for
 29    author and recipient selections to be case insensitive.
 30 
 31 
 32 -subject STR,
 33 -subject /STR/,
 34 -sj STR,
 35 -sj /STR/
 36    selects any messages whose Subject field contains STR.
 37 -in_reply_to STR,
 38 -in_reply_to /STR/,
 39 -irt STR,
 40 -irt /STR/
 41    selects any messages whose In-Reply-To field contains STR.
 42 
 43 
 44 -between DT1 DT2, -bt DT1 DT2
 45    selects any messages which were created between the dates DT1 and
 46    DT2 inclusively.
 47 -after DT, -af DT
 48    selects any messages which were created on or after the date
 49    specified by DT.
 50 -before DT, -be DT
 51    selects any messages which were created before the date specified
 52    by DT.
 53 -date DT, -dt DT
 54    selects any messages which were created on the date specified by DT.
 55 
 56 
 57 -between_time DT1 DT2, -btt DT1 DT2
 58    selects any messages which were created between the date/times
 59    specified by DT1 and DT2 inclusively.
 60 -before_time DT, -bet DT
 61    selects any messages which were created before the date/time
 62    specified by DT.
 63 -after_time DT, -aft DT
 64    selects any messages which were created after the date/time
 65    specified by DT.
 66 
 67 
 68 -from address,
 69 -from /STR/,
 70 -fm address,
 71 -fm /STR/
 72    selects any messages whose From field either contains the specified
 73    address or matches the given qedx regular expression.
 74 -reply_to address,
 75 -reply_to /STR/,
 76 -rpt address,
 77 -rpt /STR/
 78    selects any messages whose Reply-To field either contains the
 79    specified address or matches the given qedx regular expression.
 80 
 81 
 82 -recipient address,
 83 -recipient /STR/,
 84 -rcp address,
 85 -rcp /STR/
 86    selects any messages whose To, cc, bcc, or Redistributed-To fields
 87    either contains the specified address or matches the given qedx
 88    regular expression.
 89 -to address, -to /STR/
 90    selects any messages whose To field either contains the specified
 91    address or matches the given regular expression.
 92 -cc address, -cc /STR/
 93    selects any messages whose cc field either contains the specified
 94    address or matches the given qedx regular expression.
 95 
 96 
 97 -bcc address, -bcc /STR/
 98    selects any messages whose bcc field either contains the specified
 99    address or matches the given qedx regular expression.
100 -forwarded_to address,
101 -forwarded_to /STR/,
102 -fwdt address,
103 -fwdt /STR/
104    selects any messages whose Redistributed-To field either contains
105    the specified address or matches the given qedx regular expression.