X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?a=blobdiff_plain;ds=sidebyside;f=doc%2Fpod%2Finnupgrade.pod;fp=doc%2Fpod%2Finnupgrade.pod;h=0000000000000000000000000000000000000000;hb=b7a32e2d73e3ab1add8208d3e157f7269a31ef4d;hp=656f05b25827fdc66d849df93652def466b9f0c7;hpb=ac902a8299ff4469b356836f431ead31c3377377;p=innduct.git diff --git a/doc/pod/innupgrade.pod b/doc/pod/innupgrade.pod deleted file mode 100644 index 656f05b..0000000 --- a/doc/pod/innupgrade.pod +++ /dev/null @@ -1,85 +0,0 @@ -=head1 NAME - -innupgrade - Upgrade INN configuration files - -=head1 SYNOPSIS - -B I - -B [B<-t> I] B<-f> I - -=head1 DESCRIPTION - -B is intended to be run during a major upgrade of INN to fix -the configuration files with any required changes. If given a directory, -it will scan that directory for any files that it has updates defined for, -try to perform those updates, and replace the files with updated versions -if applying the updates resulted in any changes. The old versions of the -files will be saved with a C<.OLD> extension. - -If the B<-f> flag is used, only that file will be updated. If the file -name doesn't match the standard file name of an INN configuration file, -the optional B<-t> flag may be given to specify the type. See -L<"EXAMPLES"> for an example of this. - -Currently, B knows how to apply the following updates: - -=over 2 - -=item * - -F: Quote values with whitespace and comment out keys with no -values, required for the change in configuration parsers introduced in INN -2.4. The new format is not backward compatible with the previous parser, -since the previous parser will include the double-quotes in the value of -the parameter. - -=back - -Normally, B should be run on the I directory after -any upgrade of INN other than a patch release (any upgrade that changes -the first or second version numbers). This may occur automatically during -the upgrade process. - -=head1 OPTIONS - -=over 4 - -=item B<-f> I - -Only act on I rather than working on an entire directory. - -=item B<-t> I - -For a file specified with B<-f>, parse it and upgrade it as if it were -named I. Used for upgrading files with the same syntax as normal -INN configuration files but with different names. Only makes sense in -combination with B<-f>. - -=back - -=head1 EXAMPLES - -Upgrade any configuration files found in F: - - innupgrade /usr/local/news/etc - -Upgrade only F: - - innupgrade -f /news/etc/inn.conf - -Upgrade a file named F that should have the same syntax -as F: - - innupgrade -t inn.conf -f inn-special.conf - -Any upgrade rules that apply to F will be applied to the -alternate file. - -=head1 HISTORY - -Written by Russ Allbery for InterNetNews. - -$Id: innupgrade.pod 5909 2002-12-03 05:17:18Z vinocur $ - -=cut