This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for bb4784f00 (Constant(undef))
[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.17.7
9
10 =head1 DESCRIPTION
11
12 This document describes differences between the 5.17.6 release and the 5.17.7
13 release.
14
15 If you are upgrading from an earlier release such as 5.17.5, first read
16 L<perl5176delta>, which describes differences between 5.17.5 and 5.17.6.
17
18 =head1 Notice
19
20 XXX Any important notices here
21
22 =head1 Core Enhancements
23
24 =head2 $&, $` and $' are no longer slow
25
26 These three infamous variables have been redeemed and no longer slow down
27 your program when used.  Hence, the /p regular expression flag now does
28 nothing.
29
30 =head1 Security
31
32 XXX Any security-related notices go here.  In particular, any security
33 vulnerabilities closed should be noted here rather than in the
34 L</Selected Bug Fixes> section.
35
36 [ List each security issue as a =head2 entry ]
37
38 =head1 Incompatible Changes
39
40 =head2 readline() with C<$/ = \N> now reads N characters, not N bytes
41
42 Previously, when reading from a stream with I/O layers such as
43 C<encoding>, the readline() function, otherwise known as the C<< <> >>
44 operator, would read I<N> bytes from the top-most layer. [perl #79960]
45
46 Now, I<N> characters are read instead.
47
48 There is no change in behaviour when reading from streams with no
49 extra layers, since bytes map exactly to characters.
50
51 =head2 Lexical subroutine warnings have moved
52
53 The warning about the use of an experimental feature emitted when lexical
54 subroutines (added in 5.17.4) are used now happens when the subroutine
55 itself is declared, not when the "lexical_subs" feature is activated via
56 C<use feature>.
57
58 This stops C<use feature ':all'> from warning, but causes
59 C<my sub foo; my sub bar> to warn twice.
60
61 =head1 Deprecations
62
63 XXX Any deprecated features, syntax, modules etc. should be listed here.  In
64 particular, deprecated modules should be listed here even if they are listed as
65 an updated module in the L</Modules and Pragmata> section.
66
67 [ List each deprecation as a =head2 entry ]
68
69 =head2 Lexical $_ is now deprecated
70
71 Since it was introduced in Perl 5.10, it has caused much confusion with no
72 obvious solution:
73
74 =over
75
76 =item *
77
78 Various modules (e.g., List::Util) expect callback routines to use the
79 global $_.  C<use List::Util 'first'; my $_; first { $_ == 1 } @list> does
80 not work as one would expect.
81
82 =item *
83
84 A C<my $_> declaration earlier in the same file can cause confusing closure
85 warnings.
86
87 =item *
88
89 The "_" subroutine prototype character allows called subroutines to access
90 your lexical $_, so it is not really private after all.
91
92 =item *
93
94 Nevertheless, subroutines with a "(@)" prototype and methods cannot access
95 the caller's lexical $_, unless they are written in XS.
96
97 =item *
98
99 But even XS routines cannot access a lexical $_ declared, not in the
100 calling subroutine, but in an outer scope, iff that subroutine happened not
101 to mention $_ or use any operators that default to $_.
102
103 =back
104
105 =head2 Various XS-callable functions are now deprecated
106
107 The following functions will be removed from a future version of Perl,
108 and should not be used.  With participating C compilers (e.g., gcc),
109 compiling any file that uses any of these will generate a warning.
110 These were not intended for public use; there are equivalent, faster,
111 macros for most of them.  See L<perlapi/Character classes>:
112 C<is_uni_ascii>,
113 C<is_uni_ascii_lc>,
114 C<is_uni_blank>,
115 C<is_uni_blank_lc>,
116 C<is_uni_cntrl>,
117 C<is_uni_cntrl_lc>,
118 C<is_uni_idfirst_lc>,
119 C<is_uni_space>,
120 C<is_uni_space_lc>,
121 C<is_uni_xdigit>,
122 C<is_uni_xdigit_lc>,
123 C<is_utf8_ascii>,
124 C<is_utf8_blank>,
125 C<is_utf8_cntrl>,
126 C<is_utf8_idcont>,
127 C<is_utf8_idfirst>,
128 C<is_utf8_perl_space>,
129 C<is_utf8_perl_word>,
130 C<is_utf8_posix_digit>,
131 C<is_utf8_space>,
132 C<is_utf8_xdigit>.
133 C<is_utf8_xidcont>,
134 C<is_utf8_xidfirst>,
135 C<to_uni_lower_lc>,
136 C<to_uni_title_lc>,
137 and
138 C<to_uni_upper_lc>.
139
140 =head1 Performance Enhancements
141
142 XXX Changes which enhance performance without changing behaviour go here.
143 There may well be none in a stable release.
144
145 [ List each enhancement as a =item entry ]
146
147 =over 4
148
149 =item *
150
151 Perl has a new copy-on-write mechanism that avoids the need to copy the
152 internal string buffer when assigning from one scalar to another.  This
153 makes copying large strings appear much faster.  Modifying one of the two
154 (or more) strings after an assignment will force a copy internally.  This
155 makes it unnecessary to pass strings by reference for efficiency.
156
157 =back
158
159 =head1 Modules and Pragmata
160
161 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
162 go here.  If Module::CoreList is updated, generate an initial draft of the
163 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
164 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
165 below.  A paragraph summary for important changes should then be added by hand.
166 In an ideal world, dual-life modules would have a F<Changes> file that could be
167 cribbed.
168
169 [ Within each section, list entries as a =item entry ]
170
171 =head2 New Modules and Pragmata
172
173 =over 4
174
175 =item *
176
177 XXX
178
179 =back
180
181 =head2 Updated Modules and Pragmata
182
183 =over 4
184
185 =item *
186
187 L<GDBM_File> has been upgraded from version 1.14 to 1.15. The undocumented
188 optional fifth parameter to C<TIEHASH> has been removed. This was intended
189 to provide control of the callback used by C<gdbm*> functions in case of
190 fatal errors (such as filesystem problems), but did not work (and could
191 never have worked). No code on CPAN even attempted to use it. The callback
192 is now always the previous default, C<croak>. Problems on some platforms with
193 how the C<C> C<croak> function is called have also been resolved.
194
195 =back
196
197 =head2 Removed Modules and Pragmata
198
199 =over 4
200
201 =item *
202
203 XXX
204
205 =back
206
207 =head1 Documentation
208
209 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
210 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
211
212 =head2 New Documentation
213
214 XXX Changes which create B<new> files in F<pod/> go here.
215
216 =head3 L<XXX>
217
218 XXX Description of the purpose of the new file here
219
220 =head2 Changes to Existing Documentation
221
222 XXX Changes which significantly change existing files in F<pod/> go here.
223 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
224 section.
225
226 =head3 L<perlapi/Character classes>
227
228 =over 4
229
230 =item *
231
232 There are quite a few macros callable from XS modules that classify
233 characters into things like alphabetic, punctuation, etc.  More of these
234 are now documented, including ones which work on characters whose code
235 points are outside the Latin-1 range.
236
237 =back
238
239 =head1 Diagnostics
240
241 The following additions or changes have been made to diagnostic output,
242 including warnings and fatal error messages.  For the complete list of
243 diagnostic messages, see L<perldiag>.
244
245 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
246 include any changes in L<perldiag> that reconcile it to the C<C> code.
247
248 =head2 New Diagnostics
249
250 XXX Newly added diagnostic messages go under here, separated into New Errors
251 and New Warnings
252
253 =head3 New Errors
254
255 =over 4
256
257 =item *
258
259 XXX L<message|perldiag/"message">
260
261 =back
262
263 =head3 New Warnings
264
265 =over 4
266
267 =item *
268
269 XXX L<message|perldiag/"message">
270
271 =back
272
273 =head2 Changes to Existing Diagnostics
274
275 XXX Changes (i.e. rewording) of diagnostic messages go here
276
277 =over 4
278
279 =item *
280
281 L<Constant(%s): Call to &{$^H{%s}} did not return a defined value|perldiag/Constant(%s): Call to &{$^H{%s}} did not return a defined value>
282
283 Constant overloading that returns C<undef> results in this error message.
284 For numeric constants, it used to say "Constant(undef)".  "undef" has been
285 replaced with the number itself. 
286
287 =back
288
289 =head1 Utility Changes
290
291 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
292 Most of these are built within the directories F<utils> and F<x2p>.
293
294 [ List utility changes as a =head3 entry for each utility and =item
295 entries for each change
296 Use L<XXX> with program names to get proper documentation linking. ]
297
298 =head3 L<XXX>
299
300 =over 4
301
302 =item *
303
304 XXX
305
306 =back
307
308 =head1 Configuration and Compilation
309
310 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
311 go here.  Any other changes to the Perl build process should be listed here.
312 However, any platform-specific changes should be listed in the
313 L</Platform Support> section, instead.
314
315 [ List changes as a =item entry ].
316
317 =over 4
318
319 =item *
320
321 XXX
322
323 =back
324
325 =head1 Testing
326
327 XXX Any significant changes to the testing of a freshly built perl should be
328 listed here.  Changes which create B<new> files in F<t/> go here as do any
329 large changes to the testing harness (e.g. when parallel testing was added).
330 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
331 that they represent may be covered elsewhere.
332
333 [ List each test improvement as a =item entry ]
334
335 =over 4
336
337 =item *
338
339 XXX
340
341 =back
342
343 =head1 Platform Support
344
345 XXX Any changes to platform support should be listed in the sections below.
346
347 [ Within the sections, list each platform as a =item entry with specific
348 changes as paragraphs below it. ]
349
350 =head2 New Platforms
351
352 XXX List any platforms that this version of perl compiles on, that previous
353 versions did not.  These will either be enabled by new files in the F<hints/>
354 directories, or new subdirectories and F<README> files at the top level of the
355 source tree.
356
357 =over 4
358
359 =item XXX-some-platform
360
361 XXX
362
363 =back
364
365 =head2 Discontinued Platforms
366
367 =over 4
368
369 =item BeOS
370
371 Support for BeOS has been removed.
372
373 =back
374
375 =head2 Platform-Specific Notes
376
377 XXX List any changes for specific platforms.  This could include configuration
378 and compilation changes or changes in portability/compatibility.  However,
379 changes within modules for platforms should generally be listed in the
380 L</Modules and Pragmata> section.
381
382 =over 4
383
384 =item XXX-some-platform
385
386 XXX
387
388 =back
389
390 =head1 Internal Changes
391
392 XXX Changes which affect the interface available to C<XS> code go here.  Other
393 significant internal changes for future core maintainers should be noted as
394 well.
395
396 [ List each change as a =item entry ]
397
398 =over 4
399
400 =item *
401
402 SvUPGRADE() is no longer an expression. Originally this macro (and its
403 underlying function, sv_upgrade()) were documented as boolean, although
404 in reality they always croaked on error and never returned false. In 2005
405 the documentation was updated to specify a void return value, but
406 SvUPGRADE() was left always returning 1 for backwards compatibility. This
407 has now been removed, and SvUPGRADE() is now a statement with no return
408 value.
409
410 So this is now a syntax error:
411
412     if (!SvUPGRADE(sv)) { croak(...); }
413
414 If you have code like that, simply replace it with
415
416     SvUPGRADE(sv);
417
418 or to to avoid compiler warnings with older perls, possibly
419
420     (void)SvUPGRADE(sv);
421
422 =item *
423
424 Perl has a new copy-on-write mechanism that allows any SvPOK scalar to be
425 upgraded to a copy-on-write scalar.  A reference count on the string buffer
426 is stored in the string buffer itself.
427
428 This breaks a few XS modules by allowing copy-on-write scalars to go
429 through code paths that never encountered them before.
430
431 This behaviour can still be disabled by running F<Configure> with
432 B<-Accflags=-DPERL_NO_COW>.  This option will probably be removed in Perl
433 5.20.
434
435 =item *
436
437 Copy-on-write no longer uses the SvFAKE and SvREADONLY flags.  Hence,
438 SvREADONLY indicates a true read-only SV.
439
440 Use the SvIsCOW macro (as before) to identify a copy-on-write scalar.
441
442 =item *
443
444 C<PL_sawampersand> is now a constant.  The switch this variable provided
445 (to enable/disable the pre-match copy depending on whether C<$&> had been
446 seen) has been removed and replaced with copy-on-write, eliminating a few
447 bugs.
448
449 The previous behaviour can still be enabled by running F<Configure> with
450 B<-Accflags=-DPERL_SAWAMPERSAND>.
451
452 =back
453
454 =head1 Selected Bug Fixes
455
456 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
457 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
458
459 [ List each fix as a =item entry ]
460
461 =over 4
462
463 =item *
464
465 C<sort {undef} ...> under fatal warnings no longer crashes.  It started
466 crashing in Perl 5.16.
467
468 =item *
469
470 Stashes blessed into each other
471 (C<bless \%Foo::, 'Bar'; bless \%Bar::, 'Foo'>) no longer result in double
472 frees.  This bug started happening in Perl 5.16.
473
474 =item *
475
476 Numerous memory leaks have been fixed, mostly involving fatal warnings and
477 syntax errors.
478
479 =item *
480
481 Lexical constants (C<my sub answer () { 42 }>) no longer cause double
482 frees.
483
484 =item *
485
486 Constant subroutine redefinition warns by default, but lexical constants
487 were accidentally exempt from default warnings.  This has been corrected.
488
489 =item *
490
491 Some failed regular expression matches such as C<'f' =~ /../g> were not
492 resetting C<pos>.  Also, "match-once" patterns (C<m?...?g>) failed to reset
493 it, too, when invoked a second time [perl #23180].
494
495 =item *
496
497 Accessing C<$&> after a pattern match now works if it had not been seen
498 before the match.  I.e., this applies to C<${'&'}> (under C<no strict>) and
499 C<eval '$&'>.  The same applies to C<$'> and C<$`> [perl #4289].
500
501 =item *
502
503 Several bugs involving C<local *ISA> and C<local *Foo::> causing stale
504 MRO caches have been fixed.  
505
506 =item *
507
508 Defining a subroutine when its typeglob has been aliased no longer results
509 in stale method caches.  This bug was introduced in Perl 5.10.
510
511 =item *
512
513 Localising a typeglob containing a subroutine when the typeglob's package
514 has been deleted from its parent stash no longer produces an error.  This
515 bug was introduced in Perl 5.14.
516
517 =item *
518
519 Under some circumstances, C<local *method=...> would fail to reset method
520 caches upon scope exit.
521
522 =item *
523
524 C</[.foo.]/> is no longer an error, but produces a warning (as before) and
525 is treated as C</[.fo]/> [perl #115818].
526
527 =item *
528
529 C<goto $tied_var> now calls FETCH before deciding what type of goto
530 (subroutine or label) this is.
531
532 =item *
533
534 Renaming packages through glob assignment
535 (C<*Foo:: = *Bar::; *Bar:: = *Baz::>) in combination with C<m?...?> and
536 C<reset> no longer makes threaded builds crash.
537
538 =item *
539
540 An earlier release in the 5.17.x series could crash if user code prevented
541 _charnames from loading via C<$INC{'_charnames.pm'}++>.
542
543 =back
544
545 =head1 Known Problems
546
547 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
548 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
549 platform specific bugs also go here.
550
551 [ List each fix as a =item entry ]
552
553 =over 4
554
555 =item *
556
557 XXX
558
559 =back
560
561 =head1 Obituary
562
563 XXX If any significant core contributor has died, we've added a short obituary
564 here.
565
566 =head1 Acknowledgements
567
568 XXX Generate this with:
569
570   perl Porting/acknowledgements.pl v5.17.6..HEAD
571
572 =head1 Reporting Bugs
573
574 If you find what you think is a bug, you might check the articles recently
575 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
576 http://rt.perl.org/perlbug/ .  There may also be information at
577 http://www.perl.org/ , the Perl Home Page.
578
579 If you believe you have an unreported bug, please run the L<perlbug> program
580 included with your release.  Be sure to trim your bug down to a tiny but
581 sufficient test case.  Your bug report, along with the output of C<perl -V>,
582 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
583
584 If the bug you are reporting has security implications, which make it
585 inappropriate to send to a publicly archived mailing list, then please send it
586 to perl5-security-report@perl.org.  This points to a closed subscription
587 unarchived mailing list, which includes all the core committers, who will be
588 able to help assess the impact of issues, figure out a resolution, and help
589 co-ordinate the release of patches to mitigate or fix the problem across all
590 platforms on which Perl is supported.  Please only use this address for
591 security issues in the Perl core, not for modules independently distributed on
592 CPAN.
593
594 =head1 SEE ALSO
595
596 The F<Changes> file for an explanation of how to view exhaustive details on
597 what changed.
598
599 The F<INSTALL> file for how to build Perl.
600
601 The F<README> file for general stuff.
602
603 The F<Artistic> and F<Copying> files for copyright information.
604
605 =cut