doc: document the version subcommand

Document the built-in version sub-command which displays
the OpenAFS version string. This sub-command is provided
by the cmd library.

Document the switch style -version option provided by the cmd
library for the initcmd based commands: afsmonitor, scout,
xstat_fs_test, and xstat_cm_test.

Change-Id: Id421d2c68a5c49a2b1a5abb2f3e9ca64ea36cd3e
Reviewed-on: http://gerrit.openafs.org/11161
Reviewed-by: Benjamin Kaduk <kaduk@mit.edu>
Tested-by: BuildBot <buildbot@rampaginggeek.com>

diff --git a/doc/man-pages/pod1/afsmonitor.pod b/doc/man-pages/pod1/afsmonitor.pod
index 127f217cbb1e7dcc96a9fa1f97a02de552069323..67bcc379f36b4b199fe9d0d3966badfbb4b98e2e 100644 (file)
--- a/doc/man-pages/pod1/afsmonitor.pod
+++ b/doc/man-pages/pod1/afsmonitor.pod
@@ -13,7 +13,7 @@ B<afsmonitor> [B<initcmd>] [-config <I<configuration file>>]
     S<<< [B<-debug> <I<debug output file>>] >>>
     S<<< [B<-fshosts> <I<list of file servers to monitor>>+] >>>
     S<<< [B<-cmhosts> <I<list of cache managers to monitor>>+] >>>
-    S<<< [B<-buffers> <I<number of buffer slots>>] >>> [B<-help>]
+    S<<< [B<-buffers> <I<number of buffer slots>>] >>> [B<-version>] [B<-help>]
 
 B<afsmonitor> [B<i>]  [-co <I<configuration file>>]
     S<<< [B<-fr> <I<poll frequency, in seconds>>] >>>
@@ -21,7 +21,7 @@ B<afsmonitor> [B<i>]  [-co <I<configuration file>>]
     S<<< [B<-deb> <I<debug output file>>] >>>
     S<<< [B<-fs> <I<list of file servers to monitor>>+] >>>
     S<<< [B<-cm> <I<list of cache managers to monitor>>+] >>>
-    S<<< [B<-b> <I<number of buffer slots>>] >>> [B<-h>]
+    S<<< [B<-b> <I<number of buffer slots>>] >>> [B<-version>] [B<-h>]
 
 =for html
 </div>
@@ -173,6 +173,11 @@ file.
 Prints the online help for this command. All other valid options are
 ignored.
 
+=item B<-version>
+
+Prints the program version and then exits. All other valid options
+are ignored.
+
 =back
 
 =head1 OUTPUT

diff --git a/doc/man-pages/pod1/fs.pod b/doc/man-pages/pod1/fs.pod
index e9887beacdd75fdcfd0c3e0f91f7747b9abdf41b..695277b437ab0e951c87f10e78cc51b039aa0d46 100644 (file)
--- a/doc/man-pages/pod1/fs.pod
+++ b/doc/man-pages/pod1/fs.pod
@@ -101,6 +101,10 @@ Commands to obtain help:
 L<B<fs apropos>|fs_apropos(1)>
 and L<B<fs help>|fs_help(1)>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<fs version>.
+
 =back
 
 The Cache Manager and the fs commands use and maintain the following

diff --git a/doc/man-pages/pod1/pts.pod b/doc/man-pages/pod1/pts.pod
index f3417bac1894ce29c44f214eb89e3e6f444e1860..d3a890b053db5abdc480ec628e873b156d541c5c 100644 (file)
--- a/doc/man-pages/pod1/pts.pod
+++ b/doc/man-pages/pod1/pts.pod
@@ -79,6 +79,10 @@ Commands to obtain help:
 L<B<pts apropos>|pts_apropos(1)>
 and L<B<pts help>|pts_help(1)>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<pts version>.
+
 =back
 
 =head1 OPTIONS

