1 10/20/83  read_mail request:  copy, cp
 2 
 3 Syntax:  cp {message_specifiers} path {-control_args}
 4 
 5 
 6 Function:  copies the specified messages into another mailbox.
 7 
 8 
 9 Arguments:
10 message_specifiers
11    identifies which messages are to be copied.  If no
12    message_specifiers are supplied, the current message is copied.  For
13    more information on message specifiers, type:
14          help message_specifiers.gi
15 path
16    is the pathname of the mailbox to which the messages are copied.
17    The suffix "mbx" is added if necessary.  The specified mailbox must
18    already exist.
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 copied.
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 copied.
35 -no_delete, -ndl
36    does not mark the messages for deletion.  (Default)
37 -reverse, -rv
38    copies the messages in descending numeric order.
39 -no_reverse, -nrv
40    copies the messages in ascending numeric order.  (Default)
41 
42 
43 
44 Notes:
45 This request will acknowledge any messages requiring acknowledgement
46 unless -no_acknowledge is specified on the read_mail command line.