This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
add a change to perldelta
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perldelta - what is new for perl v5.25.1
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.25.0 release and the 5.25.1
10 release.
11
12 If you are upgrading from an earlier release such as 5.24.0, first read
13 L<perl5250delta>, which describes differences between 5.24.0 and 5.25.0.
14
15 =head1 Notice
16
17 XXX Any important notices here
18
19 =head1 Core Enhancements
20
21 XXX New core language features go here.  Summarize user-visible core language
22 enhancements.  Particularly prominent performance optimisations could go
23 here, but most should go in the L</Performance Enhancements> section.
24
25 [ List each enhancement as a =head2 entry ]
26
27 =head1 Security
28
29 XXX Any security-related notices go here.  In particular, any security
30 vulnerabilities closed should be noted here rather than in the
31 L</Selected Bug Fixes> section.
32
33 [ List each security issue as a =head2 entry ]
34
35 =head2 POSIX::tmpnam() has been removed
36
37 The fundamentally unsafe C<tmpnam()> interface was deprecated in
38 Perl 5.22.0 and has now been removed.  In its place you can use
39 for example the L<File::Temp> interfaces.
40
41 =head2 require ::Foo::Bar is now illegal.
42
43 Formerly, C<require ::Foo::Bar> would try to read F</Foo/Bar.pm>. Now any
44 bareword require which starts with a double colon dies instead.
45
46 =head2 Unescaped literal C<"{"> characters in regular expression
47 patterns are no longer permissible
48
49 You have to now say something like C<"\{"> or C<"[{]"> to specify to
50 match a LEFT CURLY BRACKET.  This will allow future extensions to the
51 language.  This restriction is not enforced, nor are there current plans
52 to enforce it, if the C<"{"> is the first character in the pattern.
53
54 These have been deprecated since v5.16, with a deprecation message
55 displayed starting in v5.22.
56
57 =head2 Literal control character variable names are no longer permissible
58
59 A variable name may no longer contain a literal control character under
60 any circumstances.  These previously were allowed in single-character
61 names on ASCII platforms, but have been deprecated there since Perl
62 v5.20.  This affects things like C<$I<\cT>>, where I<\cT> is a literal
63 control (such as a C<NAK> or C<NEGATIVE ACKNOWLEDGE> character) in the
64 source code.
65
66 =head2 C<qr//xx> is no longer permissible
67
68 Using more than one C</x> regular expression pattern modifier on a
69 single pattern is now forbidden.  This is to allow a future enhancement
70 to the language.  This usage has been deprecated since v5.22.
71
72 =head2 C<NBSP> is no longer permissible in C<\N{...}>
73
74 The name of a character may no longer contain non-breaking spaces.  It
75 has been deprecated to do so since Perl v5.22.
76
77 =head1 Deprecations
78
79 XXX Any deprecated features, syntax, modules etc. should be listed here.
80
81 =head2 Module removals
82
83 XXX Remove this section if inapplicable.
84
85 The following modules will be removed from the core distribution in a
86 future release, and will at that time need to be installed from CPAN.
87 Distributions on CPAN which require these modules will need to list them as
88 prerequisites.
89
90 The core versions of these modules will now issue C<"deprecated">-category
91 warnings to alert you to this fact.  To silence these deprecation warnings,
92 install the modules in question from CPAN.
93
94 Note that these are (with rare exceptions) fine modules that you are encouraged
95 to continue to use.  Their disinclusion from core primarily hinges on their
96 necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
97 not usually on concerns over their design.
98
99 =over
100
101 =item XXX
102
103 XXX Note that deprecated modules should be listed here even if they are listed
104 as an updated module in the L</Modules and Pragmata> section.
105
106 =back
107
108 [ List each other deprecation as a =head2 entry ]
109
110 =head1 Performance Enhancements
111
112 XXX Changes which enhance performance without changing behaviour go here.
113 There may well be none in a stable release.
114
115 [ List each enhancement as a =item entry ]
116
117 =over 4
118
119 =item *
120
121 Bareword constant strings are now permitted to take part in constant
122 folding. They were originally exempted from constant folding in August 1999,
123 during the development of Perl 5.6, to ensure that C<use strict "subs">
124 would still apply to bareword constants. That has now been accomplished a
125 different way, so barewords, like other constants, now gain the performance
126 benefits of constant folding.
127
128 This also means that void-context warnings on constant expressions of
129 barewords now report the folded constant operand, rather than the operation;
130 this matches the behaviour for non-bareword constants.
131
132 =back
133
134 =head1 Modules and Pragmata
135
136 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
137 go here.  If Module::CoreList is updated, generate an initial draft of the
138 following sections using F<Porting/corelist-perldelta.pl>.  A paragraph summary
139 for important changes should then be added by hand.  In an ideal world,
140 dual-life modules would have a F<Changes> file that could be cribbed.
141
142 [ Within each section, list entries as a =item entry ]
143
144 =head2 New Modules and Pragmata
145
146 =over 4
147
148 =item *
149
150 XXX
151
152 =back
153
154 =head2 Updated Modules and Pragmata
155
156 =over 4
157
158 =item *
159
160 L<POSIX> has been upgraded from version 1.66 to 1.69. This remedies several
161 defects in making its symbols exportable. [perl #127821]  Furthermore,
162 the C<POSIX::tmpnam()> interface has been removed,
163 see L</"POSIX::tmpnam() has been removed">.
164
165 =back
166
167 =head2 Removed Modules and Pragmata
168
169 =over 4
170
171 =item *
172
173 XXX
174
175 =back
176
177 =head1 Documentation
178
179 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
180 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
181
182 =head2 New Documentation
183
184 XXX Changes which create B<new> files in F<pod/> go here.
185
186 =head3 L<XXX>
187
188 XXX Description of the purpose of the new file here
189
190 =head2 Changes to Existing Documentation
191
192 =over 4
193
194 =item *
195
196 Fixed link to Crosby paper on hash complexity attack in L<perlsec>.
197
198 =back
199
200 XXX Changes which significantly change existing files in F<pod/> go here.
201 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
202 section.
203
204 =head3 L<XXX>
205
206 =over 4
207
208 =item *
209
210 XXX Description of the change here
211
212 =back
213
214 =head1 Diagnostics
215
216 The following additions or changes have been made to diagnostic output,
217 including warnings and fatal error messages.  For the complete list of
218 diagnostic messages, see L<perldiag>.
219
220 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
221 include any changes in L<perldiag> that reconcile it to the C<C> code.
222
223 =head2 New Diagnostics
224
225 XXX Newly added diagnostic messages go under here, separated into New Errors
226 and New Warnings
227
228 =head3 New Errors
229
230 =over 4
231
232 =item *
233
234 L<Bareword in require contains "%s"|perldiag/"Bareword in require contains "%s"">
235
236 =item *
237
238 L<Bareword in require maps to empty filename|perldiag/"Bareword in require maps to empty filename">
239
240 =item *
241
242 L<Bareword in require maps to disallowed filename "%s"|perldiag/"Bareword in require maps to disallowed filename "%s"">
243
244 =item *
245
246 L<Bareword in require must not start with a double-colon: "%s"|perldiag/"Bareword in require must not start with a double-colon: "%s"">
247
248 =back
249
250 =head3 New Warnings
251
252 =over 4
253
254 =item *
255
256 XXX L<message|perldiag/"message">
257
258 =back
259
260 =head2 Changes to Existing Diagnostics
261
262 XXX Changes (i.e. rewording) of diagnostic messages go here
263
264 =over 4
265
266 =item *
267
268 Code like C<$x = $x . "a"> was incorrectly failing to yield a
269 L<use of uninitialized value|perldiag/"Use of uninitialized value%s">
270 warning when C<$x> was a lexical variable with an undefined value. That has
271 now been fixed. [perl #127877]
272
273 =item *
274
275 When the error "Experimental push on scalar is now forbidden" is raised for
276 the hash functions C<keys>, C<each>, and C<values>, it is now followed by
277 the more helpful message, "Type of arg 1 to whatever must be hash or
278 array". [perl #127976]
279
280 =item *
281
282 C<undef *_; shift> or C<undef *_; pop> inside a subroutine, with no
283 argument to C<shift> or C<pop>, began crashing in Perl 5.14.0, but has now
284 been fixed.
285
286 =item *
287
288 C<< "string$scalar->$*" >> now correctly prefers concat overloading to
289 string overlading if C<< $scalar->$* >> returns an overloaded object,
290 bringing it into consistency with C<$$scalar>.
291
292 =item *
293
294 C<< /@0{0*->@*/*0 >> and similar contortions used to crash, but no longer
295 do, but merely produce a syntax error. [perl #128171]
296
297 =item *
298
299 C<do> or C<require> with a reference or typeglob which, when stringified,
300 contains a null character started crashing in Perl 5.20.0, but has now been
301 fixed. [perl #128182]
302
303 =back
304
305 =head1 Utility Changes
306
307 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
308 Most of these are built within the directory F<utils>.
309
310 [ List utility changes as a =head2 entry for each utility and =item
311 entries for each change
312 Use L<XXX> with program names to get proper documentation linking. ]
313
314 =head2 L<perlbug>
315
316 =over 4
317
318 =item *
319
320 Long lines in the message body are now wrapped at 900 characters, to stay
321 well within the 1000-character limit imposed by SMTP mail transfer agents.
322 This is particularly likely to be important for the list of arguments to
323 C<Configure>, which can readily exceed the limit if, for example, it names
324 several non-default installation paths. This change also adds the first unit
325 tests for perlbug. [perl #128020]
326
327 =back
328
329 =head1 Configuration and Compilation
330
331 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
332 go here.  Any other changes to the Perl build process should be listed here.
333 However, any platform-specific changes should be listed in the
334 L</Platform Support> section, instead.
335
336 [ List changes as a =item entry ].
337
338 =over 4
339
340 =item *
341
342 C<Configure> now builds C<miniperl> and C<generate_uudmap> if you
343 invoke it with C<-Dusecrosscompiler> but not C<-Dtargethost=somehost>.
344 This means you can supply your target platform C<config.sh>, generate
345 the headers and proceed to build your cross-target perl.  [perl #127234]
346
347 =item *
348
349 Builds with C<-Accflags=-DPERL_TRACE_OPS> now only dump the operator
350 counts when the environment variable C<PERL_TRACE_OPS> to be set to a
351 non-zero integer.  This allows C<make test> to pass on such a build.
352
353 =item *
354
355 When building with GCC 6 and link-time optimization (the C<-flto> option to
356 C<gcc>), C<Configure> was treating all probed symbols as present on the
357 system, regardless of whether they actually exist. This has been fixed.
358 [perl #128131]
359
360 =item *
361
362 The F<t/test.pl> library is used for internal testing of Perl itself, and
363 also copied by several CPAN modules. Some of those modules must work on
364 older versions of Perl, so F<t/test.pl> must in turn avoid newer Perl
365 features. Compatibility with Perl 5.8 was inadvertently removed some time
366 ago; it has now been restored. [perl #128052]
367
368 =item *
369
370 The build process no longer emits an extra blank line before building each
371 "simple" extension (those with only F<*.pm> and F<*.pod> files).
372
373 =back
374
375 =head1 Testing
376
377 XXX Any significant changes to the testing of a freshly built perl should be
378 listed here.  Changes which create B<new> files in F<t/> go here as do any
379 large changes to the testing harness (e.g. when parallel testing was added).
380 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
381 that they represent may be covered elsewhere.
382
383 [ List each test improvement as a =item entry ]
384
385 =over 4
386
387 =item *
388
389 XXX
390
391 =back
392
393 =head1 Platform Support
394
395 XXX Any changes to platform support should be listed in the sections below.
396
397 [ Within the sections, list each platform as a =item entry with specific
398 changes as paragraphs below it. ]
399
400 =head2 New Platforms
401
402 XXX List any platforms that this version of perl compiles on, that previous
403 versions did not.  These will either be enabled by new files in the F<hints/>
404 directories, or new subdirectories and F<README> files at the top level of the
405 source tree.
406
407 =over 4
408
409 =item XXX-some-platform
410
411 XXX
412
413 =back
414
415 =head2 Discontinued Platforms
416
417 XXX List any platforms that this version of perl no longer compiles on.
418
419 =over 4
420
421 =item XXX-some-platform
422
423 XXX
424
425 =back
426
427 =head2 Platform-Specific Notes
428
429 XXX List any changes for specific platforms.  This could include configuration
430 and compilation changes or changes in portability/compatibility.  However,
431 changes within modules for platforms should generally be listed in the
432 L</Modules and Pragmata> section.
433
434 =over 4
435
436 =item XXX-some-platform
437
438 XXX
439
440 =back
441
442 =head1 Internal Changes
443
444 XXX Changes which affect the interface available to C<XS> code go here.  Other
445 significant internal changes for future core maintainers should be noted as
446 well.
447
448 [ List each change as a =item entry ]
449
450 =over 4
451
452 =item *
453
454 Perl is now built with the C<PERL_OP_PARENT> compiler define enabled by
455 default. To disable it, use the C<PERL_NO_OP_PARENT> compiler define.
456 This flag alters how the C<op_sibling> field is used in C<OP> structures,
457 and has been available optionally since perl 5.22.0.
458
459 See L<perl5220delta/"Internal Changes"> for more details of what this
460 build option does.
461
462 =back
463
464 =head1 Selected Bug Fixes
465
466 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
467 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
468
469 [ List each fix as a =item entry ]
470
471 =over 4
472
473 =item *
474
475 Expressions containing an C<&&> or C<||> operator (or their synonyms C<and>
476 and C<or>) were being compiled incorrectly in some cases. If the left-hand
477 side consisted of either a negated bareword constant or a negated C<do {}>
478 block containing a constant expression, and the right-hand side consisted of
479 a negated non-foldable expression, one of the negations was effectively
480 ignored. The same was true of C<if> and C<unless> statement modifiers,
481 though with the left-hand and right-hand sides swapped. This long-standing
482 bug has now been fixed. [perl #127952]
483
484 =item *
485
486 C<reset> with an argument no longer crashes when encountering stash entries
487 other than globs. [perl #128106]
488
489 =item *
490
491 Assignment of hashes to, and deletion of, typeglobs named C<*::::::> no
492 longer causes crashes. [perl #128086]
493
494 =back
495
496 =head1 Known Problems
497
498 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
499 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
500 platform specific bugs also go here.
501
502 [ List each fix as a =item entry ]
503
504 =over 4
505
506 =item *
507
508 XXX
509
510 =back
511
512 =head1 Errata From Previous Releases
513
514 =over 4
515
516 =item *
517
518 XXX Add anything here that we forgot to add, or were mistaken about, in
519 the perldelta of a previous release.
520
521 =back
522
523 =head1 Obituary
524
525 XXX If any significant core contributor has died, we've added a short obituary
526 here.
527
528 =head1 Acknowledgements
529
530 Generate this with:
531
532   perl Porting/acknowledgements.pl v5.25.1..HEAD
533
534 =head1 Reporting Bugs
535
536 If you find what you think is a bug, you might check the articles recently
537 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
538 L<https://rt.perl.org/> .  There may also be information at
539 L<http://www.perl.org/> , the Perl Home Page.
540
541 If you believe you have an unreported bug, please run the L<perlbug> program
542 included with your release.  Be sure to trim your bug down to a tiny but
543 sufficient test case.  Your bug report, along with the output of C<perl -V>,
544 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
545
546 If the bug you are reporting has security implications which make it
547 inappropriate to send to a publicly archived mailing list, then see
548 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
549 for details of how to report the issue.
550
551 =head1 SEE ALSO
552
553 The F<Changes> file for an explanation of how to view exhaustive details on
554 what changed.
555
556 The F<INSTALL> file for how to build Perl.
557
558 The F<README> file for general stuff.
559
560 The F<Artistic> and F<Copying> files for copyright information.
561
562 =cut