Update the man pages to discourage use of uss

Usually the text added was a copy of a CAUTION section that
had already been added in a few places. This change applies it
consistently across all uss-related man pages. In pod1/afs.pod that
text would be excessively wordy; a briefer note is used there to
direct the reader to the full text.

This is a partial fix for RT bug #128018. It does not fully close
the bug; the AFS Administrators Guide needs to be updated as well.

Reviewed-on: http://gerrit.openafs.org/2637
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Jeffrey Altman <jaltman@openafs.org>
(cherry picked from commit 61ddfbaa19f28bd8b352dea307ab752239470026)

Change-Id: I18596dd78d0d5875d1aa442098c6bd757f496953
[sxw@your-file-system.com fixed the commit message for this pullup]
Reviewed-on: http://gerrit.openafs.org/4011
Tested-by: BuildBot <buildbot@rampaginggeek.com>
Reviewed-by: Derrick Brashear <shadow@dementia.org>

diff --git a/doc/man-pages/pod1/afs.pod b/doc/man-pages/pod1/afs.pod
index c991c78227fef93543a163e8641ec5d18d9c4bb8..9c37d1ed12bb90a255a90d0302c8fb9b33e68300 100644 (file)
--- a/doc/man-pages/pod1/afs.pod
+++ b/doc/man-pages/pod1/afs.pod
@@ -40,7 +40,9 @@ membership information.
 
 =item uss
 
-Interface for automated administration of user accounts.
+Interface for automated administration of user accounts. Deprecated, may
+be removed from a future version of OpenAFS. See B<uss> man page for more
+detail.
 
 =item vos
 
@@ -66,8 +68,8 @@ name>.
 The I<command_suite> specifies the group of related commands to which the
 command belongs, and indicates which command interpreter and server
 process perform the command.  AFS has several command suites, including
-B<bos>, B<fs>, B<kas>, B<package>, B<pts>, B<uss> and B<vos>.  Some of
-these suites have an interactive mode in which the issuer omits the
+B<bos>, B<fs>, B<kas>, B<package>, B<pts>, B<uss> (deprecated) and B<vos>.
+Some of these suites have an interactive mode in which the issuer omits the
 I<operation_code> portion of the command name.
 
 The I<operation_code> tells the command interpreter and server process

diff --git a/doc/man-pages/pod5/uss.pod b/doc/man-pages/pod5/uss.pod
index 1e4ee4c8250f4493d87cf5e86a137dabe26acc80..f0598f62b4b45647cff0ba562ec0fa127205dad4 100644 (file)
--- a/doc/man-pages/pod5/uss.pod
+++ b/doc/man-pages/pod5/uss.pod
@@ -1,6 +1,15 @@
 =head1 NAME
 
-uss - Provides instructions for the uss add command
+uss - Provides instructions for the uss add command (deprecated)
+
+=head1 CAUTIONS
+
+The B<uss> command suite is currently designed for cells using the
+obsolete Authentication Server, and therefore is primarily useful for
+sites that have not yet migrated to a Kerberos version 5 KDC. The
+Authentication Server and supporting commands will be removed in a future
+version of OpenAFS, which may include B<uss> unless someone who finds it
+useful converts it to work with a Kerberos version 5 KDC.
 
 =head1 DESCRIPTION
 

diff --git a/doc/man-pages/pod5/uss_bulk.pod b/doc/man-pages/pod5/uss_bulk.pod
index da97578214134166b8a2a5c21fead7997cdb260c..69d3a9b82c1829e1fda1e2f353efb8294682b051 100644 (file)
--- a/doc/man-pages/pod5/uss_bulk.pod
+++ b/doc/man-pages/pod5/uss_bulk.pod
@@ -2,6 +2,15 @@
 
 uss_bulk - Provides instructions for the uss bulk command
 
+=head1 CAUTIONS
+
+The B<uss> command suite is currently designed for cells using the
+obsolete Authentication Server, and therefore is primarily useful for
+sites that have not yet migrated to a Kerberos version 5 KDC. The
+Authentication Server and supporting commands will be removed in a future
+version of OpenAFS, which may include B<uss> unless someone who finds it
+useful converts it to work with a Kerberos version 5 KDC.
+
 =head1 DESCRIPTION
 
 The uss bulk input file lists instructions for the B<uss> command

diff --git a/doc/man-pages/pod8/uss.pod b/doc/man-pages/pod8/uss.pod
index 3b45590916bc8c24013c9f8874ca43724dd61d6f..f71a5a89a9f3aacf2bede24b56ef3364718e1b64 100644 (file)
--- a/doc/man-pages/pod8/uss.pod
+++ b/doc/man-pages/pod8/uss.pod
@@ -2,6 +2,15 @@
 
 uss - Introduction to the uss command suite
 
+=head1 CAUTIONS
+
+The B<uss> command suite is currently designed for cells using the
+obsolete Authentication Server, and therefore is primarily useful for
+sites that have not yet migrated to a Kerberos version 5 KDC. The
+Authentication Server and supporting commands will be removed in a future
+version of OpenAFS, which may include B<uss> unless someone who finds it
+useful converts it to work with a Kerberos version 5 KDC.
+
 =head1 DESCRIPTION
 
 The commands in the B<uss> command suite help administrators to create AFS
@@ -33,15 +42,6 @@ The B<uss delete> command removes most parts of a user account.
 
 To obtain help, issue the B<uss apropos> and B<uss help> commands.
 
