man1-editing-pass-20051209

[openafs.git] / doc / man-pages / pod1 / unlog.pod

diff --git a/doc/man-pages/pod1/unlog.pod b/doc/man-pages/pod1/unlog.pod
index b58364a..da06516 100644 (file)
--- a/doc/man-pages/pod1/unlog.pod
+++ b/doc/man-pages/pod1/unlog.pod
@@ -4,44 +4,43 @@ unlog - Discards all of the issuer's tokens
 
 =head1 SYNOPSIS
 
-B<unlog> [B<-cell> <I<cell name>>+]  [-help]
+B<unlog> [B<-cell> <I<cell name>>+] [B<-help>]
 
-B<unlog> [B<-c ><I<cell name>>+]  [-h]
+B<unlog> [B<-c ><I<cell name>>+] [B<-h>]
 
 =head1 DESCRIPTION
 
-The unlog command by default discards all tokens that the issuer
-currently holds. To discard tokens for certain cells only, name them
-with the B<-cell> argument.
+The B<unlog> command by default discards all tokens that the issuer
+currently holds. To discard tokens for certain cells only, name them with
+the B<-cell> argument.
 
-Since a token pertains to one client machine only, destroying tokens on one
-machine has no effect on tokens on another machine.
+Since a token pertains to one client machine only, destroying tokens on
+one machine has no effect on tokens on another machine.
 
-=head1 CAVEATS
+=head1 CAUTIONS
 
 Specifying one or more cell names can cause a brief authentication outage
-during which the issuer has no valid tokens in any cell. This is
-because the command actually discards all tokens and then restores the ones
-for cells not named by the B<-cell> argument. The outage can
-sometimes interrupt the operation of jobs that require authentication.
+during which the issuer has no valid tokens in any cell. This is because
+the command actually discards all tokens and then restores the ones for
+cells not named by the B<-cell> argument. The outage can sometimes
+interrupt the operation of jobs that require authentication.
 
 =head1 OPTIONS
 
 =over 4
 
-=item -cell
+=item B<-cell> <I<cell name>>+
 
-Specifies each cell for to discard the token. If this argument is
-omitted, the Cache Manager discards all tokens. Provide the fully
-qualified domain name, or a shortened form, in which case successful
-resolution depends on the availability of a name resolution service (such as
-the Domain Name Service or a local host table) at the time the command is
-issued.
+Specifies each cell for to discard the token. If this argument is omitted,
+the Cache Manager discards all tokens. Provide the fully qualified domain
+name, or a shortened form, in which case successful resolution depends on
+the availability of a name resolution service (such as the Domain Name
+Service or a local host table) at the time the command is issued.
 
-=item -help
+=item B<-help>
 
-Prints the online help for this command. All other valid options
-are ignored.
+Prints the online help for this command. All other valid options are
+ignored.
 
 =back
 
@@ -51,8 +50,8 @@ The following command discards all tokens.
 
    % unlog
 
-The following command discards only the tokens for the
-B<abc.com> and B<stateu.edu> cells.
+The following command discards only the tokens for the C<abc.com> and
+C<stateu.edu> cells.
 
    % unlog -cell abc.com stateu