From fdce04eede5d38fa6df55c4461e7b833c9d68aba Mon Sep 17 00:00:00 2001 From: Nicholas Clark Date: Mon, 11 Oct 2021 18:07:58 +0000 Subject: 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. --- INSTALL | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) (limited to 'INSTALL') 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 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 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 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 module's C function for one way to make a "bundle" of your currently installed modules. -- cgit v1.2.1