diff --git a/doc/man-pages/pod1/scout.pod b/doc/man-pages/pod1/scout.pod
index 3a63b1a95f62ab52ee52c96afdfde0842c7daedc..6704ba4ac335b5fcee010b72b447af3d16754022 100644 (file)
--- a/doc/man-pages/pod1/scout.pod
+++ b/doc/man-pages/pod1/scout.pod
@@ -13,13 +13,13 @@ B<scout> [B<initcmd>] S<<< B<-server> <I<servers to monitor>>+ >>>
       S<<< [B<-attention> <I<specify attention (highlighting) level>>+] >>>
       S<<< [B<-columnwidths> <I<number of characters>>+] >>>
       S<<< [B<-debug> <I<turn debugging output on to the named file>>] >>>
-      [B<-help>]
+      [B<-version>] [B<-help>]
 
 B<scout> [B<i>] S<<< B<-s> <I<servers to monitor>>+ >>>
       S<<< [B<-b> <I<base server name>>] >>> S<<< [B<-f> <I<poll frequency, in seconds>>] >>>
       [B<-ho>] S<<< [B<-a> <I<specify attention (highlighting) level>>+] >>>
       S<<< [B<-c> <I<number of characters>+>] >>>
-      S<<< [B<-d> <I<turn debugging output on to the named file>>] >>> [B<-he>]
+      S<<< [B<-d> <I<turn debugging output on to the named file>>] >>> [B<-version>] [B<-he>]
 
 =for html
 </div>
@@ -176,6 +176,11 @@ directory.
 Prints the online help for this command. All other valid options are
 ignored.
 
+=item B<-version>
+
+Prints the program version and then exits. All other valid options
+are ignored.
+
 =back
 
 =head1 OUTPUT

diff --git a/doc/man-pages/pod1/xstat_cm_test.pod b/doc/man-pages/pod1/xstat_cm_test.pod
index 06d67af248abd5e23dbcf87a1cadd4b067db9134..aaf886cb47c5b14de903a98d462e26f90a7a5b6f 100644 (file)
--- a/doc/man-pages/pod1/xstat_cm_test.pod
+++ b/doc/man-pages/pod1/xstat_cm_test.pod
@@ -12,12 +12,12 @@ B<xstat_cm_test> [I<initcmd>]
     S<<< B<-collID> <I<collection(s) to fetch>>+ >>> [B<-onceonly>]
     S<<< [B<-frequency> <I<poll frequency, in seconds>>] >>>
     S<<< [B<-period> <I<data collection time, in minutes>>] >>> [B<-debug>]
-    [B<-help>]
+    [B<-version>] [B<-help>]
 
 B<xstat_cm_test> [I<i>] S<<< B<-cm> <I<cache manager name(s) to monitor>>+ >>>
     S<<< B<-co> <I<collection(s) to fetch>>+ >>> [B<-o>]
     S<<< [B<-f> <I<poll frequency, in seconds>>] >>>
-    S<<< [B<-p> <I<data collection time, in minutes>>] >>> [B<-d>] [B<-h>]
+    S<<< [B<-p> <I<data collection time, in minutes>>] >>> [B<-d>] [B<-version>] [B<-h>]
 
 =for html
 </div>
@@ -102,6 +102,11 @@ Displays a trace on the standard output stream as the command runs.
 Prints the online help for this command. All other valid options are
 ignored.
 
+=item B<-version>
+
+Prints the program version and then exits. All other valid options
+are ignored.
+
 =back
 
 =head1 SEE ALSO

diff --git a/doc/man-pages/pod1/xstat_fs_test.pod b/doc/man-pages/pod1/xstat_fs_test.pod
index 7c2257d60ed4487699f73937fb15c800eaaa2cf2..b405cb7b11ac9e45eb85093ce84541d588f31486 100644 (file)
--- a/doc/man-pages/pod1/xstat_fs_test.pod
+++ b/doc/man-pages/pod1/xstat_fs_test.pod
@@ -10,12 +10,12 @@ xstat_fs_test - Displays data collections from the File Server process
 B<xstat_fs_test> [I<initcmd>] S<<< B<-fsname> <I<file server name(s) to monitor>>+ >>>
     S<<< B<-collID> <I<collection(s) to fetch>>+ >>> [B<-onceonly>]
     S<<< [B<-frequency> <I<poll frequency, in seconds>>] >>>
