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