Skip to content

Commit

Permalink
INSTALL: manual tweaks to fix version bump
Browse files Browse the repository at this point in the history
This is one place our version bumping goes wrong.
  • Loading branch information
rjbs committed Jun 25, 2023
1 parent 5677776 commit 815251b
Showing 1 changed file with 15 additions and 15 deletions.
30 changes: 15 additions & 15 deletions INSTALL
Expand Up @@ -750,7 +750,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.37.12.
By default, Configure will use the following directories for 5.38.0.
$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
Expand Down Expand Up @@ -2580,7 +2580,7 @@ L<https://www.chiark.greenend.org.uk/~sgtatham/bugs.html>

=head1 Coexistence with earlier versions of perl 5

Perl 5.37.12 is not binary compatible with earlier versions of Perl.
Perl 5.38.0 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 stable version of Perl
Expand Down Expand Up @@ -2655,9 +2655,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.37.12
sh Configure -Dprefix=/opt/perl5.38.0

and adding /opt/perl5.37.12/bin to the shell PATH variable. Such users
and adding /opt/perl5.38.0/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.

Expand All @@ -2670,13 +2670,13 @@ seriously consider using a separate directory, since development
subversions may not have all the compatibility wrinkles ironed out
yet.

=head2 Upgrading from 5.37.11 or earlier
=head2 Upgrading from 5.36.0 or earlier

B<Perl 5.37.12 may not be binary compatible with Perl 5.37.11 or
B<Perl 5.38.0 may not be binary compatible with Perl 5.36.0 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.37.12. If you find you do need to rebuild an extension with
5.37.12, you may safely do so without disturbing the older
used with 5.38.0. If you find you do need to rebuild an extension with
5.38.0, you may safely do so without disturbing the older
installations. (See L<"Coexistence with earlier versions of perl 5">
above.)

Expand Down Expand Up @@ -2709,15 +2709,15 @@ Firstly, the bare minimum to run this script
print("$f\n");
}

in Linux with perl-5.37.12 is as follows (under $Config{prefix}):
in Linux with perl-5.38.0 is as follows (under $Config{prefix}):

./bin/perl
./lib/perl5/5.37.12/strict.pm
./lib/perl5/5.37.12/warnings.pm
./lib/perl5/5.37.12/i686-linux/File/Glob.pm
./lib/perl5/5.37.12/feature.pm
./lib/perl5/5.37.12/XSLoader.pm
./lib/perl5/5.37.12/i686-linux/auto/File/Glob/Glob.so
./lib/perl5/5.38.0/strict.pm
./lib/perl5/5.38.0/warnings.pm
./lib/perl5/5.38.0/i686-linux/File/Glob.pm
./lib/perl5/5.38.0/feature.pm
./lib/perl5/5.38.0/XSLoader.pm
./lib/perl5/5.38.0/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
Expand Down

2 comments on commit 815251b

@rwp0
Copy link
Contributor

@rwp0 rwp0 commented on 815251b Jun 25, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

README.haiku, README.macosx, and README.os2 per-OS documentation files also have similar references.

@thesamesam
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-> #21185

Please sign in to comment.