INSTALL (perl-5.30.2.tar.xz) | : | INSTALL (perl-5.30.3.tar.xz) | ||
---|---|---|---|---|
skipping to change at line 612 | skipping to change at line 612 | |||
distributions or who export perl to a range of systems will probably | distributions or who export perl to a range of systems will probably | |||
need to alter them. If you are content to just accept the defaults, | need to alter them. If you are content to just accept the defaults, | |||
you can safely skip the next section. | you can safely skip the next section. | |||
The directories set up by Configure fall into three broad categories. | The directories set up by Configure fall into three broad categories. | |||
=over 4 | =over 4 | |||
=item Directories for the perl distribution | =item Directories for the perl distribution | |||
By default, Configure will use the following directories for 5.30.2. | By default, Configure will use the following directories for 5.30.3. | |||
$version is the full perl version number, including subversion, e.g. | $version is the full perl version number, including subversion, e.g. | |||
5.12.3, and $archname is a string like sun4-sunos, | 5.12.3, and $archname is a string like sun4-sunos, | |||
determined by Configure. The full definitions of all Configure | determined by Configure. The full definitions of all Configure | |||
variables are in the file Porting/Glossary. | variables are in the file Porting/Glossary. | |||
Configure variable Default value | Configure variable Default value | |||
$prefixexp /usr/local | $prefixexp /usr/local | |||
$binexp $prefixexp/bin | $binexp $prefixexp/bin | |||
$scriptdirexp $prefixexp/bin | $scriptdirexp $prefixexp/bin | |||
$privlibexp $prefixexp/lib/perl5/$version | $privlibexp $prefixexp/lib/perl5/$version | |||
skipping to change at line 2437 | skipping to change at line 2437 | |||
inappropriate to send to a public issue tracker, then see | inappropriate to send to a public issue tracker, then see | |||
L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> | L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> | |||
for details of how to report the issue. | for details of how to report the issue. | |||
If you are unsure what makes a good bug report please read "How to | If you are unsure what makes a good bug report please read "How to | |||
report Bugs Effectively" by Simon Tatham: | report Bugs Effectively" by Simon Tatham: | |||
http://www.chiark.greenend.org.uk/~sgtatham/bugs.html | http://www.chiark.greenend.org.uk/~sgtatham/bugs.html | |||
=head1 Coexistence with earlier versions of perl 5 | =head1 Coexistence with earlier versions of perl 5 | |||
Perl 5.30.2 is not binary compatible with versions of Perl earlier than | Perl 5.30.3 is not binary compatible with versions of Perl earlier than | |||
5.30.0. | 5.30.0. | |||
In other words, you will have to recompile your XS modules. | In other words, you will have to recompile your XS modules. | |||
In general, you can usually safely upgrade from one version of Perl | In general, you can usually safely upgrade from one version of Perl | |||
(e.g. 5.X.Y) to another similar minor version (e.g. 5.X.(Y+1))) without | (e.g. 5.X.Y) to another similar minor version (e.g. 5.X.(Y+1))) without | |||
re-compiling all of your extensions. You can also safely leave the old | re-compiling all of your extensions. You can also safely leave the old | |||
version around in case the new version causes you problems for some | version around in case the new version causes you problems for some | |||
reason. | reason. | |||
Usually, most extensions will probably not need to be recompiled to be | Usually, most extensions will probably not need to be recompiled to be | |||
skipping to change at line 2513 | skipping to change at line 2513 | |||
versions, without breaking the earlier versions' installations. | versions, without breaking the earlier versions' installations. | |||
=head2 Maintaining completely separate versions | =head2 Maintaining completely separate versions | |||
Many users prefer to keep all versions of perl in completely | Many users prefer to keep all versions of perl in completely | |||
separate directories. This guarantees that an update to one version | separate directories. This guarantees that an update to one version | |||
won't interfere with another version. (The defaults guarantee this for | won't interfere with another version. (The defaults guarantee this for | |||
libraries after 5.6.0, but not for executables. TODO?) One convenient | libraries after 5.6.0, but not for executables. TODO?) One convenient | |||
way to do this is by using a separate prefix for each version, such as | way to do this is by using a separate prefix for each version, such as | |||
sh Configure -Dprefix=/opt/perl5.30.2 | sh Configure -Dprefix=/opt/perl5.30.3 | |||
and adding /opt/perl5.30.2/bin to the shell PATH variable. Such users | and adding /opt/perl5.30.3/bin to the shell PATH variable. Such users | |||
may also wish to add a symbolic link /usr/local/bin/perl so that | may also wish to add a symbolic link /usr/local/bin/perl so that | |||
scripts can still start with #!/usr/local/bin/perl. | scripts can still start with #!/usr/local/bin/perl. | |||
Others might share a common directory for maintenance sub-versions | Others might share a common directory for maintenance sub-versions | |||
(e.g. 5.10 for all 5.10.x versions), but change directory with | (e.g. 5.10 for all 5.10.x versions), but change directory with | |||
each major version. | each major version. | |||
If you are installing a development subversion, you probably ought to | If you are installing a development subversion, you probably ought to | |||
seriously consider using a separate directory, since development | seriously consider using a separate directory, since development | |||
subversions may not have all the compatibility wrinkles ironed out | subversions may not have all the compatibility wrinkles ironed out | |||
yet. | yet. | |||
=head2 Upgrading from 5.29.10 or earlier | =head2 Upgrading from 5.29.10 or earlier | |||
B<Perl 5.30.2 may not be binary compatible with Perl 5.29.10 or | B<Perl 5.30.3 may not be binary compatible with Perl 5.29.10 or | |||
earlier Perl releases.> Perl modules having binary parts | earlier Perl releases.> Perl modules having binary parts | |||
(meaning that a C compiler is used) will have to be recompiled to be | (meaning that a C compiler is used) will have to be recompiled to be | |||
used with 5.30.2. If you find you do need to rebuild an extension with | used with 5.30.3. If you find you do need to rebuild an extension with | |||
5.30.2, you may safely do so without disturbing the older | 5.30.3, you may safely do so without disturbing the older | |||
installations. (See L<"Coexistence with earlier versions of perl 5"> | installations. (See L<"Coexistence with earlier versions of perl 5"> | |||
above.) | above.) | |||
See your installed copy of the perllocal.pod file for a (possibly | See your installed copy of the perllocal.pod file for a (possibly | |||
incomplete) list of locally installed modules. Note that you want | incomplete) list of locally installed modules. Note that you want | |||
perllocal.pod, not perllocale.pod, for installed module information. | perllocal.pod, not perllocale.pod, for installed module information. | |||
=head1 Minimizing the Perl installation | =head1 Minimizing the Perl installation | |||
The following section is meant for people worrying about squeezing the | The following section is meant for people worrying about squeezing the | |||
skipping to change at line 2567 | skipping to change at line 2567 | |||
depends on what you need. | depends on what you need. | |||
Firstly, the bare minimum to run this script | Firstly, the bare minimum to run this script | |||
use strict; | use strict; | |||
use warnings; | use warnings; | |||
foreach my $f (</*>) { | foreach my $f (</*>) { | |||
print("$f\n"); | print("$f\n"); | |||
} | } | |||
in Linux with perl-5.30.2 is as follows (under $Config{prefix}): | in Linux with perl-5.30.3 is as follows (under $Config{prefix}): | |||
./bin/perl | ./bin/perl | |||
./lib/perl5/5.30.2/strict.pm | ./lib/perl5/5.30.3/strict.pm | |||
./lib/perl5/5.30.2/warnings.pm | ./lib/perl5/5.30.3/warnings.pm | |||
./lib/perl5/5.30.2/i686-linux/File/Glob.pm | ./lib/perl5/5.30.3/i686-linux/File/Glob.pm | |||
./lib/perl5/5.30.2/feature.pm | ./lib/perl5/5.30.3/feature.pm | |||
./lib/perl5/5.30.2/XSLoader.pm | ./lib/perl5/5.30.3/XSLoader.pm | |||
./lib/perl5/5.30.2/i686-linux/auto/File/Glob/Glob.so | ./lib/perl5/5.30.3/i686-linux/auto/File/Glob/Glob.so | |||
Secondly, for perl-5.10.1, the Debian perl-base package contains 591 | Secondly, for perl-5.10.1, the Debian perl-base package contains 591 | |||
files, (of which 510 are for lib/unicore) totaling about 3.5MB in its | files, (of which 510 are for lib/unicore) totaling about 3.5MB in its | |||
i386 version. Omitting the lib/unicore/* files for brevity, the | i386 version. Omitting the lib/unicore/* files for brevity, the | |||
remaining files are: | remaining files are: | |||
/usr/bin/perl | /usr/bin/perl | |||
/usr/bin/perl5.10.1 | /usr/bin/perl5.10.1 | |||
/usr/lib/perl/5.10.1/Config.pm | /usr/lib/perl/5.10.1/Config.pm | |||
/usr/lib/perl/5.10.1/Config_git.pl | /usr/lib/perl/5.10.1/Config_git.pl | |||
End of changes. 8 change blocks. | ||||
14 lines changed or deleted | 14 lines changed or added |