Patch to upgrade_MailScanner_conf to provide POD documentation (man page)

James Pattie james at PCXPERIENCE.COM
Tue Oct 28 18:24:47 GMT 2003

Hash: SHA1


        Attached is a first draft of POD documentation for upgrade_MailScanner_conf
that will allow a man page to be generated so that the Debian maintainer of the
mailscanner package will include the upgrade_MailScanner_conf script in the
.deb.  :)

        Please review and give corrections if needed or approval (Julian) before I
submit the changes to the Debian maintainer.

        to view the results at the command line use: pod2text upgrade_MailScanner_conf
        and you you see the output as it will end up, but without any hilighting, etc.
~ You can also feed it through pod2man, pod2html, etc.


Version: GnuPG v1.0.7 (GNU/Linux)
Comment: Using GnuPG with Mozilla -


This message has been scanned for viruses and
dangerous content by MailScanner, and is
believed to be clean.
MailScanner thanks transtec Computers for their support.

-------------- next part --------------
--- upgrade_MailScanner_conf.orig       2003-10-27 15:20:52.000000000 -0600
+++ upgrade_MailScanner_conf    2003-10-27 15:29:15.000000000 -0600
@@ -42,6 +42,56 @@
 use FileHandle;
 use strict;

+=head1 NAME
+upgrade_MailScanner_conf - upgrades MailScanner.conf config files
+=head1 SYNOPSIS
+If you are using the RPM distributions then try this:
+cd /etc/MailScanner
+upgrade_MailScanner_conf MailScanner.conf MailScanner.conf.rpmnew >
+mv MailScanner.conf MailScanner.old
+mv  MailScanner.conf
+If you are using the tar distribution so that the old version is in
+/opt/MailScanner and the new one is in /opt/ then:
+cd /opt/
+../bin/upgrade_MailScanner_conf /opt/MailScanner/etc/MailScanner.conf /opt/ >
+mv MailScanner.conf MailScanner.old
+mv  MailScanner.conf
+upgrade_MailScanner_conf helps automate the conversion of older MailScanner.conf config
+files to the version of MailScanner you are installing.  This takes care of adding any
+new config items that need to be added, removing old deprecated items and updating the
+comments, unless you specify --keep-comments to signal you want your old comments left.
+Using --keep-comments can cause you to not realize that there are new/more options
+available to you for the item that your old comment was kept with.
+=head1 AUTHOR
+Julian Field (mailto: Jules at )
+=head1 SEE ALSO
+perl(1), MailScanner(3)
 sub Usage {
   print STDERR <<EOU;

More information about the MailScanner mailing list