From 96d04df40e518c5373ceb6686fef1f115cbbdd12 Mon Sep 17 00:00:00 2001 From: Russ Allbery Date: Thu, 29 Nov 2007 05:17:29 +0000 Subject: [PATCH 1/1] DEVEL15-man-fs-uuid-tweaks-20071128 Some minor capitalization and formatting tweaks to the fs uuid man page. (cherry picked from commit 5743116d700ce279cde3a8dee962757df509d557) --- doc/man-pages/pod1/fs_uuid.pod | 31 +++++++++++++++---------------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/doc/man-pages/pod1/fs_uuid.pod b/doc/man-pages/pod1/fs_uuid.pod index 90c0d1e..9d6a2c1 100644 --- a/doc/man-pages/pod1/fs_uuid.pod +++ b/doc/man-pages/pod1/fs_uuid.pod @@ -14,18 +14,18 @@ B [B<-generate>] [B<-help>] =head1 DESCRIPTION -B prints the current uuid of an OpenAFS client. It can -optionally force the generation of a new uuid, if needed. The client -uuid is used by the B to differentiate clients with the -same IP address. +B prints the current UUID of an OpenAFS client. It can +optionally force the generation of a new UUID, if needed. The client UUID +is used by the B to differentiate clients with the same IP +address. =head1 CAUTIONS -The B command is only available in OpenAFS versions after -1.4.5 and 1.5.8. The behavior differs slightly between versions. In -OpenAFS 1.4.5 and later, the B<-generate> option is required and the -uuid for the client machine is never printed. OpenAFS versions 1.5.8 -and later will print the uuid. +The B command is only available in OpenAFS versions after 1.4.5 +and 1.5.8. The behavior differs slightly between versions. In OpenAFS +1.4.5 and later, the B<-generate> option is required and the UUID for the +client machine is never printed. OpenAFS versions 1.5.8 and later will +print the UUID. =head1 OPTIONS @@ -33,21 +33,21 @@ and later will print the uuid. =item B<-generate> -Generates a new uuid for the cache manager. This is useful if two -clients share the same uuid. B<-generate> is optional in OpenAFS -versions 1.5.8 and later, but it is required in OpenAFS versions 1.4.5 -and later. +Generates a new UUID for the cache manager. This is useful if two clients +share the same UUID (if systems were cloned incorrectly, for example). +B<-generate> is optional in OpenAFS versions 1.5.8 and later, but it is +required in OpenAFS versions 1.4.5 and later. =item B<-help> -Prints the online help for this command. All other valid options are +Prints the online help for this command. All other valid options are ignored. =back =head1 OUTPUT -B prints out the current uuid for the client or the new uuid +B prints out the current UUID for the client or the new UUID if the B<-generate> option is passed to it. =head1 EXAMPLES @@ -65,7 +65,6 @@ Here is the only way to invoke B under OpenAFS 1.4.5 and later: % fs uuid -generate New uuid generated. - =head1 PRIVILEGE REQUIRED The issuer must be logged on as the local superuser C. -- 1.9.4