1 10/20/83  read_mail request:  log
 2 
 3 Syntax:  log {message_specifiers} {-control_args}
 4 
 5 
 6 Function:  places a copy of the specified messages into the user's
 7 "log" mailbox (logbox).
 8 
 9 
10 Arguments:
11 message_specifiers
12    identifies which messages are to be logged.  If no
13    message_specifiers are supplied, the current message is logged.  For
14    more information on message specifiers, type:
15          help message_specifiers.gi
16 
17 
18 Control arguments:
19 -include_deleted, -idl
20    includes all messages in the mailbox whether or not they have been
21    deleted when processing the message_specifiers to determine which
22    messages will be logged.
23 -only_deleted, -odl
24    includes only those messages which have been deleted.
25 -only_non_deleted, -ondl
26    includes only those messages which have not been deleted.  (Default)
27 
28 
29 -delete, -dl
30    marks the specified messages for deletion on exit from read_mail
31    if all messages are successfully logged.
32 -no_delete, -ndl
33    does not mark the messages for deletion.  (Default)
34 -reverse, -rv
35    logs the messages in descending numeric order.
36 -no_reverse, -nrv
37    logs the messages in ascending numeric order.  (Default)
38 
39 
40 Notes:
41 The user's logbox is the mailbox --
42       >udd>Project_id>Person_id>Person_id.sv.mbx
43 which will be created automatically by this request if it does not
44 already exist.  The user will be informed when the logbox is created.
45 
46 This request will acknowledge any messages requiring acknowledgement
47 unless -no_acknowledge is specified on the read_mail command line.