NAME

perl-after-upgrade -- fixup FreeBSD packages that depend on perl

SYNOPSIS

  perl-after-upgrade
  perl-after-upgrade -f

DESCRIPTION

The standard procedure after a perl port (either lang/perl5 or lang/perl5.8) upgrade is to basically reinstall all other packages that depend on perl. This is always a painful exercise. The perl-after-upgrade utility makes this process mostly unnecessary.

The tool goes through the list of installed packages, looks for those that depend on perl, moves files around, modifies shebang lines in those scripts in which it is necessary to do so, tries its best to adjust dynamically linked binaries that link with libperl.so in the old path, and updates the package database.

The correct way of using the tool is:

o go root;
o make sure the existing dependencies are in order.: Use pkgdb utility from sysutils/portupgrade (pkgdb -F);
o build an up-to-date perl port;
o remove your old perl;
o install your new perl;
o run perl-after-upgrade utility.: Do not specify any arguments at first, so it does nothing. Pay attention to the produced output and especially to errorlist at the end, if any;
o run the utility again, with -f command line option.: This will actually do the work. Again, pay attention to the output produced;
o fix any reported errors;
o review the files left in the older perl installation.: This is typically /usr/local/lib/perl5/site_perl/5.X.Y/. There should be very little, if any, files in that directory and its subdirectories, excepting any modules installed from CPAN and a number of .ph files;
o check that things work as they should;
o remove backup files from the package database.: Those will be /var/db/pkg/*/+CONTENTS.bak;
o run pkgdb -F again.: It might fixup a couple of things automatically.
o note which perl modules installed from CPAN you will want to reinstall;
o that's all.

BUGS

The perl-after-upgrade script does not handle perl modules installed via CPAN.

COPYRIGHT AND LICENSE

 "THE BEER-WARE LICENSE" (Revision 42)
 <tobez@FreeBSD.org> wrote this module.  As long as you retain this
 notice you can do whatever you want with this stuff. If we meet some
 day, and you think this stuff is worth it, you can buy me a beer in
 return.

 Anton Berezin

NO WARRANTY OF ANY KIND, USE AT YOUR OWN RISK.

CREDITS