README for AIX Perl 5.20.1 distribution
======================================

This README is for explaining the packaging and distribution of Perl 5.20.1
on AIX 7.2.0.0.

This version of Perl is distributed under the Artistic License.  This
license can be found in /usr/opt/perl5/Artistic.

Standard Version of the perl source code can be obtained from
www.cpan.org (http://www.cpan.org/src)

The 64-bit and 32-bit versions are packaged together with
the 32-bit version being the default version(/usr/bin/perl).

This version of Perl also supports loading of large files.
The 64-bit version was built using both maximal 64-bit support along with
64-bit integer support.

Both versions reside under /usr/opt/perl5 directory.

Both versions are perl thread capable, built using the newer ithreads
(interpreter threads) and also have builtin support for PerlIO.

Also of interest is the libperl.a library located in the following places
under /usr/opt/perl5:

        ./lib/5.20.1/aix-thread-multi/CORE/libperl.a
        ./lib64/5.20.1/aix-thread-multi-64all/CORE/libperl.a

Applications which depends on 64-bit version of perl must use /usr/bin/perl64
and 32-bit applications must use /usr/bin/perl32 or
/usr/bin/perl as it has always been.If an application has always used /usr/bin/perl
as 32-bit, it would continue to work as it always has.

If changes have been made to defualt perl links which are installed by the package
then one can run /usr/opt/perl5/link_perl_32 script to retain the original links.

NOTE: You must run the scripts as root for it to work.

END_OF_FILE