DEVEL15-man-page-afs-fixes-20080626

FIXES 104745
LICENSE BSD

Fix several issues with the afs(1) man page.  Based on the patch by Jason,
but I also documented /vicepiv as the maximum, and /vicepiu as the
maximum recommended, partition.

(cherry picked from commit e381e1d07822639ba4ce00c96ff483034104afb5)

diff --git a/doc/man-pages/pod1/afs.pod b/doc/man-pages/pod1/afs.pod
index 87166bc..764366f 100644 (file)
--- a/doc/man-pages/pod1/afs.pod
+++ b/doc/man-pages/pod1/afs.pod
@@ -31,7 +31,7 @@ Interface for tracing Cache Manager operations when debugging problems.
 =item kas
 
 Interface to the Authentication Server for administering security and
-authentication information.
+authentication information. This aspect of OpenAFS has been deprecated.
 
 =item pts
 
@@ -391,7 +391,7 @@ Partitions that house AFS volumes must have names of the form
 F</vicepI<x>> or F</vicepI<xx>>, where the variable final portion is one
 or two lowercase letters. By convention, the first server partition
 created on a file server machine is called F</vicepa>, the second
-F</vicepb>, and so on.  The I<IBM AFS Quick Beginnings> explains how to
+F</vicepb>, and so on.  The I<OpenAFS QuickStart Guide> explains how to
 configure and name a file server machine's partitions in preparation for
 storing AFS volumes on them.
 
@@ -410,6 +410,9 @@ and so on through
 
    /vicepiv    =     vicepiv     =      iv     =      255
 
+F</vicepiv> is the last permissible AFS partition name. In practice it
+will not work well; stopping with F</vicepiu> is highly recommended.
+
 =head4 Abbreviating Cell Names
 
 A cell's full name usually matches its Internet domain name (such as