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