-    S<<< [B<-period> <I<data collection time, in minutes>>] >>> [B<-debug>] [B<-help>]
+    S<<< [B<-period> <I<data collection time, in minutes>>] >>> [B<-debug>] [B<-version>] [B<-help>]
 
 B<xstat_fs_test> [B<initcmd>] S<<< B<-fs> <I<File Server name(s) to monitor>>+ >>>
     S<<< B<-c> <I<Collection(s) to fetch>>+ >>> [B<-o>]
     S<<< [B<-fr> <I<poll frequency, in seconds>>] >>>
-    S<<< [B<-p> <I<data collection time, in minutes>>] >>> [B<-d>] [B<-h>]
+    S<<< [B<-p> <I<data collection time, in minutes>>] >>> [B<-d>] [B<-version>] [B<-h>]
 
 =for html
 </div>
@@ -105,6 +105,11 @@ Displays a trace on the standard output stream as the command runs.
 Prints the online help for this command. All other valid options are
 ignored.
 
+=item B<-version>
+
+Prints the program version and then exits. All other valid options
+are ignored.
+
 =back
 
 =head1 SEE ALSO

diff --git a/doc/man-pages/pod5/afsmonitor.pod b/doc/man-pages/pod5/afsmonitor.pod
index fff6263526f0e8c3419906e56b3f124d26b0036f..f5e0a607319fbc659d3edc50a968a5d42f495f4b 100644 (file)
--- a/doc/man-pages/pod5/afsmonitor.pod
+++ b/doc/man-pages/pod5/afsmonitor.pod
@@ -97,6 +97,10 @@ Precedes a line of text that the afsmonitor program ignores because of the
 initial number (C<#>) sign, which must appear in the very first column of
 the line.
 
+=item B<version>
+
+Print the OpenAFS command suite version and then exit.
+
 =back
 
 For a list of the values that can appear in the I<field/group/section>

diff --git a/doc/man-pages/pod8/backup.pod b/doc/man-pages/pod8/backup.pod
index 139ff23869b37c1a7c1ff7322bf711d1753ac9ea..f8e2ebcc3fb83b29e3daaae9d38c57237d0a9bd1 100644 (file)
--- a/doc/man-pages/pod8/backup.pod
+++ b/doc/man-pages/pod8/backup.pod
@@ -72,6 +72,10 @@ Commands to obtain help:
 L<B<backup apropos>|backup_apropos(8)>
 and L<B<backup help>|backup_help(8)>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<backup version>.
+
 =back
 
 The backup command interpreter interacts with two other processes:

diff --git a/doc/man-pages/pod8/bos.pod b/doc/man-pages/pod8/bos.pod
index 7cb3284c5ce325b1723bf7862082040f35148269..70f912667f1a2c7bd18d310259c3212277a2917a 100644 (file)
--- a/doc/man-pages/pod8/bos.pod
+++ b/doc/man-pages/pod8/bos.pod
@@ -47,6 +47,10 @@ A command to restore file system consistency: B<bos salvage>.
 
 Commands to obtain help: B<bos apropos> and B<bos help>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<bos version>.
+
 =back
 
 The BOS Server and the B<bos> commands use and maintain the following

diff --git a/doc/man-pages/pod8/kas.pod b/doc/man-pages/pod8/kas.pod
index 43eb1d0c720a95a753daeba498b70ca76e0a9328..afeb12dbfbca01637290e41ce3c4c0af6e36e53a 100644 (file)
--- a/doc/man-pages/pod8/kas.pod
+++ b/doc/man-pages/pod8/kas.pod
@@ -53,6 +53,10 @@ Commands to obtain help:
 L<B<kas apropos>|kas_apropos(8)>
 and L<B<kas help>|kas_help(8)>.
 
+=item *
+
+A command to display the OpenAFS command suite version: B<kas version>.
+
 =back
 
 Because of the sensitivity of information in the Authentication Database,