"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "INSTALL" between
perl-5.28.2.tar.xz and perl-5.28.3.tar.xz

About: Perl (Practical Extraction and Report Language) is a high-level, general-purpose, interpreted, dynamic programming language. Stable release.

INSTALL  (perl-5.28.2.tar.xz):INSTALL  (perl-5.28.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.28.2. By default, Configure will use the following directories for 5.28.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 2442 skipping to change at line 2442
inappropriate to send to a publicly archived mailing list, then see inappropriate to send to a publicly archived mailing list, 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.28.2 is not binary compatible with versions of Perl earlier than Perl 5.28.3 is not binary compatible with versions of Perl earlier than
5.28.0. 5.28.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 2518 skipping to change at line 2518
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.28.2 sh Configure -Dprefix=/opt/perl5.28.3
and adding /opt/perl5.28.2/bin to the shell PATH variable. Such users and adding /opt/perl5.28.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.27.11 or earlier =head2 Upgrading from 5.27.11 or earlier
B<Perl 5.28.2 may not be binary compatible with Perl 5.27.11 or B<Perl 5.28.3 may not be binary compatible with Perl 5.27.11 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.28.2. If you find you do need to rebuild an extension with used with 5.28.3. If you find you do need to rebuild an extension with
5.28.2, you may safely do so without disturbing the older 5.28.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 2572 skipping to change at line 2572
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.28.2 is as follows (under $Config{prefix}): in Linux with perl-5.28.3 is as follows (under $Config{prefix}):
./bin/perl ./bin/perl
./lib/perl5/5.28.2/strict.pm ./lib/perl5/5.28.3/strict.pm
./lib/perl5/5.28.2/warnings.pm ./lib/perl5/5.28.3/warnings.pm
./lib/perl5/5.28.2/i686-linux/File/Glob.pm ./lib/perl5/5.28.3/i686-linux/File/Glob.pm
./lib/perl5/5.28.2/feature.pm ./lib/perl5/5.28.3/feature.pm
./lib/perl5/5.28.2/XSLoader.pm ./lib/perl5/5.28.3/XSLoader.pm
./lib/perl5/5.28.2/i686-linux/auto/File/Glob/Glob.so ./lib/perl5/5.28.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

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)