-=head1 CAUTIONS
-
-The B<uss> command suite is currently designed for cells using the
-obsolete Authentication Server, and therefore is primarily useful for
-sites that have not yet migrated to a Kerberos version 5 KDC. The
-Authentication Server and supporting commands will be removed in a future
-version of OpenAFS, which may include B<uss> unless someone who finds it
-useful converts it to work with a Kerberos version 5 KDC.
-
 =head1 OPTIONS
 
 The following arguments and flags are available on many commands in the

diff --git a/doc/man-pages/pod8/uss_add.pod b/doc/man-pages/pod8/uss_add.pod
index b9027d8de223ed087865cfe57ea69b3b5aa0a508..59416012322860324482130d3d7d2ccbab771654 100644 (file)
--- a/doc/man-pages/pod8/uss_add.pod
+++ b/doc/man-pages/pod8/uss_add.pod
@@ -34,6 +34,15 @@ B<uss ad> S<<< B<-us> <I<login name>> >>> S<<< [B<-r> <I<full name in quotes>>]
 =for html
 </div>
 
+=head1 CAUTIONS
+
+The B<uss> command suite is currently designed for cells using the
+obsolete Authentication Server, and therefore is primarily useful for
+sites that have not yet migrated to a Kerberos version 5 KDC. The
+Authentication Server and supporting commands will be removed in a future
+version of OpenAFS, which may include B<uss> unless someone who finds it
+useful converts it to work with a Kerberos version 5 KDC.
+
 =head1 DESCRIPTION
 
 The B<uss add> command creates entries in the Protection Database and

diff --git a/doc/man-pages/pod8/uss_apropos.pod b/doc/man-pages/pod8/uss_apropos.pod
index 19776694002c1a2b869758a2de17b10953c48b8a..036b4731ad3b67dedf8a2c61200f02da2a2c03a4 100644 (file)
--- a/doc/man-pages/pod8/uss_apropos.pod
+++ b/doc/man-pages/pod8/uss_apropos.pod
@@ -14,6 +14,15 @@ B<uss ap> S<<< B<-t> <I<help string>> >>> [B<-h>]
 =for html
 </div>
 
+=head1 CAUTIONS
+
+The B<uss> command suite is currently designed for cells using the
+obsolete Authentication Server, and therefore is primarily useful for
+sites that have not yet migrated to a Kerberos version 5 KDC. The
+Authentication Server and supporting commands will be removed in a future
+version of OpenAFS, which may include B<uss> unless someone who finds it
+useful converts it to work with a Kerberos version 5 KDC.
+
 =head1 DESCRIPTION
 
 The B<uss apropos> command displays the first line of the online help

diff --git a/doc/man-pages/pod8/uss_bulk.pod b/doc/man-pages/pod8/uss_bulk.pod
index 6de7bbef4f843b93c07429f98b166129bbbdc1f5..b86c5d5b821e56d754176f74f5d1d91bbfd83139 100644 (file)
--- a/doc/man-pages/pod8/uss_bulk.pod
+++ b/doc/man-pages/pod8/uss_bulk.pod
@@ -24,6 +24,15 @@ B<uss b> S<<< B<-f> <I<bulk input file>> >>> S<<< [B<-t> <I<pathname of template
 =for html
 </div>
 
+=head1 CAUTIONS
+
+The B<uss> command suite is currently designed for cells using the
+obsolete Authentication Server, and therefore is primarily useful for
+sites that have not yet migrated to a Kerberos version 5 KDC. The
+Authentication Server and supporting commands will be removed in a future
+version of OpenAFS, which may include B<uss> unless someone who finds it
+useful converts it to work with a Kerberos version 5 KDC.
+
 =head1 DESCRIPTION
 
 The B<uss bulk> command executes the uss commands listed in the I<bulk

diff --git a/doc/man-pages/pod8/uss_delete.pod b/doc/man-pages/pod8/uss_delete.pod
index 1828bc71863e6772d02325016a7ac16014ee4c9f..e082e5aab626a8fd4160fde9883996e12330c9e8 100644 (file)
--- a/doc/man-pages/pod8/uss_delete.pod
+++ b/doc/man-pages/pod8/uss_delete.pod
@@ -20,6 +20,15 @@ B<uss d> S<<< B<-u> <I<login name>> >>> S<<< [B<-m> <I<mountpoint for user's vol
 =for html
 </div>
 
+=head1 CAUTIONS
+
+The B<uss> command suite is currently designed for cells using the
+obsolete Authentication Server, and therefore is primarily useful for
+sites that have not yet migrated to a Kerberos version 5 KDC. The
+Authentication Server and supporting commands will be removed in a future
+version of OpenAFS, which may include B<uss> unless someone who finds it
+useful converts it to work with a Kerberos version 5 KDC.
+
 =head1 DESCRIPTION
 
 The B<uss delete> command removes the Authentication Database and

diff --git a/doc/man-pages/pod8/uss_help.pod b/doc/man-pages/pod8/uss_help.pod
index b33792667f151115f726cd57fb112bfec45157ac..a269e82aaf71d90ca00068e757a951659b291e9b 100644 (file)
--- a/doc/man-pages/pod8/uss_help.pod
+++ b/doc/man-pages/pod8/uss_help.pod
@@ -14,6 +14,15 @@ B<uss h> S<<< [B<-t> <I<help string>>+] >>> [B<-h>]
 =for html
 </div>
 
+=head1 CAUTIONS
+
+The B<uss> command suite is currently designed for cells using the
+obsolete Authentication Server, and therefore is primarily useful for
+sites that have not yet migrated to a Kerberos version 5 KDC. The
+Authentication Server and supporting commands will be removed in a future
+version of OpenAFS, which may include B<uss> unless someone who finds it
+useful converts it to work with a Kerberos version 5 KDC.
+
 =head1 DESCRIPTION
 
 The B<uss help> command displays the complete online help entry (short