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