.SH NAME
chpobox \- change address at which user receives mail
.SH SYNOPSIS
-.B chpobox
-[
-.B username
-]
-
-or
-
-.B chpobox
-[ \-s
-.B address
-] [ \-p ] [ -u
-.B username
-]
-
+.TP 8
+chpobox [ username ]
+.TP 8
+chpobox [ \-s address | \-S address | \-p ] [ \-u username ]
.SH DESCRIPTION
Your post office box is what determines where you will receive
-mail. It can be of two types:
-.I POP,
-which is what you have by default, or
-.I SMTP
-which allows you to specify an alternate address for your mail.
+mail. It can be of several types:
+.I POP, IMAP, SMTP, SPLIT
+or
+.IR NONE .
In the first use of this command, the post office box of the
user whose name corresponds to the single argument
In the second use, this command sets the
actual address that will receive mail sent to
-.I username@ATHENA.MIT.EDU
+.I username@MIT.EDU
(where
.I username
is your own name if you have not specified it on the command line).
which would be used with standard UNIX mail.
In order to change the address that receives mail sent to
-.I username@ATHENA.MIT.EDU,
+.I username@MIT.EDU,
use the
.B -s
option. Specifically, to reroute your mail to
.nf
.nj
-chpobox -s name@host.
+chpobox -s name@host
.fi
+To split mail between your local post office box and a remote address,
+use the
+.B -S
+option.
+
To restore your post office box to its original Athena default,
use the
.B -p
-flag. This will set your mailbox to the last post office server
+flag. This will set your mailbox to the last POP or IMAP server
it was using.
.PP
.B -p
or
.B -s
+or
+.B -S
may be used at a time.
-Note that the actual change will not take place on the mail hub
-for several hours.
-
-Regular users may change and retrieve information about only
-their own post office boxes. Moira database administrators can
-change or retrieve information about any user's post office box,
-specifying the user with the
-.B -u
-option.
+Note that the actual change may take up to a day to
+propogate to the mail hub.
.SH NOTE
in double-quotes. For example, the command
.nf
.nj
- chpobox -s jrhacker@\\"lcs.mit.edu\\"
+ chpobox -s jrhacker@\\"cd.mit.edu\\"
.fi
-will not be canonicalized to jrhacker@ptt.lcs.mit.edu, as it would
+will not be canonicalized to jrhacker@ls.mit.edu, as it would
otherwise. Also note that the double-quotes were preceded by
backslashes to get them past the shell.