Command line printer manipulation client, and build goo.

[moira.git] / man / chpobox.1

diff --git a/man/chpobox.1 b/man/chpobox.1
index b13830d2b4dc9111991a1c5ea8e5d0c1e5a07c59..3bc199b9bf6e37f5fa453c9b767424fc2c0a87ff 100644 (file)
--- a/man/chpobox.1
+++ b/man/chpobox.1
@@ -3,27 +3,16 @@
 .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
@@ -34,11 +23,11 @@ is not specified) is displayed.
 
 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).
-It should be if you want to change where you will 
+It should be used if you want to change where you will 
 receive mail.  
 
 The 
@@ -48,7 +37,7 @@ command is used instead of the file
 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
@@ -58,13 +47,18 @@ you would issue the command
 
 .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
 
@@ -72,30 +66,25 @@ Only one of
 .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
 
 When a mailbox is stored in the central database, any host mentioned
-will have it's name canonicalized to a standard form.  If for some
+will have its name canonicalized to a standard form.  If for some
 reason you don't want to have the hostname canonicalized, put
 .B just the hostname
 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.