This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for 842a9d2, [perl #122460]
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 [ this is a template for a new perldelta file.  Any text flagged as XXX needs
6 to be processed before release. ]
7
8 perldelta - what is new for perl v5.21.3
9
10 =head1 DESCRIPTION
11
12 This document describes differences between the 5.21.2 release and the 5.21.3
13 release.
14
15 If you are upgrading from an earlier release such as 5.21.1, first read
16 L<perl5212delta>, which describes differences between 5.21.1 and 5.21.2.
17
18 =head1 Notice
19
20 XXX Any important notices here
21
22 =head1 Core Enhancements
23
24 =head2 C<defined(@array = LIST)> is no longer fatal
25
26 In 5.21.1, C<defined(@array)> was made fatal.  This has been relaxed
27 to not die if the argument is assigning to an array.
28
29 =head1 Security
30
31 =head2 The L<Safe> module could allow outside packages to be replaced
32
33 Critical bugfix: outside packages could be replaced.  L<Safe> has
34 been patched to 2.38 to address this.
35
36 =head1 Incompatible Changes
37
38 =head2 S<C<use UNIVERSAL '...'>> is now a fatal error
39
40 Importing functions from C<UNIVERSAL> has been deprecated since v5.12, and
41 is now a fatal error.  S<C<"use UNIVERSAL">> without any arguments is still
42 allowed.
43
44 =head1 Deprecations
45
46 XXX Any deprecated features, syntax, modules etc. should be listed here.
47
48 [ List each other deprecation as a =head2 entry ]
49
50 =head1 Performance Enhancements
51
52 XXX Changes which enhance performance without changing behaviour go here.
53 There may well be none in a stable release.
54
55 [ List each enhancement as a =item entry ]
56
57 =over 4
58
59 =item *
60
61 XXX
62
63 =back
64
65 =head1 Modules and Pragmata
66
67 =head2 Updated Modules and Pragmata
68
69 =over 4
70
71 =item *
72
73 L<B::Debug> has been upgraded from version 1.19 to 1.21
74
75 =item *
76
77 L<Config::Perl::V> has been upgraded from version 0.20 to 0.22.
78
79 =item *
80
81 L<CPAN::Meta> has been upgraded from version 2.141520 to 2.142060.
82
83 =item *
84
85 L<CPAN::Meta::Requirements> has been upgraded from version 2.125 to 2.126.
86
87 =item *
88
89 L<ExtUtils::Manifest> has been upgraded from version 1.64 to 1.65.
90
91 The MANIFEST is now opened with C<:raw>, to prevent C<CRLF>s leaking in.
92
93 =item *
94
95 L<HTTP::Tiny> has been upgraded from version 0.043 to 0.047.
96
97 =item *
98
99 L<perl5db.pl> has been upgraded from version 1.45 to 1.46.
100
101 Fixed the scope level handling of the debugger's C<y> command.
102
103 =item *
104
105 L<POSIX> has been upgraded from version 1.41 to 1.42.
106
107 Replaced the thread-unsafe code used to prevent duplicate warning
108 messages for using the isxxx() functions.  [perl #122476]
109
110 =item *
111
112 L<Safe> has been upgraded from version 2.37 to 2.38.
113
114 Critical bugfix: outside packages could be replaced.
115
116 =item *
117
118 L<Socket> has been upgraded from version 2.014 to 2.015.
119
120 Test suite updates, particularly useful for Solaris and cygwin, and
121 a slight change to the pattern used for IPv4 address matching.
122
123 =back
124
125 =head1 Documentation
126
127 =head2 Changes to Existing Documentation
128
129 =head3 L<perlexperiment>
130
131 =over 4
132
133 =item *
134
135 Added reference to L<feature>.
136
137 =back
138
139 =head3 L<perlguts>
140
141 =over 4
142
143 =item *
144
145 Details on C level symbols and libperl.t added.
146
147 =back
148
149 =head3 L<perlhacktips>
150
151 =over 4
152
153 =item *
154
155 Recommended replacements for tmpfile, atoi, strtol, and strtoul added.
156  
157 =back
158
159 =head3 L<perlop>
160
161 =over 4
162
163 =item *
164
165 ASCII v. EBCDIC clarifications added.
166
167 =back
168
169 =head3 L<perlsec>
170
171 =over 4
172
173 =item *
174
175 Comments added on algorithmic complexity and tied hashes.
176
177 =back
178
179 =head3 L<perlvms>
180
181 =over 4
182
183 =item *
184
185 Updated documentation on environment and shell interaction in VMS.
186
187 =back
188
189 =head1 Diagnostics
190
191 The following additions or changes have been made to diagnostic output,
192 including warnings and fatal error messages.  For the complete list of
193 diagnostic messages, see L<perldiag>.
194
195 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
196 include any changes in L<perldiag> that reconcile it to the C<C> code.
197
198 =head2 New Diagnostics
199
200 XXX Newly added diagnostic messages go under here, separated into New Errors
201 and New Warnings
202
203 =head3 New Errors
204
205 =over 4
206
207 =item *
208
209 XXX L<message|perldiag/"message">
210
211 =back
212
213 =head3 New Warnings
214
215 =over 4
216
217 =item *
218
219 L<Hexadecimal float: exponent overflow|perldiag/"Hexadecimal float: exponent overflow">
220
221 (W overflow) The hexadecimal floating point has larger exponent
222 than the floating point supports.
223
224 =item *
225
226 L<Hexadecimal float: exponent underflow|perldiag/"Hexadecimal float: exponent underflow">
227
228 (W overflow) The hexadecimal floating point has smaller exponent
229 than the floating point supports.
230
231 =item *
232
233 L<Hexadecimal float: internal error|perldiag/"Hexadecimal float: internal error">
234
235 (F) Something went horribly bad in hexadecimal float handling.
236
237 =item *
238
239 L<Hexadecimal float: mantissa overflow|perldiag/"Hexadecimal float: mantissa overflow">
240
241 (W overflow) The hexadecimal floating point literal had more bits in
242 the mantissa (the part between the 0x and the exponent, also known as
243 the fraction or the significand) than the floating point supports.
244
245 =item *
246
247 L<Hexadecimal float: precision loss|perldiag/"Hexadecimal float: precision loss">
248
249 (W overflow) The hexadecimal floating point had internally more
250 digits than could be output.  This can be caused by unsupported
251 long double formats, or by 64-bit integers not being available
252 (needed to retrieve the digits under some configurations).
253
254 =item *
255
256 L<Hexadecimal float: unsupported long double format|perldiag/"Hexadecimal float: unsupported long double format">
257
258 (F) You have configured Perl to use long doubles but
259 the internals of the long double format are unknown,
260 therefore the hexadecimal float output is impossible.
261
262 =back
263
264 =head2 Changes to Existing Diagnostics
265
266 XXX Changes (i.e. rewording) of diagnostic messages go here
267
268 =over 4
269
270 =item *
271
272 XXX Describe change here
273
274 =back
275
276 =head1 Configuration and Compilation
277
278 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
279 go here.  Any other changes to the Perl build process should be listed here.
280 However, any platform-specific changes should be listed in the
281 L</Platform Support> section, instead.
282
283 [ List changes as a =item entry ].
284
285 =over 4
286
287 =item *
288
289 Internal handling of floating point values has been improved.
290
291 =back
292
293 =head1 Testing
294
295 XXX Any significant changes to the testing of a freshly built perl should be
296 listed here.  Changes which create B<new> files in F<t/> go here as do any
297 large changes to the testing harness (e.g. when parallel testing was added).
298 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
299 that they represent may be covered elsewhere.
300
301 [ List each test improvement as a =item entry ]
302
303 =over 4
304
305 =item *
306
307 XXX
308
309 =back
310
311 =head1 Platform Support
312
313 =head2 Platform-Specific Notes
314
315 =over 4
316
317 =item Android
318
319 Build support has been improved for cross-compiling in general and for
320 Android in particular.
321
322 =item Solaris
323
324 C<c99> options have been cleaned up, hints look for C<solstudio>
325 as well as C<SUNWspro>, and support for native C<setenv> has been added.
326
327 =item VMS
328
329 C<finite>, C<finitel>, and C<isfinite> detection has been added to
330 C<configure.com>, environment handling has had some minor changes, and
331 a fix for legacy feature checking status.
332
333 =item Windows
334
335 C<%I64d> is now being used instead of C<%lld> for MinGW.
336
337 =back
338
339 =head1 Internal Changes
340
341 XXX Changes which affect the interface available to C<XS> code go here.  Other
342 significant internal changes for future core maintainers should be noted as
343 well.
344
345 [ List each change as a =item entry ]
346
347 =over 4
348
349 =item *
350
351 Added L<perlapi/sync_locale>.
352 Changing the program's locale should be avoided by XS code.  Nevertheless,
353 certain non-Perl libraries called from XS, such as C<Gtk> do so.  When this
354 happens, Perl needs to be told that the locale has changed.  Use this function
355 to do so, before returning to Perl.
356
357 =item *
358
359 Added L<perlapi/grok_atou> as a safer replacement for atoi and strtol.
360
361 =back
362
363 =head1 Selected Bug Fixes
364
365 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
366 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
367
368 [ List each fix as a =item entry ]
369
370 =over 4
371
372 =item *
373
374 Failing to compile C<use Foo> in an eval could leave a spurious
375 C<BEGIN> subroutine definition, which would produce a "Subroutine
376 BEGIN redefined" warning on the next use of C<use>, or other C<BEGIN>
377 block.  [perl #122107]
378
379 =item *
380
381 C<method { BLOCK } ARGS> syntax now correctly parses the arguments if they
382 begin with an opening brace.  [perl #46947]
383
384 =item *
385
386 External libraries and Perl may have different ideas of what the locale is.
387 This is problematic when parsing version strings if the locale's numeric
388 separator has been changed.  Version parsing has been patched to ensure
389 it handles the locales correctly.  [perl #121930]
390
391 =item *
392
393 A bug has been fixed where zero-length assertions and code blocks inside of a
394 regex could cause L<pos> to see an incorrect value.  [perl #122460]
395
396 =back
397
398 =head1 Known Problems
399
400 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
401 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
402 platform specific bugs also go here.
403
404 [ List each fix as a =item entry ]
405
406 =over 4
407
408 =item *
409
410 XXX
411
412 =back
413
414 =head1 Errata From Previous Releases
415
416 =over 4
417
418 =item *
419
420 XXX Add anything here that we forgot to add, or were mistaken about, in
421 the perldelta of a previous release.
422
423 =back
424
425 =head1 Acknowledgements
426
427 XXX Generate this with:
428
429   perl Porting/acknowledgements.pl v5.21.2..HEAD
430
431 =head1 Reporting Bugs
432
433 If you find what you think is a bug, you might check the articles recently
434 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
435 https://rt.perl.org/ .  There may also be information at
436 http://www.perl.org/ , the Perl Home Page.
437
438 If you believe you have an unreported bug, please run the L<perlbug> program
439 included with your release.  Be sure to trim your bug down to a tiny but
440 sufficient test case.  Your bug report, along with the output of C<perl -V>,
441 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
442
443 If the bug you are reporting has security implications, which make it
444 inappropriate to send to a publicly archived mailing list, then please send it
445 to perl5-security-report@perl.org.  This points to a closed subscription
446 unarchived mailing list, which includes all the core committers, who will be
447 able to help assess the impact of issues, figure out a resolution, and help
448 co-ordinate the release of patches to mitigate or fix the problem across all
449 platforms on which Perl is supported.  Please only use this address for
450 security issues in the Perl core, not for modules independently distributed on
451 CPAN.
452
453 =head1 SEE ALSO
454
455 The F<Changes> file for an explanation of how to view exhaustive details on
456 what changed.
457
458 The F<INSTALL> file for how to build Perl.
459
460 The F<README> file for general stuff.
461
462 The F<Artistic> and F<Copying> files for copyright information.
463
464 =cut