Remove references to AFS Product Support in -oktozap
authorRuss Allbery <rra@stanford.edu>
Wed, 26 May 2010 16:33:29 +0000 (11:33 -0500)
committerDerrick Brashear <shadow@dementia.org>
Wed, 26 May 2010 16:39:47 +0000 (09:39 -0700)
salvager and salvageserver's documentation of -oktozap says to not use
without consultation with AFS Development or Product Support, left over
from the IBM product.  Remove those references and add a caution more
in line with open source.

Change-Id: I136dc145caf3e8e3a992c239e1a46d86f96580ed
Reviewed-on: http://gerrit.openafs.org/2030
Reviewed-by: Derrick Brashear <shadow@dementia.org>
Tested-by: Derrick Brashear <shadow@dementia.org>
Reviewed-by: Jeffrey Altman <jaltman@openafs.org>

doc/man-pages/README
doc/man-pages/pod8/salvager.pod
doc/man-pages/pod8/salvageserver.pod

index 00577de..fb1f017 100644 (file)
@@ -230,10 +230,8 @@ Known Problems
   don't just report the deficiency again, but any contributions towards
   fixing it are greatly appreciated.
 
-   * There are lingering references to AFS Development or AFS Product
-     Support in descriptions of options that one should generally not
-     use.  Also, all of the manual references refer to the "IBM" manual.
-     We should decide how to handle this terminology-wise.
+   * All of the manual references refer to the "IBM" manual.  We should
+     decide how to handle this terminology-wise.
 
    * The salvager actually creates a bunch of SalvageLog files and then
      combines them, but the SalvageLog man page doesn't reflect this.
index f7009c6..093483e 100644 (file)
@@ -178,9 +178,11 @@ having been active when a crash occurred.
 =item B<-oktozap>
 
 Removes a volume that is so damaged that even issuing the B<vos zap>
-command with the B<-force> flag is ineffective. Use this argument only in
-consultation with AFS Development or Product Support. Combine it with the
+command with the B<-force> flag is ineffective. Combine it with the
 B<-partition> and B<-volumeid> arguments to identify the volume to remove.
+Using this flag will destroy data that cannot be read, so use only with
+caution and when you're certain that nothing in that volume is still
+needed.
 
 =item B<-rootinodes>
 
index 26a1ee6..b48a491 100644 (file)
@@ -163,9 +163,11 @@ having been active when a crash occurred.
 =item B<-oktozap>
 
 Removes a volume that is so damaged that even issuing the B<vos zap>
-command with the B<-force> flag is ineffective. Use this argument only in
-consultation with AFS Development or Product Support. Combine it with the
+command with the B<-force> flag is ineffective. Combine it with the
 B<-partition> and B<-volumeid> arguments to identify the volume to remove.
+Using this flag will destroy data that cannot be read, so use only with
+caution and when you're certain that nothing in that volume is still
+needed.
 
 =item B<-rootinodes>