Provide defined value for $TODO only where test is still failing.
[perl.git] / pod / perl5221delta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perl5221delta - what is new for perl v5.22.1
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.22.0 release and the 5.22.1
10 release.
11
12 If you are upgrading from an earlier release such as 5.20.0, first read
13 L<perl5220delta>, which describes differences between 5.20.0 and 5.22.0.
14
15 =head1 Incompatible Changes
16
17 There are no changes intentionally incompatible with 5.20.0 other than the
18 following single exception, which we deemed to be a sensible change to make in
19 order to get the new C<\b{wb}> and (in particular) C<\b{sb}> features sane
20 before people decided they're worthless because of bugs in their Perl 5.22.0
21 implementation and avoided them in the future.
22 If any others exist, they are bugs, and we request that you submit a report.
23 See L</Reporting Bugs> below.
24
25 =head2 Bounds Checking Constructs
26
27 Several bugs, including a segmentation fault, have been fixed with the bounds
28 checking constructs (introduced in Perl 5.22) C<\b{gcb}>, C<\b{sb}>, C<\b{wb}>,
29 C<\B{gcb}>, C<\B{sb}>, and C<\B{wb}>.  All the C<\B{}> ones now match an empty
30 string; none of the C<\b{}> ones do.
31 L<[perl #126319]|https://rt.perl.org/Ticket/Display.html?id=126319>
32
33 =head1 Modules and Pragmata
34
35 =head2 Updated Modules and Pragmata
36
37 =over 4
38
39 =item *
40
41 L<Module::CoreList> has been upgraded from version 5.20150520 to 5.20151213.
42
43 =item *
44
45 L<PerlIO::scalar> has been upgraded from version 0.22 to 0.23.
46
47 =item *
48
49 L<POSIX> has been upgraded from version 1.53 to 1.53_01.
50
51 If C<POSIX::strerror> was passed C<$!> as its argument then it accidentally
52 cleared C<$!>.  This has been fixed.
53 L<[perl #126229]|https://rt.perl.org/Ticket/Display.html?id=126229>
54
55 =item *
56
57 L<Storable> has been upgraded from version 2.53 to 2.53_01.
58
59 =item *
60
61 L<warnings> has been upgraded from version 1.32 to 1.34.
62
63 The C<warnings::enabled> example now actually uses C<warnings::enabled>.
64 L<[perl #126051]|https://rt.perl.org/Ticket/Display.html?id=126051>
65
66 =item *
67
68 L<Win32> has been upgraded from version 0.51 to 0.52.
69
70 This has been updated for Windows 8.1, 10 and 2012 R2 Server.
71
72 =back
73
74 =head1 Documentation
75
76 =head2 Changes to Existing Documentation
77
78 =head3 L<perltie>
79
80 =over 4
81
82 =item *
83
84 The usage of C<FIRSTKEY> and C<NEXTKEY> has been clarified.
85
86 =back
87
88 =head3 L<perlvar>
89
90 =over 4
91
92 =item *
93
94 The specific true value of C<$!{E...}> is now documented, noting that it is
95 subject to change and not guaranteed.
96
97 =back
98
99 =head1 Diagnostics
100
101 The following additions or changes have been made to diagnostic output,
102 including warnings and fatal error messages.  For the complete list of
103 diagnostic messages, see L<perldiag>.
104
105 =head2 Changes to Existing Diagnostics
106
107 =over 4
108
109 =item *
110
111 The C<printf> and C<sprintf> builtins are now more careful about the warnings
112 they emit: argument reordering now disables the "redundant argument" warning in
113 all cases.
114 L<[perl #125469]|https://rt.perl.org/Ticket/Display.html?id=125469>
115
116 =back
117
118 =head1 Configuration and Compilation
119
120 =over 4
121
122 =item *
123
124 Using the C<NO_HASH_SEED> define in combination with the default hash algorithm
125 C<PERL_HASH_FUNC_ONE_AT_A_TIME_HARD> resulted in a fatal error while compiling
126 the interpreter, since Perl 5.17.10.  This has been fixed.
127
128 =item *
129
130 Configuring with ccflags containing quotes (e.g.
131 C<< -Accflags='-DAPPLLIB_EXP=\"/usr/libperl\"' >>) was broken in Perl 5.22.0
132 but has now been fixed again.
133 L<[perl #125314]|https://rt.perl.org/Ticket/Display.html?id=125314>
134
135 =back
136
137 =head1 Platform Support
138
139 =head2 Platform-Specific Notes
140
141 =over 4
142
143 =item IRIX
144
145 =over
146
147 =item *
148
149 Under some circumstances IRIX stdio fgetc() and fread() set the errno to
150 C<ENOENT>, which made no sense according to either IRIX or POSIX docs.  Errno
151 is now cleared in such cases.
152 L<[perl #123977]|https://rt.perl.org/Ticket/Display.html?id=123977>
153
154 =item *
155
156 Problems when multiplying long doubles by infinity have been fixed.
157 L<[perl #126396]|https://rt.perl.org/Ticket/Display.html?id=126396>
158
159 =item *
160
161 All tests pass now on IRIX with the default build configuration.
162
163 =back
164
165 =back
166
167 =head1 Selected Bug Fixes
168
169 =over 4
170
171 =item *
172
173 C<qr/(?[ () ])/> no longer segfaults, giving a syntax error message instead.
174 L<[perl #125805]|https://rt.perl.org/Ticket/Display.html?id=125805>
175
176 =item *
177
178 Regular expression possessive quantifier Perl 5.20 regression now fixed.
179 C<qr/>I<PAT>C<{>I<min>,I<max>C<}+>C</> is supposed to behave identically to
180 C<qr/(?E<gt>>I<PAT>C<{>I<min>,I<max>C<})/>.  Since Perl 5.20, this didn't work
181 if I<min> and I<max> were equal.
182 L<[perl #125825]|https://rt.perl.org/Ticket/Display.html?id=125825>
183
184 =item *
185
186 Certain syntax errors in
187 L<perlrecharclass/Extended Bracketed Character Classes> caused panics instead
188 of the proper error message.  This has now been fixed.
189 L<[perl #126481]|https://rt.perl.org/Ticket/Display.html?id=126481>
190
191 =item *
192
193 C<< BEGIN <> >> no longer segfaults and properly produces an error message.
194 L<[perl #125341]|https://rt.perl.org/Ticket/Display.html?id=125341>
195
196 =item *
197
198 A regression from Perl 5.20 has been fixed, in which some syntax errors in
199 L<C<(?[...])>|perlrecharclass/Extended Bracketed Character Classes> constructs
200 within regular expression patterns could cause a segfault instead of a proper
201 error message.
202 L<[perl #126180]|https://rt.perl.org/Ticket/Display.html?id=126180>
203
204 =item *
205
206 Another problem with
207 L<C<(?[...])>|perlrecharclass/Extended Bracketed Character Classes>
208 constructs has been fixed wherein things like C<\c]> could cause panics.
209 L<[perl #126181]|https://rt.perl.org/Ticket/Display.html?id=126181>
210
211 =item *
212
213 In Perl 5.22.0, the logic changed when parsing a numeric parameter to the -C
214 option, such that the successfully parsed number was not saved as the option
215 value if it parsed to the end of the argument.
216 L<[perl #125381]|https://rt.perl.org/Ticket/Display.html?id=125381>
217
218 =item *
219
220 Warning fatality is now ignored when rewinding the stack.  This prevents
221 infinite recursion when the now fatal error also causes rewinding of the stack.
222 L<[perl #123398]|https://rt.perl.org/Ticket/Display.html?id=123398>
223
224 =item *
225
226 A crash with C<< %::=(); J->${\"::"} >> has been fixed.
227 L<[perl #125541]|https://rt.perl.org/Ticket/Display.html?id=125541>
228
229 =item *
230
231 Nested quantifiers such as C</.{1}??/> should cause perl to throw a fatal
232 error, but were being silently accepted since Perl 5.20.0.  This has been
233 fixed.
234 L<[perl #126253]|https://rt.perl.org/Ticket/Display.html?id=126253>
235
236 =item *
237
238 Regular expression sequences such as C</(?i/> (and similarly with other
239 recognized flags or combination of flags) should cause perl to throw a fatal
240 error, but were being silently accepted since Perl 5.18.0.  This has been
241 fixed.
242 L<[perl #126178]|https://rt.perl.org/Ticket/Display.html?id=126178>
243
244 =item *
245
246 A bug in hexadecimal floating point literal support meant that high-order bits
247 could be lost in cases where mantissa overflow was caused by too many trailing
248 zeros in the fractional part.  This has been fixed.
249 L<[perl #126582]|https://rt.perl.org/Ticket/Display.html?id=126582>
250
251 =item *
252
253 Another hexadecimal floating point bug, causing low-order bits to be lost in
254 cases where the last hexadecimal digit of the mantissa has bits straddling the
255 limit of the number of bits allowed for the mantissa, has also been fixed.
256 L<[perl #126586]|https://rt.perl.org/Ticket/Display.html?id=126586>
257
258 =item *
259
260 Further hexadecimal floating point bugs have been fixed: In some circumstances,
261 the C<%a> format specifier could variously lose the sign of the negative zero,
262 fail to display zeros after the radix point with the requested precision, or
263 even lose the radix point after the leftmost hexadecimal digit completely.
264
265 =item *
266
267 A crash caused by incomplete expressions within C<< /(?[ ])/ >> (e.g.
268 C<< /(?[[0]+()+])/ >>) has been fixed.
269 L<[perl #126615]|https://rt.perl.org/Ticket/Display.html?id=126615>
270
271 =back
272
273 =head1 Acknowledgements
274
275 Perl 5.22.1 represents approximately 6 months of development since Perl 5.22.0
276 and contains approximately 19,000 lines of changes across 130 files from 27
277 authors.
278
279 Excluding auto-generated files, documentation and release tools, there were
280 approximately 1,700 lines of changes to 44 .pm, .t, .c and .h files.
281
282 Perl continues to flourish into its third decade thanks to a vibrant community
283 of users and developers.  The following people are known to have contributed
284 the improvements that became Perl 5.22.1:
285
286 Aaron Crane, Abigail, Andy Broad, Aristotle Pagaltzis, Chase Whitener, Chris
287 'BinGOs' Williams, Craig A. Berry, Daniel Dragan, David Mitchell, Father
288 Chrysostomos, Herbert Breunung, Hugo van der Sanden, James E Keenan, Jan
289 Dubois, Jarkko Hietaniemi, Karen Etheridge, Karl Williamson, Lukas Mai, Matthew
290 Horsfall, Peter Martini, Rafael Garcia-Suarez, Ricardo Signes, Shlomi Fish,
291 Sisyphus, Steve Hay, Tony Cook, Victor Adam.
292
293 The list above is almost certainly incomplete as it is automatically generated
294 from version control history.  In particular, it does not include the names of
295 the (very much appreciated) contributors who reported issues to the Perl bug
296 tracker.
297
298 Many of the changes included in this version originated in the CPAN modules
299 included in Perl's core.  We're grateful to the entire CPAN community for
300 helping Perl to flourish.
301
302 For a more complete list of all of Perl's historical contributors, please see
303 the F<AUTHORS> file in the Perl source distribution.
304
305 =head1 Reporting Bugs
306
307 If you find what you think is a bug, you might check the articles recently
308 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
309 https://rt.perl.org/ .  There may also be information at
310 http://www.perl.org/ , the Perl Home Page.
311
312 If you believe you have an unreported bug, please run the L<perlbug> program
313 included with your release.  Be sure to trim your bug down to a tiny but
314 sufficient test case.  Your bug report, along with the output of C<perl -V>,
315 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
316
317 If the bug you are reporting has security implications, which make it
318 inappropriate to send to a publicly archived mailing list, then please send it
319 to perl5-security-report@perl.org.  This points to a closed subscription
320 unarchived mailing list, which includes all the core committers, who will be
321 able to help assess the impact of issues, figure out a resolution, and help
322 co-ordinate the release of patches to mitigate or fix the problem across all
323 platforms on which Perl is supported.  Please only use this address for
324 security issues in the Perl core, not for modules independently distributed on
325 CPAN.
326
327 =head1 SEE ALSO
328
329 The F<Changes> file for an explanation of how to view exhaustive details on
330 what changed.
331
332 The F<INSTALL> file for how to build Perl.
333
334 The F<README> file for general stuff.
335
336 The F<Artistic> and F<Copying> files for copyright information.
337
338 =cut