man5-editing-pass-20051213
[openafs.git] / doc / man-pages / pod5 / UserList.pod
index f5ac45f..268c8c7 100644 (file)
@@ -4,51 +4,46 @@ UserList - Defines privileged administrators
 
 =head1 DESCRIPTION
 
-The UserList file lists the AFS usernames of the system
-administrators authorized to issue privileged B<bos>, B<vos>,
-and B<backup> commands that affect the local server machine or the
-volumes housed on it. It must reside in the B</usr/afs/etc>
-directory on every server machine.
+The F<UserList> file lists the AFS usernames of the system administrators
+authorized to issue privileged B<bos>, B<vos>, and B<backup> commands that
+affect the local server machine or the volumes housed on it. It must
+reside in the F</usr/afs/etc> directory on every server machine.
 
-Although the UserList file is in ASCII format, do not use a text
-editor to alter it. Instead always use the appropriate commands from
-the B<bos> command suite: 
+Although the F<UserList> file is in ASCII format, do not use a text editor
+to alter it. Instead always use the appropriate commands from the B<bos>
+command suite:
 
 =over 4
 
 =item *
 
-The bos adduser command to add a user to the file
-
+The B<bos adduser> command to add a user to the file.
 
 =item *
 
-The bos listusers command to display the contents of the file
-
+The B<bos listusers> command to display the contents of the file.
 
 =item *
 
-The bos removeuser command to remove a user from the file
-
+The B<bos removeuser> command to remove a user from the file.
 
 =back
 
 Although it is theoretically possible to list different administrators in
-the B<UserList> files on different server machines, doing so can cause
-unanticipated authorization failures and is not recommended. In cells
-that run the United States edition of AFS and use the Update Server to
-distribute the contents of the B</usr/afs/etc> directory, it is
-customary to edit only the copy of the file stored on the system control
-machine. In cells that run the international version of AFS, edit the
-file on each server machine individually.
+the F<UserList> files on different server machines, doing so can cause
+unanticipated authorization failures and is not recommended. In cells that
+use the Update Server to distribute the contents of the F</usr/afs/etc>
+directory, it is customary to edit only the copy of the file stored on the
+system control machine. Otherwise, edit the file on each server machine
+individually.
 
 =head1 SEE ALSO
 
-L<bos_adduser(1)>,
-L<bos_listusers(1)>,
-L<bos_removeuser(1)>,
-L<upclient(1)>,
-L<upserver(1)>
+L<bos_adduser(8)>,
+L<bos_listusers(8)>,
+L<bos_removeuser(8)>,
+L<upclient(8)>,
+L<upserver(8)>
 
 =head1 COPYRIGHT