1 6/29/85  forum request:  mail
  2 
  3 
  4 Syntax:  mail {trans_specs} {-control_args}
  5 
  6 
  7 Function:  sends a transaction or set of transactions to other users,
  8 mailing lists, or Forum meetings using the Multics mail system.
  9 
 10 
 11 Arguments:
 12 trans_specs
 13    are transaction specifiers which determine the transactions to be
 14    mailed.  Use the forum request "help trans_specs" for more
 15    information on transaction specifiers.  If no transaction
 16    specifiers are supplied,  the unprocessed transaction is mailed if
 17    there is one, otherwise the current transaction is mailed.  If more
 18    than one transaction is specified, each one is sent as a separate
 19    piece of mail.
 20 
 21 
 22 Control arguments:
 23 -acknowledge, -ack
 24    requests an acknowledging message from the recipients when they
 25    read the mail.
 26 -bcc addresses
 27    specifies recipients who will receive blind carbon copies of the
 28    mail.  For information on addresses, type "help addresses.gi".
 29 -brief, -bf
 30    suppresses messages informing the user of successful mail delivery.
 31 -cc addresses
 32    specifies recipients who will receive carbon copies of the mail.
 33    For information on addresses, type "help addresses.gi".
 34 -fill, -fi
 35    specifies that the transactions should be filled before being
 36    mailed.
 37 
 38 
 39 -line_length LEN, -ll LEN
 40    specifies the line length to be used for filling.  If this control
 41    argument is given, -fill need not be.
 42 -long, -lg
 43    prints messages informing the user of successful mail delivery.
 44    (Default)
 45 -new_subject STR, -newsj STR
 46    sets the subject of the mail to be STR.  The default subject is the
 47    subject of the transaction being mailed.
 48 -no_acknowledge, -nack
 49    does not request acknowledging messages from the recipients
 50    (Default)
 51 
 52 
 53 -no_fill, -nfi
 54    does not fill the transactions before mailing them.  (Default)
 55 -reply_to addresses
 56    specifies the return address which will appear in the Reply-To
 57    field of the mail. For information on addresses, type
 58    "help addresses.gi".
 59 -to addresses
 60    specifies the primary recipients of the mail.  For information on
 61    addresses, type "help addresses.gi".
 62 
 63 
 64 List of transaction specification control arguments:
 65 -after DT, -af DT
 66    selects transactions entered on or after the the date specified.
 67    The time of day is ignored.
 68 -after_time DT, -aft DT
 69    selects transactions entered after the date_time specified.
 70 -before DT, -be DT
 71    selects transactions entered before the date specified. The time
 72    of day is ignored.
 73 -before_time DT, -bet DT
 74    selects transactions entered before the date_time specified.
 75 -between DT1 DT2, -bt DT1 DT2
 76    selects transactions entered between the dates specified,
 77    inclusive.  The times of day are ignored.
 78 
 79 
 80 -between_time DT1 DT2, -btt DT1 DT2
 81    selects transactions entered between the date_times specified,
 82    inclusive.
 83 -date DT, -dt DT
 84    selects transactions entered on the day specified.
 85 -from Person_id, -fm Person_id
 86    selects transactions entered by the participant named Person_id.
 87 -subject /regexp/, -sj /regexp/
 88    selects transactions whose subjects match the given regular
 89    expression.
 90 -text /regexp/, -tx /regexp/
 91    selects transactions whose text match the given regular
 92    expression.
 93 
 94 
 95 Notes:
 96 One or more of the control arguments -to, -bcc, and -cc must be given.
 97 
 98 The mail contains three header fields identifying it as having been
 99 sent by forum.  These fields are:
100   Forum-Transaction:  [NNNN] in the MEETING_PATH meeting.
101   Transaction-Entered-By:  AUTHOR
102   Transaction-Entered-Date: DATE_TIME