1PERL5221DELTA(1)       Perl Programmers Reference Guide       PERL5221DELTA(1)
2
3
4

NAME

6       perl5221delta - what is new for perl v5.22.1
7

DESCRIPTION

9       This document describes differences between the 5.22.0 release and the
10       5.22.1 release.
11
12       If you are upgrading from an earlier release such as 5.20.0, first read
13       perl5220delta, which describes differences between 5.20.0 and 5.22.0.
14

Incompatible Changes

16       There are no changes intentionally incompatible with 5.20.0 other than
17       the following single exception, which we deemed to be a sensible change
18       to make in order to get the new "\b{wb}" and (in particular) "\b{sb}"
19       features sane before people decided they're worthless because of bugs
20       in their Perl 5.22.0 implementation and avoided them in the future.  If
21       any others exist, they are bugs, and we request that you submit a
22       report.  See "Reporting Bugs" below.
23
24   Bounds Checking Constructs
25       Several bugs, including a segmentation fault, have been fixed with the
26       bounds checking constructs (introduced in Perl 5.22) "\b{gcb}",
27       "\b{sb}", "\b{wb}", "\B{gcb}", "\B{sb}", and "\B{wb}".  All the "\B{}"
28       ones now match an empty string; none of the "\b{}" ones do.  [GH
29       #14976] <https://github.com/Perl/perl5/issues/14976>
30

Modules and Pragmata

32   Updated Modules and Pragmata
33       •   Module::CoreList has been upgraded from version 5.20150520 to
34           5.20151213.
35
36       •   PerlIO::scalar has been upgraded from version 0.22 to 0.23.
37
38       •   POSIX has been upgraded from version 1.53 to 1.53_01.
39
40           If "POSIX::strerror" was passed $! as its argument then it
41           accidentally cleared $!.  This has been fixed.  [GH #14951]
42           <https://github.com/Perl/perl5/issues/14951>
43
44       •   Storable has been upgraded from version 2.53 to 2.53_01.
45
46       •   warnings has been upgraded from version 1.32 to 1.34.
47
48           The "warnings::enabled" example now actually uses
49           "warnings::enabled".  [GH #14905]
50           <https://github.com/Perl/perl5/issues/14905>
51
52       •   Win32 has been upgraded from version 0.51 to 0.52.
53
54           This has been updated for Windows 8.1, 10 and 2012 R2 Server.
55

Documentation

57   Changes to Existing Documentation
58       perltie
59
60       •   The usage of "FIRSTKEY" and "NEXTKEY" has been clarified.
61
62       perlvar
63
64       •   The specific true value of $!{E...} is now documented, noting that
65           it is subject to change and not guaranteed.
66

Diagnostics

68       The following additions or changes have been made to diagnostic output,
69       including warnings and fatal error messages.  For the complete list of
70       diagnostic messages, see perldiag.
71
72   Changes to Existing Diagnostics
73       •   The "printf" and "sprintf" builtins are now more careful about the
74           warnings they emit: argument reordering now disables the "redundant
75           argument" warning in all cases.  [GH #14772]
76           <https://github.com/Perl/perl5/issues/14772>
77

Configuration and Compilation

79       •   Using the "NO_HASH_SEED" define in combination with the default
80           hash algorithm "PERL_HASH_FUNC_ONE_AT_A_TIME_HARD" resulted in a
81           fatal error while compiling the interpreter, since Perl 5.17.10.
82           This has been fixed.
83
84       •   Configuring with ccflags containing quotes (e.g.
85           "-Accflags='-DAPPLLIB_EXP=\"/usr/libperl\"'") was broken in Perl
86           5.22.0 but has now been fixed again.  [GH #14732]
87           <https://github.com/Perl/perl5/issues/14732>
88

Platform Support

90   Platform-Specific Notes
91       IRIX
92           •   Under some circumstances IRIX stdio fgetc() and fread() set the
93               errno to "ENOENT", which made no sense according to either IRIX
94               or POSIX docs.  Errno is now cleared in such cases.  [GH
95               #14557] <https://github.com/Perl/perl5/issues/14557>
96
97           •   Problems when multiplying long doubles by infinity have been
98               fixed.  [GH #14993]
99               <https://github.com/Perl/perl5/issues/14993>
100
101           •   All tests pass now on IRIX with the default build
102               configuration.
103

Selected Bug Fixes

105       •   "qr/(?[ () ])/" no longer segfaults, giving a syntax error message
106           instead.  [GH #14851] <https://github.com/Perl/perl5/issues/14851>
107
108       •   Regular expression possessive quantifier Perl 5.20 regression now
109           fixed.  "qr/"PAT"{"min,max"}+""/" is supposed to behave identically
110           to "qr/(?>"PAT"{"min,max"})/".  Since Perl 5.20, this didn't work
111           if min and max were equal.  [GH #14857]
112           <https://github.com/Perl/perl5/issues/14857>
113
114       •   Certain syntax errors in "Extended Bracketed Character Classes" in
115           perlrecharclass caused panics instead of the proper error message.
116           This has now been fixed.  [GH #15016]
117           <https://github.com/Perl/perl5/issues/15016>
118
119       •   "BEGIN <>" no longer segfaults and properly produces an error
120           message.  [GH #13546] <https://github.com/Perl/perl5/issues/13546>
121
122       •   A regression from Perl 5.20 has been fixed, in which some syntax
123           errors in "(?[...])" constructs within regular expression patterns
124           could cause a segfault instead of a proper error message.  [GH
125           #14933] <https://github.com/Perl/perl5/issues/14933>
126
127       •   Another problem with "(?[...])"  constructs has been fixed wherein
128           things like "\c]" could cause panics.  [GH #14934]
129           <https://github.com/Perl/perl5/issues/14934>
130
131       •   In Perl 5.22.0, the logic changed when parsing a numeric parameter
132           to the -C option, such that the successfully parsed number was not
133           saved as the option value if it parsed to the end of the argument.
134           [GH #14748] <https://github.com/Perl/perl5/issues/14748>
135
136       •   Warning fatality is now ignored when rewinding the stack.  This
137           prevents infinite recursion when the now fatal error also causes
138           rewinding of the stack.  [GH #14319]
139           <https://github.com/Perl/perl5/issues/14319>
140
141       •   A crash with "%::=(); J->${\"::"}" has been fixed.  [GH #14790]
142           <https://github.com/Perl/perl5/issues/14790>
143
144       •   Nested quantifiers such as "/.{1}??/" should cause perl to throw a
145           fatal error, but were being silently accepted since Perl 5.20.0.
146           This has been fixed.  [GH #14960]
147           <https://github.com/Perl/perl5/issues/14960>
148
149       •   Regular expression sequences such as "/(?i/" (and similarly with
150           other recognized flags or combination of flags) should cause perl
151           to throw a fatal error, but were being silently accepted since Perl
152           5.18.0.  This has been fixed.  [GH #14931]
153           <https://github.com/Perl/perl5/issues/14931>
154
155       •   A bug in hexadecimal floating point literal support meant that
156           high-order bits could be lost in cases where mantissa overflow was
157           caused by too many trailing zeros in the fractional part.  This has
158           been fixed.  [GH #15032]
159           <https://github.com/Perl/perl5/issues/15032>
160
161       •   Another hexadecimal floating point bug, causing low-order bits to
162           be lost in cases where the last hexadecimal digit of the mantissa
163           has bits straddling the limit of the number of bits allowed for the
164           mantissa, has also been fixed.  [GH #15033]
165           <https://github.com/Perl/perl5/issues/15033>
166
167       •   Further hexadecimal floating point bugs have been fixed: In some
168           circumstances, the %a format specifier could variously lose the
169           sign of the negative zero, fail to display zeros after the radix
170           point with the requested precision, or even lose the radix point
171           after the leftmost hexadecimal digit completely.
172
173       •   A crash caused by incomplete expressions within "/(?[ ])/" (e.g.
174           "/(?[[0]+()+])/") has been fixed.  [GH #15045]
175           <https://github.com/Perl/perl5/issues/15045>
176

Acknowledgements

178       Perl 5.22.1 represents approximately 6 months of development since Perl
179       5.22.0 and contains approximately 19,000 lines of changes across 130
180       files from 27 authors.
181
182       Excluding auto-generated files, documentation and release tools, there
183       were approximately 1,700 lines of changes to 44 .pm, .t, .c and .h
184       files.
185
186       Perl continues to flourish into its third decade thanks to a vibrant
187       community of users and developers.  The following people are known to
188       have contributed the improvements that became Perl 5.22.1:
189
190       Aaron Crane, Abigail, Andy Broad, Aristotle Pagaltzis, Chase Whitener,
191       Chris 'BinGOs' Williams, Craig A. Berry, Daniel Dragan, David Mitchell,
192       Father Chrysostomos, Herbert Breunung, Hugo van der Sanden, James E
193       Keenan, Jan Dubois, Jarkko Hietaniemi, Karen Etheridge, Karl
194       Williamson, Lukas Mai, Matthew Horsfall, Peter Martini, Rafael Garcia-
195       Suarez, Ricardo Signes, Shlomi Fish, Sisyphus, Steve Hay, Tony Cook,
196       Victor Adam.
197
198       The list above is almost certainly incomplete as it is automatically
199       generated from version control history.  In particular, it does not
200       include the names of the (very much appreciated) contributors who
201       reported issues to the Perl bug tracker.
202
203       Many of the changes included in this version originated in the CPAN
204       modules included in Perl's core.  We're grateful to the entire CPAN
205       community for helping Perl to flourish.
206
207       For a more complete list of all of Perl's historical contributors,
208       please see the AUTHORS file in the Perl source distribution.
209

Reporting Bugs

211       If you find what you think is a bug, you might check the articles
212       recently posted to the comp.lang.perl.misc newsgroup and the perl bug
213       database at https://rt.perl.org/ .  There may also be information at
214       http://www.perl.org/ , the Perl Home Page.
215
216       If you believe you have an unreported bug, please run the perlbug
217       program included with your release.  Be sure to trim your bug down to a
218       tiny but sufficient test case.  Your bug report, along with the output
219       of "perl -V", will be sent off to perlbug@perl.org to be analysed by
220       the Perl porting team.
221
222       If the bug you are reporting has security implications, which make it
223       inappropriate to send to a publicly archived mailing list, then please
224       send it to perl5-security-report@perl.org.  This points to a closed
225       subscription unarchived mailing list, which includes all the core
226       committers, who will be able to help assess the impact of issues,
227       figure out a resolution, and help co-ordinate the release of patches to
228       mitigate or fix the problem across all platforms on which Perl is
229       supported.  Please only use this address for security issues in the
230       Perl core, not for modules independently distributed on CPAN.
231

SEE ALSO

233       The Changes file for an explanation of how to view exhaustive details
234       on what changed.
235
236       The INSTALL file for how to build Perl.
237
238       The README file for general stuff.
239
240       The Artistic and Copying files for copyright information.
241
242
243
244perl v5.34.0                      2021-10-18                  PERL5221DELTA(1)
Impressum