This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Fix eval_pv for Perl versions prior to 5.31.2
[perl5.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 296e1ad..8c09689 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -609,7 +609,7 @@ The directories set up by Configure fall into three broad categories.
 
 =item Directories for the perl distribution
 
-By default, Configure will use the following directories for 5.31.1.
+By default, Configure will use the following directories for 5.31.5.
 $version is the full perl version number, including subversion, e.g.
 5.12.3, and $archname is a string like sun4-sunos,
 determined by Configure.  The full definitions of all Configure
@@ -764,7 +764,7 @@ run-time methods: $PERLLIB, $PERL5LIB, -I, use lib, etc.
 =item default_inc_excludes_dot
 
 Since version 5.26.0, default perl builds no longer includes C<'.'> as the
-last element of @INC. The old behaviour can restored using 
+last element of @INC. The old behaviour can restored using
 
        sh Configure -Udefault_inc_excludes_dot
 
@@ -1806,7 +1806,7 @@ to avoid the BIND.
 
 Perl can be cross-compiled.  It is just not trivial, cross-compilation
 rarely is.  Perl is routinely cross-compiled for several platforms: as of
-January 2014, these include Android, Blackberry 10,
+June 2019, these include Android, Blackberry 10,
 ARM Linux, and Solaris.  Previous versions of
 Perl also provided support for Open Zaurus, Symbian, and
 the IBM OS/400, but it's unknown if those ports are still functional.
@@ -2436,11 +2436,11 @@ L<http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>
 
 =head1 Coexistence with earlier versions of perl 5
 
-Perl 5.31.1 is not binary compatible with earlier versions of Perl.
+Perl 5.31.5 is not binary compatible with earlier versions of Perl.
 In other words, you will have to recompile your XS modules.
 
 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.31.3) to another similar minor version (e.g. 5.31.5))) without
 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
 reason.
@@ -2511,9 +2511,9 @@ won't interfere with another version.  (The defaults guarantee this for
 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
 
-       sh Configure -Dprefix=/opt/perl5.31.1
+       sh Configure -Dprefix=/opt/perl5.31.5
 
-and adding /opt/perl5.31.1/bin to the shell PATH variable.  Such users
+and adding /opt/perl5.31.5/bin to the shell PATH variable.  Such users
 may also wish to add a symbolic link /usr/local/bin/perl so that
 scripts can still start with #!/usr/local/bin/perl.
 
@@ -2526,13 +2526,13 @@ seriously consider using a separate directory, since development
 subversions may not have all the compatibility wrinkles ironed out
 yet.
 
-=head2 Upgrading from 5.28.0 or earlier
+=head2 Upgrading from 5.31.4 or earlier
 
-B<Perl 5.31.1 may not be binary compatible with Perl 5.28.0 or
+B<Perl 5.31.5 may not be binary compatible with Perl 5.31.4 or
 earlier Perl releases.>  Perl modules having binary parts
 (meaning that a C compiler is used) will have to be recompiled to be
-used with 5.31.1.  If you find you do need to rebuild an extension with
-5.31.1, you may safely do so without disturbing the older
+used with 5.31.5.  If you find you do need to rebuild an extension with
+5.31.5, you may safely do so without disturbing the older
 installations.  (See L<"Coexistence with earlier versions of perl 5">
 above.)
 
@@ -2565,15 +2565,15 @@ Firstly, the bare minimum to run this script
      print("$f\n");
   }
 
-in Linux with perl-5.31.1 is as follows (under $Config{prefix}):
+in Linux with perl-5.31.5 is as follows (under $Config{prefix}):
 
   ./bin/perl
-  ./lib/perl5/5.31.1/strict.pm
-  ./lib/perl5/5.31.1/warnings.pm
-  ./lib/perl5/5.31.1/i686-linux/File/Glob.pm
-  ./lib/perl5/5.31.1/feature.pm
-  ./lib/perl5/5.31.1/XSLoader.pm
-  ./lib/perl5/5.31.1/i686-linux/auto/File/Glob/Glob.so
+  ./lib/perl5/5.31.5/strict.pm
+  ./lib/perl5/5.31.5/warnings.pm
+  ./lib/perl5/5.31.5/i686-linux/File/Glob.pm
+  ./lib/perl5/5.31.5/feature.pm
+  ./lib/perl5/5.31.5/XSLoader.pm
+  ./lib/perl5/5.31.5/i686-linux/auto/File/Glob/Glob.so
 
 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