summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2021-10-11 18:07:58 +0000
committerYves Orton <demerphq@gmail.com>2023-02-08 17:41:46 +0800
commitfdce04eede5d38fa6df55c4461e7b833c9d68aba (patch)
tree3b0d526608168d396f40e42819c602a305a01dd6 /INSTALL
parent107e6fb3d831b51ef9e6cca524d17a8c1717d0ab (diff)
downloadperl-fdce04eede5d38fa6df55c4461e7b833c9d68aba.tar.gz
INSTALL now says that "changes in the Perl language" are usually minor
The paragraph starts: On a related issue, old modules may possibly be affected by the changes in the Perl language in the current release. Previously it made no indication about whether these changes were frequent or rare, small or large. The reality is that we are careful to keep them small and backwards compatible, whenever possible. So add the text: We try hard to make new features "opt-in", such that existing code will work unchanged, and attempt to identify where bug fixes might expose code which was relying on incorrect interpreter behaviour. Also remind people that the pod/perldelta.pod is only changes for the current release, hence they should read all the relevant perldelta files if they are upgrading from a release further back. perldelta already says this, but INSTALL was not clear.
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL17
1 files changed, 12 insertions, 5 deletions
diff --git a/INSTALL b/INSTALL
index 342f3bda58..cc8db1db90 100644
--- a/INSTALL
+++ b/INSTALL
@@ -103,11 +103,18 @@ L<"Coexistence with earlier versions of perl 5"> for more details.
The standard extensions supplied with Perl will be handled automatically.
-On a related issue, old modules may possibly be affected by the changes
-in the Perl language in the current release. Please see
-F<pod/perldelta.pod> for a description of what's changed. See your
-installed copy of the perllocal.pod file for a (possibly incomplete)
-list of locally installed modules. Also see the L<CPAN> module's
+On a related issue, old modules may possibly be affected by the changes in the
+Perl language in the current release. We try hard to make new features
+"opt-in", such that existing code will work unchanged, and attempt to identify
+where bug fixes might expose code which was relying on incorrect interpreter
+behaviour. Please see F<pod/perldelta.pod> for a description of what's
+changed between this and the previous release. If you are upgrading from an
+earlier release, please also check the perldeltas describing changes for the
+intermediate releases, to get a full picture of what changes might affect your
+installation.
+
+See your installed copy of the perllocal.pod file for a (possibly
+incomplete) list of locally installed modules. Also see the L<CPAN> module's
C<autobundle> function for one way to make a "bundle" of your currently
installed modules.