re-written man page by QJB

diff --git a/man/chpobox.1 b/man/chpobox.1
index 0b64b424d3c35515ea307e7650a9cfaee1ac9861..b13830d2b4dc9111991a1c5ea8e5d0c1e5a07c59 100644 (file)
--- a/man/chpobox.1
+++ b/man/chpobox.1
@@ -1,40 +1,90 @@
 .TH CHPOBOX 1 "5 Feb 1988" "Project Athena"
 \" RCSID: $Header$
 .SH NAME
-chpobox \- change where user receives mail
+chpobox \- change address at which user receives mail
 .SH SYNOPSIS
+.B chpobox 
+[
+.B username
+]
+
+or
+
 .B chpobox
-[-s address][-p][-u username]
+[ \-s 
+.B address
+] [ \-p ] [ -u 
+.B username 
+]
+
 .SH DESCRIPTION
-This command sets and displays the mailbox currently assigned to
-.IR username
-(your own name by default).
-If neither the
-.B -s
-or the
-.B -p
-option is given, the current mailbox will be displayed.  
-The
-.B -s
-option will attempt to set the user's mailbox to the specified address.
+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.
+
+In the first use of this command, the post office box of the
+user whose name corresponds to the single argument
+.I username
+(or your own name if 
+.I username
+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
+(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 
+receive mail.  
+
 The 
+.I chpobox 
+command is used instead of the file
+.I .forward,
+which would be used with standard UNIX mail. 
+
+In order to change the address that receives mail sent to 
+.I username@ATHENA.MIT.EDU,
+use the 
+.B -s
+option.  Specifically, to reroute your mail to
+the address 
+.I name@host,
+you would issue the command
+
+.nf
+.nj
+chpobox -s name@host.
+.fi
+
+To restore your post office box to its original Athena default,
+use the 
 .B -p
-flag will set the user's mailbox to the last Post Office server it was
-using if the mailbox is now a foreign address.
+flag.  This will set your mailbox to the last post office server
+it was using.
 .PP
-A mailbox address is of the form
-.I string@hostname,
-where the string is usually the username, and the hostname is the name
-of the machine the user wishes to receive mail on.
-.B chpobox
-will determine if the mailbox is of type POP, LOCAL, or FOREIGN based
-on information in the SMS database, and then make the appropriate
-change in the SMS database.
 
-It will not allow a user to have more than one mailbox of any type.
-The actual change will not take place on the mail hub for several hours.
-Users may only change their own information unless they are
-SMS database administrators.
+Only one of 
+.B -p
+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.
+
+.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
@@ -48,6 +98,8 @@ in double-quotes.  For example, the command
 will not be canonicalized to jrhacker@ptt.lcs.mit.edu, as it would
 otherwise.  Also note that the double-quotes were preceded by
 backslashes to get them past the shell.
-.SH "SEE ALSO"
-sms(1),
-SMS Section of the Project Athena Technical Plan.
+
+.SH SEE ALSO
+moira(1),
+
+Moira Section of the Project Athena Technical Plan.