Title: Perl 5.12 upgrade procedure
Author: perl-team <perl@gentoo.org>
Author: Torsten Veller <tove@gentoo.org>
Content-Type: text/plain
Posted: 2010-10-22
Revision: 1
News-Item-Format: 1.0
Display-If-Installed: <dev-lang/perl-5.12

==> Run `perl-cleaner --all` after upgrading to a new Perl version! <==

"Perl 5.12 is not binary compatible with prior releases of Perl. If
you have built extensions (i.e. modules that include C code) using an
earlier version of Perl, you will need to rebuild and reinstall those
extensions." [1]

In fact, in Gentoo you currently have to rebuild all Perl modules and
all binaries linking libperl to get into a consistent state again.

perl-cleaner generates a list of broken packages and passes it to your
package manager to reinstall them. After reinstalling the packages,
perl-cleaner outputs a list of files the script could not deal with
(like modules installed not via the package manager).

See `man perl-cleaner` for its options.

[1] http://search.cpan.org/dist/perl-5.12.2/INSTALL#Changes_and_Incompatibilities