From f26330904607c6c939c037587b473644deea669d Mon Sep 17 00:00:00 2001 From: Jason Edgecombe Date: Sun, 8 Apr 2012 12:10:58 -0400 Subject: [PATCH] DOC: Factored common text out of the vos_backup and vos_dump man pages Change-Id: I84bd722834297778ab2e719996b2f8528d8706d6 Reviewed-on: http://gerrit.openafs.org/7126 Reviewed-by: Simon Wilkinson Tested-by: Simon Wilkinson Reviewed-by: Jeffrey Altman Tested-by: Jeffrey Altman --- doc/man-pages/pod1/.gitignore | 2 + .../{vos_backup.pod => vos_backup.pod.in} | 42 +------------------ .../pod1/{vos_dump.pod => vos_dump.pod.in} | 42 +------------------ 3 files changed, 4 insertions(+), 82 deletions(-) rename doc/man-pages/pod1/{vos_backup.pod => vos_backup.pod.in} (60%) rename doc/man-pages/pod1/{vos_dump.pod => vos_dump.pod.in} (85%) diff --git a/doc/man-pages/pod1/.gitignore b/doc/man-pages/pod1/.gitignore index 1a1d4d6cd..9b024d68e 100644 --- a/doc/man-pages/pod1/.gitignore +++ b/doc/man-pages/pod1/.gitignore @@ -21,5 +21,7 @@ /pts_sleep.pod /pts_source.pod /vos_addsite.pod +/vos_backup.pod /vos_copy.pod +/vos_dump.pod /vos_zap.pod diff --git a/doc/man-pages/pod1/vos_backup.pod b/doc/man-pages/pod1/vos_backup.pod.in similarity index 60% rename from doc/man-pages/pod1/vos_backup.pod rename to doc/man-pages/pod1/vos_backup.pod.in index f35c6e6d1..8d0bb2a9f 100644 --- a/doc/man-pages/pod1/vos_backup.pod +++ b/doc/man-pages/pod1/vos_backup.pod.in @@ -40,47 +40,7 @@ command. Specifies either the complete name or volume ID number of the read/write source volume. -=item B<-cell> > - -Names the cell in which to run the command. Do not combine this argument -with the B<-localauth> flag. For more details, see L. - -=item B<-noauth> - -Assigns the unprivileged identity anonymous to the issuer. Do not combine -this flag with the B<-localauth> flag. For more details, see L. - -=item B<-localauth> - -Constructs a server ticket using a key from the local -F file. The B command interpreter presents it -to the Volume Server and Volume Location Server during mutual -authentication. Do not combine this flag with the B<-cell> argument or -B<-noauth> flag. For more details, see L. - -=item B<-verbose> - -Produces on the standard output stream a detailed trace of the command's -execution. If this argument is omitted, only warnings and error messages -appear. - -=item B<-encrypt> - -Encrypts the command so that the operation's results are not transmitted -across the network in clear text. This option is available in OpenAFS -versions 1.4.11 or later and 1.5.60 or later. - -=item B<-noresolve> - -Shows all servers as IP addresses instead of the DNS name. This is very -useful when the server address is registered as 127.0.0.1 or when dealing -with multi-homed servers. This option is available in OpenAFS -versions 1.4.8 or later and 1.5.35 or later. - -=item B<-help> - -Prints the online help for this command. All other valid options are -ignored. +=include fragments/vos-common.pod =back diff --git a/doc/man-pages/pod1/vos_dump.pod b/doc/man-pages/pod1/vos_dump.pod.in similarity index 85% rename from doc/man-pages/pod1/vos_dump.pod rename to doc/man-pages/pod1/vos_dump.pod.in index eb226095c..39ab52dbb 100644 --- a/doc/man-pages/pod1/vos_dump.pod +++ b/doc/man-pages/pod1/vos_dump.pod.in @@ -152,47 +152,7 @@ dump and not cause problems if the incremental is restored, as expected, on top of a volume containing the correct directory structure (such as one created by restoring previous full and incremental dumps). -=item B<-cell> - -Names the cell in which to run the command. Do not combine this argument -with the B<-localauth> flag. For more details, see L. - -=item B<-noauth> - -Assigns the unprivileged identity anonymous to the issuer. Do not combine -this flag with the B<-localauth> flag. For more details, see L. - -=item B<-localauth> - -Constructs a server ticket using a key from the local -F file. The B command interpreter presents it -to the Volume Server and Volume Location Server during mutual -authentication. Do not combine this flag with the B<-cell> argument or -B<-noauth> flag. For more details, see L. - -=item B<-verbose> - -Produces on the standard error stream a detailed trace of the command's -execution. If this argument is omitted, only warnings and error messages -appear. - -=item B<-encrypt> - -Encrypts the command so that the operation's results are not transmitted -across the network in clear text. This option is available in OpenAFS -versions 1.4.11 or later and 1.5.60 or later. - -=item B<-noresolve> - -Shows all servers as IP addresses instead of the DNS name. This is very -useful when the server address is registered as 127.0.0.1 or when dealing -with multi-homed servers. This option is available in OpenAFS -versions 1.4.8 or later and 1.5.35 or later. - -=item B<-help> - -Prints the online help for this command. All other valid options are -ignored. +=include fragments/vos-common.pod =back -- 2.39.5