This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta up to 8d0b139
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =for comment
4 This has been completed up to 8d0b139, except for
5 b0f2e9e nwclark     Fix two bugs related to pod files outside of pod/ (important enough?)
6 43d9ecf jpeacock    Set all version object math ops to noop
7 f300909 smueller    EU::ParseXS: Silence warning (probably unnecessary)
8
9 =head1 NAME
10
11 [ this is a template for a new perldelta file. Any text flagged as
12 XXX needs to be processed before release. ]
13
14 perldelta - what is new for perl v5.15.6
15
16 =head1 DESCRIPTION
17
18 This document describes differences between the 5.15.5 release and
19 the 5.15.6 release.
20
21 If you are upgrading from an earlier release such as 5.15.4, first read
22 L<perl5155delta>, which describes differences between 5.15.4 and
23 5.15.5.
24
25 =head1 Notice
26
27 XXX Any important notices here
28
29 =head1 Core Enhancements
30
31 XXX New core language features go here. Summarise user-visible core language
32 enhancements. Particularly prominent performance optimisations could go
33 here, but most should go in the L</Performance Enhancements> section.
34
35 [ List each enhancement as a =head2 entry ]
36
37 =head2 C<__SUB__>
38
39 The new C<__SUB__> token, available under the "current_sub" feature (see
40 L<feature>) or C<use v5.15>, returns a reference to the current subroutine,
41 making it easier to write recursive closures.
42
43 =head2 New option for the debugger's B<t> command
44
45 The B<t> command in the debugger, which toggles tracing mode, now accepts a
46 numerical argument that determines how many levels of subroutine calls to
47 trace.
48
49 =head2 Return value of C<tied>
50
51 The value returned by C<tied> on a tied variable is now the actual scalar
52 that holds the object to which the variable is tied.  This allows ties to
53 be weakened with C<Scalar::Util::weaken(tied $tied_variable)>.
54
55 =head2 Lvalue C<scalar>
56
57 C<scalar> can now be used as an lvalue.  You might consider this a new
58 feature (which is why it is listed in this section), but the author of
59 the change considered it a bug fix, since C<scalar> is only supposed to be
60 setting scalar context, not changing lvalueness [perl #24346].
61
62 =head1 Security
63
64 XXX Any security-related notices go here.  In particular, any security
65 vulnerabilities closed should be noted here rather than in the
66 L</Selected Bug Fixes> section.
67
68 =head2 C<is_utf8_char()>
69
70 The XS-callable function C<is_utf8_char()> when presented with malformed
71 UTF-8 input can read up to 12 bytes beyond the end of the string.  This
72 cannot be fixed without changing its API.  It is not called from CPAN.
73 The documentation for it now describes how to use it safely.
74
75 =head2 Other C<is_utf8_foo()> functions, as well as C<utf8_to_foo()>, etc.
76
77 Most of the other XS-callable functions that take UTF-8 encoded input
78 implicitly assume that the UTF-8 is valid (not malformed) in regards to
79 buffer length.  Do not do things such as change a character's case or
80 see if it is alphanumeric without first being sure that it is valid
81 UTF-8.  This can be safely done for a whole string by using one of the
82 functions C<is_utf8_string()>, C<is_utf8_string_loc()>, and
83 C<is_utf8_string_loclen()>.
84
85 =head1 Incompatible Changes
86
87 XXX For a release on a stable branch, this section aspires to be:
88
89     There are no changes intentionally incompatible with 5.XXX.XXX
90     If any exist, they are bugs and reports are welcome.
91
92 [ List each incompatible change as a =head2 entry ]
93
94 =head2 C<use I<VERSION>>
95
96 As of this release, version declarations like C<use v5.16> now disable all
97 features before enabling the new feature bundle.  This means that the
98 following holds true:
99
100     use 5.016;
101     # 5.16 features enabled here
102     use 5.014;
103     # 5.16 features disabled here
104
105 C<use v5.12> and higher continue to enable strict, but explicit
106 C<use strict> and C<no strict> now override the version declaration, even
107 when they come first:
108
109     no strict;
110     use 5.012;
111     # no strict here
112
113 There is a new ":default" feature bundle, that represents the set of
114 features enabled before any version declaration or C<use feature> has been
115 seen.  Version declarations below 5.10 now enable the ":default" feature
116 set.  This does not actually change the behaviour of C<use v5.8>, because
117 features added to the ":default" set are those that were traditionally
118 enabled by default, before they could be turned off.
119
120 C<$[> is now disabled under C<use v5.16>.  It is part of the default
121 feature set and can be turned on or off explicitly
122 with C<use feature 'array_base'>.
123
124 =head2 C<UNIVERSAL::VERSION>
125
126 The change to C<UNIVERSAL::VERSION> in 5.15.2 has been reverted.  It now
127 returns a stringified version object once more.
128
129 =head2 C<substr> lvalue revamp
130
131 When C<substr> is called in lvalue or potential lvalue context with two or
132 three arguments, a special lvalue scalar is returned that modifies the
133 original string (the first argument) when assigned to.
134
135 Previously, the offsets (the second and third arguments) passed to
136 C<substr> would be converted immediately to match the string, negative
137 offsets being translated to positive and offsets beyond the end of the
138 string being truncated.
139
140 Now, the offsets are recorded without modification in the special lvalue
141 scalar that is returned, and the original string is not even looked at by
142 C<substr> itself, but only when the returned lvalue is read or modified.
143
144 These changes result in several incompatible changes and bug fixes:
145
146 =over
147
148 =item *
149
150 If the original string changes length after the call to C<substr> but
151 before assignment to its return value, negative offsets will remember
152 their position from the end of the string, affecting code like this:
153
154     my $string = "string";
155     my $lvalue = \substr $string, -4, 2;
156     print $lvalue, "\n"; # prints "ri"
157     $string = "bailing twine";
158     print $lvalue, "\n"; # prints "wi"; used to print "il"
159
160 The same thing happens with an omitted third argument.  The returned lvalue
161 will always extend to the end of the string, even if the string becomes
162 longer.
163
164 =item *
165
166 Tied (and otherwise magical) variables are no longer exempt from the
167 "Attempt ot use reference as lvalue in substr" warning.
168
169 =item *
170
171 That warning now occurs when the returned lvalue is assigned to, not when
172 C<substr> itself is called.  This only makes a difference if the return
173 value of C<substr> is referenced and assigned to later.
174
175 =item *
176
177 The order in which "uninitialized" warnings occur for arguments to
178 C<substr> has changed.
179
180 =item *
181
182 Passing a substring of a read-only value or a typeglob to a function (potential lvalue context) no longer causes an immediate "Can't coerce" or "Modification of a read-only value" error.  That error only occurs if and
183 when the value passed is assigned to.
184
185 The same thing happens with the "substr outside of string" error.  If the
186 lvalue is only read, not written to, it is now just a warning, as with
187 rvalue C<substr>.
188
189 =item *
190
191 C<substr> assignments no longer call FETCH twice if the first argument is a
192 tied variable, but just once.
193
194 =back
195
196 It was impossible to fix all the bugs without an incompatible change, and
197 the behaviour of negative offsets was never specified, so the change was
198 deemed acceptable.
199
200 =head2 Return value of C<eval>
201
202 C<eval> returns C<undef> in scalar context or an empty list in list context
203 when there is a run-time error.  For syntax errors (when C<eval> is passed
204 a string), in list context it used to return a list containing a single
205 undefined element.  Now it returns an empty list in list context for all
206 errors [perl #80630].
207
208 =head2 Anonymous handles
209
210 Automatically generated file handles are now named __ANONIO__ when the
211 variable name cannot be determined, rather than $__ANONIO__.
212
213 =head2 Last-accessed filehandle
214
215 Perl has an internal variable that stores the last filehandle to be
216 accessed.  It is used by C<$.> and by C<tell> and C<eof> without arguments.
217
218 It used to be possible to set it to a glob copy and then modify that glob
219 copy to be something other than a glob, and still have it as the
220 last-accessed filehandle after assigning a glob to it again:
221
222     my $foo = *STDOUT;  # $foo is a glob copy
223     <$foo>;             # $foo is now the last-accessed handle
224     $foo = 3;           # no longer a glob
225     $foo = *STDERR;     # still the last-accessed handle
226
227 Now the C<$foo = 3> assignment unset that internal variable, so there is no
228 last-accessed filehandle, just as if C<< <$foo> >> had never happened.
229
230 =head2 XS API tweak
231
232 The C<newCONSTSUB_flags> C-level function, added in 5.15.4, now has a
233 C<len> parameter.
234
235 =head1 Deprecations
236
237 XXX Any deprecated features, syntax, modules etc. should be listed here.
238 In particular, deprecated modules should be listed here even if they are
239 listed as an updated module in the L</Modules and Pragmata> section.
240
241 [ List each deprecation as a =head2 entry ]
242
243 =head1 Performance Enhancements
244
245 XXX Changes which enhance performance without changing behaviour go here. There
246 may well be none in a stable release.
247
248 [ List each enhancement as a =item entry ]
249
250 =over 4
251
252 =item *
253
254 Perl 5.12.0 sped up the destruction of objects whose classes define empty
255 C<DESTROY> methods (to prevent autoloading), simply by not calling such
256 empty methods.  This release takes this optimisation a step further, by not
257 calling any C<DESTROY> method that begins with a C<return> statement.
258 This can be useful for destructors that are only used for debugging:
259
260     use constant DEBUG => 1;
261     sub DESTROY { return unless DEBUG; ... }
262
263 Constant-folding will reduce the first statement to C<return;> if DEBUG is
264 set to 0, triggering this optimisation.
265
266 =item *
267
268 Assign to a variable that holds a typeglob or copy-on-write scalar is now
269 much faster.  Previously the typeglob would be stringified or the
270 copy-on-write scalar would be copied before being clobbered.
271
272 =item *
273
274 Assignment to C<substr> in void context is now more than twice its
275 previous speed.  Instead of creating and returning a special lvalue scalar
276 that is then assigned to, C<substr> modifies the original string itself.
277
278 =back
279
280 =head1 Modules and Pragmata
281
282 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
283 go here.  If Module::CoreList is updated, generate an initial draft of the
284 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
285 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
286 below.  A paragraph summary for important changes should then be added by hand.
287 In an ideal world, dual-life modules would have a F<Changes> file that could be
288 cribbed.
289
290 [ Within each section, list entries as a =item entry ]
291
292 =head2 New Modules and Pragmata
293
294 =over 4
295
296 =item *
297
298 XXX
299
300 =back
301
302 =head2 Updated Modules and Pragmata
303
304 =over 4
305
306 =item *
307
308 L<Archive::Tar> has been upgraded from version 1.80 to version 1.82.
309
310 Adjustments to handle files >8gb (>0777777777777 octal) and a feature to
311 return the MD5SUM of files in the archive.
312
313 =item *
314
315 L<AutoLoader> has been upgraded from version 5.71 to version 5.72.
316
317 =item *
318
319 L<B::Debug> has been upgraded from version 1.16 to version 1.17.
320
321 =item *
322
323 L<B::Deparse> has been upgraded from version 1.09 to version 1.10.
324
325 Various constructs that used to be deparsed incorrectly have been fixed:
326
327 =over
328
329 =item C<sort(foo(bar))>
330
331 C<sort foo(bar)>, how it used to deparse, makes foo the sort routine,
332 rather than a regular function call.
333
334 =item Keys and values in C<%^H>
335
336 Undefined values in the hint hash were being deparsed as empty strings.
337 Whenever the hint hash changed, all undefined values, even those
338 unmodified, were being printed.
339
340 Special characters, such as quotation marks, were not being escaped
341 properly.
342
343 Some values used to be omitted if, for instance, a key was the same as a
344 previous value and vice versa.
345
346 =item "method BLOCK" syntax
347
348 C<method { $expr }> used to be deparsed as something like
349 C<< do{ $expr }->method >>, but the latter puts the $expr in scalar
350 context, whereas the former puts in list context.
351
352 =item C<do +{}> and C<do({})>
353
354 These are both variants of do-file syntax, but were being deparsed as
355 do-blocks.
356
357 =item Keywords that do not follow the llafr
358
359 Keywords like C<return> and C<last> that do not follow the
360 looks-like-a-function rule are now deparsed correctly with parentheses in
361 the right place.
362
363 Similarly, C<not>, which I<does> follow the llafr, was being deparsed as
364 though it does not.
365
366 =item C<=~>
367
368 In various cases, B::Deparse started adding a spurious C<$_ =~> before the
369 right-hand side in Perl 5.14; e.g., C<< "" =~ <$a> >> would become
370 C<< "" =~ ($_ =~ <$a>) >>.
371
372 =item C<open local *FH>
373
374 C<open>, C<pipe> and other functions that autovivify handles used to omit
375 C<local *> from C<local *FH>.
376
377 =item Negated single-letter subroutine calls
378
379 Negated subroutine calls like C<- f()> and C<-(f())> were being deparsed
380 as file test operators.
381
382 =item C<&{&}>
383
384 C<&{&}> and C<& &>, which are calls to the subroutine named "&", believe it
385 or not, were being deparsed as C<&&>.
386
387 =back
388
389 =item *
390
391 L<Carp> has been upgraded from version 1.23 to version 1.24.
392
393 It now tacks the last-accessed filehandle and line number on to the end of
394 the error message, just like C<die> [perl #96672].
395
396 =item *
397
398 L<Compress::Raw::Zlib> has been upgraded from version 2.042 to version 2.045.
399
400 =item *
401
402 L<Compress::Raw::Bzip2> has been upgraded from version 2.042 to version 2.045.
403
404 =item *
405
406 L<CPAN::Meta::YAML> has been upgraded from version 0.004 to version 0.005.
407
408 =item *
409
410 L<CPANPLUS> has been upgraded from version 0.9112 to version 0.9113.
411
412 =item *
413
414 L<Data::Dumper> has been upgraded from version 2.134 to version 2.135.
415
416 The XS implementation has been updated to account for the Unicode symbol
417 changes in Perl 5.15.4.  It also knows how to output typeglobs with nulls
418 in their names.
419
420 =item *
421
422 L<diagnostics> has been upgraded from version 1.25 to version 1.26.
423
424 It now understands the "%X" format code, which some error messages started
425 using in Perl 5.14.0.
426
427 =item *
428
429 L<Digest::SHA> has been upgraded from version 5.63 to version 5.70.
430
431 Added BITS mode to addfile method and shasum which makes partial-byte inputs
432 now possible via files/STDIN and allows shasum to check all 8074 NIST Msg vectors,
433 where previously special programming was required to do this.
434
435 =item *
436
437 L<Exporter> has been upgraded from version 5.65 to version 5.66.
438
439 It no longer tries to localise C<$_> unnecessarily.
440
441 =item *
442
443 L<ExtUtils::ParseXS> has been upgraded from version 3.05 to version 3.07.
444
445 =item *
446
447 L<IO::Compress::Base> has been upgraded from version 2.042 to version 2.045.
448
449 Added zipdetails utility.
450
451 =item *
452
453 L<Locale::Codes> has been upgraded from version 3.18 to version 3.20.
454
455 The code2XXX, XXX2code, all_XXX_codes, and all_XXX_names functions now support retired codes.
456 All codesets may be specified by a constant or by their name now. Previously,
457 they were specified only by a constant.
458 The alias_code function exists for backward compatibility. It has been replaced by rename_country_code.
459 The alias_code function will be removed sometime after September, 2013.
460 All work is now done in the central module (Locale::Codes). Previously, some was still done in the
461 wrapper modules (Locale::Codes::*) but that is gone now.
462 Added Language Family codes (langfam) as defined in ISO 639-5.
463
464 =item *
465
466 L<Module::Loaded> has been uprgaded from version 0.06 to version 0.08.
467
468 =item *
469
470 L<Pod::LaTeX> has been upgraded from version 0.59 to version 0.60.
471
472 Added another LaTeX escape: --- => -{}-{}-
473
474 Pod::LaTeX doesn't handle -- in PODs specially, passing it directly to
475 LaTeX, which then proceeds to replace it with a single -. This patch
476 replaces ----- with -{}-{}-{}-{}-
477
478 =item *
479
480 L<POSIX> has been upgraded from version 1.26 to version 1.27.
481
482 It no longer produces a "Constant subroutine TCSANOW redefined" warning on
483 Windows.
484
485 XXX When did it start producing that warning?  Was it post-5.15.5?  Even if
486 it was not, adding a note will help whoever compiles perl5160delta.
487
488 =item *
489
490 L<Socket> has been upgraded from version 1.94_02 to version 1.97.
491
492 =item *
493
494 L<threads> has been upgraded from version 1.85 to version 1.86.
495
496 =item *
497
498 L<Unicode::Collate> has been upgraded from version 0.85 to version 0.87.
499
500 Tailored compatibility ideographs as well as unified ideographs for
501 the locales: ja, ko, zh__big5han, zh__gb2312han, zh__pinyin, zh__stroke.
502
503 Now Locale/*.pl files are searched in @INC.
504
505 =item *
506
507 L<UNIVERSAL> has been upgraded from version 1.10 to version 1.11.
508
509 Documentation change clarifies return values from UNIVERSAL::VERSION.
510
511 =back
512
513 =head2 Removed Modules and Pragmata
514
515 =over 4
516
517 =item *
518
519 Changing the case of a UTF-8 encoded string under C<use locale> now
520 gives better, but still imperfect, results.  Previously, such a string
521 would entirely lose locale semantics and silently be treated as Unicode.
522 Now, the code points that are less than 256 are treated with locale
523 rules, while those above 255 are, of course, treated as Unicode.  See
524 L<perlfunc/lc> for more details, including the deficiencies of this
525 scheme.
526
527 =back
528
529 =head1 Documentation
530
531 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
532 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
533
534 =head2 New Documentation
535
536 XXX Changes which create B<new> files in F<pod/> go here.
537
538 =head3 L<XXX>
539
540 XXX Description of the purpose of the new file here
541
542 =head2 Changes to Existing Documentation
543
544 XXX Changes which significantly change existing files in F<pod/> go here.
545 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
546 section.
547
548 =head3 L<perlsec/Laundering and Detecting Tainted Data>
549
550 =over 4
551
552 =item *
553
554 The example function for checking for taintedness contained a subtle
555 error.  C<$@> needs to be localized to prevent its changing this
556 global's value outside the function.  The preferred method to check for
557 this, though, remains to use L<Scalar::Util/tainted>.
558
559 =back
560
561 =head1 Diagnostics
562
563 The following additions or changes have been made to diagnostic output,
564 including warnings and fatal error messages.  For the complete list of
565 diagnostic messages, see L<perldiag>.
566
567 XXX New or changed warnings emitted by the core's C<C> code go here. Also
568 include any changes in L<perldiag> that reconcile it to the C<C> code.
569
570 [ Within each section, list entries as a =item entry that links to perldiag,
571   e.g.
572
573   =item *
574
575   L<Invalid version object|perldiag/"Invalid version object">
576 ]
577
578 =head2 New Diagnostics
579
580 XXX Newly added diagnostic messages go here
581
582 =head3 New Errors
583
584 =over 4
585
586 =item *
587
588 XXX L<message|perldiag/"message">
589
590 =back
591
592 =head3 New Warnings
593
594 =over 4
595
596 =item *
597
598 XXX L<message|perldiag/"message">
599
600 =back
601
602 =head2 Changes to Existing Diagnostics
603
604 XXX Changes (i.e. rewording) of diagnostic messages go here
605
606 =over 4
607
608 =item *
609
610 Redefinition warnings for constant subroutines used to be mandatory, even
611 occurring under C<no warnings>.  Now they respect the L<warnings> pragma.
612
613 =item *
614
615 The "Attempt to free non-existent shared string" has had the spelling of
616 "non-existent" corrected to "nonexistent".  It was already listed with the
617 correct spelling in L<perldiag>.
618
619 =item *
620
621 The 'Use of "foo" without parentheses is ambiguous' warning has been
622 extended to apply also to user-defined subroutines with a (;$) prototype,
623 and not just to built-in functions.
624
625 =item *
626
627 The error messages for using C<default> and C<when> outside of a
628 topicalizer have been standardised to match the messages for C<continue>
629 and loop controls.  They now read 'Can't "default" outside a topicalizer'
630 and 'Can't "when" outside a topicalizer'.  They both used to be 'Can't use
631 when() outside a topicalizer' [perl #91514].
632
633 =back
634
635 =head1 Utility Changes
636
637 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
638 here. Most of these are built within the directories F<utils> and F<x2p>.
639
640 [ List utility changes as a =head3 entry for each utility and =item
641 entries for each change
642 Use L<XXX> with program names to get proper documentation linking. ]
643
644 =head3 L<zipdetails>
645
646 =over 4
647
648 =item *
649
650 L<zipdetails> displays information about the internal record structure of the zip file.
651 It is not concerned with displaying any details of the compressed data stored in the zip file.
652
653 =back
654
655 =head1 Configuration and Compilation
656
657 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
658 go here.  Any other changes to the Perl build process should be listed here.
659 However, any platform-specific changes should be listed in the
660 L</Platform Support> section, instead.
661
662 [ List changes as a =item entry ].
663
664 =over 4
665
666 =item *
667
668 F<pod/roffitall> is now build by F<pod/buildtoc>, instead of being shipped
669 with the distribution. Its list of manpages is now generated (and therefore
670 current). See also RT #103202 for an unresolved related issue.
671
672 =item *
673
674 Perl 5.15.5 had a bug in its installation script, which did not install
675 F<unicore/Name.pm>.  This has been corrected [perl #104226].
676
677 XXX Is that Perl version correct?  Is the file path correct?
678
679 =item *
680
681 The -Dusesitecustomize and -Duserelocatableinc options now work together
682 properly.
683
684 =back
685
686 =head1 Testing
687
688 XXX Any significant changes to the testing of a freshly built perl should be
689 listed here.  Changes which create B<new> files in F<t/> go here as do any
690 large changes to the testing harness (e.g. when parallel testing was added).
691 Changes to existing files in F<t/> aren't worth summarising, although the bugs
692 that they represent may be covered elsewhere.
693
694 [ List each test improvement as a =item entry ]
695
696 =over 4
697
698 =item *
699
700 The F<substr.t> and F<substr_thr.t> scripts for testing C<substr> have been
701 moved under F<t/op/>, where they were originally.  They had been moved
702 under F<t/re/> along with the substitution tests when that directory was
703 created.
704
705 =back
706
707 =head1 Platform Support
708
709 XXX Any changes to platform support should be listed in the sections below.
710
711 [ Within the sections, list each platform as a =item entry with specific
712 changes as paragraphs below it. ]
713
714 =head2 New Platforms
715
716 XXX List any platforms that this version of perl compiles on, that previous
717 versions did not. These will either be enabled by new files in the F<hints/>
718 directories, or new subdirectories and F<README> files at the top level of the
719 source tree.
720
721 =over 4
722
723 =item XXX-some-platform
724
725 XXX
726
727 =back
728
729 =head2 Discontinued Platforms
730
731 XXX List any platforms that this version of perl no longer compiles on.
732
733 =over 4
734
735 =item XXX-some-platform
736
737 XXX
738
739 =back
740
741 =head2 Platform-Specific Notes
742
743 XXX List any changes for specific platforms. This could include configuration
744 and compilation changes or changes in portability/compatibility.  However,
745 changes within modules for platforms should generally be listed in the
746 L</Modules and Pragmata> section.
747
748 =head3 VMS
749
750 =over 4
751
752 =item *
753
754 A link-time error on VMS versions without C<symlink> support was
755 introduced in 5.15.1, but has now been corrected.
756
757 =item *
758
759 Explicit support for VMS versions prior to v7.0 and DEC C versions prior
760 to v6.0 has been removed.
761
762 =item *
763
764 Since Perl 5.10.1, the home-grown C<stat> wrapper has been unable to
765 distinguish between a directory name containing an underscore and an
766 otherwise-identical filename containing a dot in the same position
767 (e.g., t/test_pl as a directory and t/test.pl as a file). This problem
768 has been corrected.
769
770 =back
771
772 =head1 Internal Changes
773
774 XXX Changes which affect the interface available to C<XS> code go here.
775 Other significant internal changes for future core maintainers should
776 be noted as well.
777
778 [ List each change as a =item entry ]
779
780 =over 4
781
782 =item *
783
784 XXX
785
786 =back
787
788 =head1 Selected Bug Fixes
789
790 XXX Important bug fixes in the core language are summarised here.
791 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
792 L</Modules and Pragmata>.
793
794 [ List each fix as a =item entry ]
795
796 =over 4
797
798 =item *
799
800 RT #78266: The regex engine has been leaking memory when accessing
801 named captures that weren't matched as part of a regex ever since 5.10
802 when they were introduced, e.g. this would consume over a hundred MB
803 of memory:
804
805     for (1..10_000_000) {
806         if ("foo" =~ /(foo|(?<capture>bar))?/) {
807             my $capture = $+{capture}
808         }
809     }
810     system "ps -o rss $$"'
811
812 =item *
813
814 A constant subroutine assigned to a glob whose name contains a null will no
815 longer cause extra globs to pop into existence when the constant is
816 referenced under its new name.
817
818 =item *
819
820 C<sort> was not treating C<sub {}> and C<sub {()}> as equivalent when such
821 a sub was provided as the comparison routine.  It used to croak on
822 C<sub {()}>.
823
824 =item *
825
826 Subroutines from the C<autouse> namespace are once more exempt from
827 redefinition warnings.  This used to work in 5.005, but was broken in 5.6
828 for most subroutines.  For subs created via XS that redefine subroutines
829 from the C<autouse> package, this stopped working in 5.10.
830
831 =item *
832
833 New XSUBs now produce redefinition warnings if they overwrite existing
834 subs, as they did in 5.8.x.  (The C<autouse> logic was reversed in 5.10-14.
835 Only subroutines from the C<autouse> namespace would warn when clobbered.)
836
837 =item *
838
839 Redefinition warnings triggered by the creation of XSUBs now respect
840 Unicode glob names, instead of using the internal representation.  This was
841 missed in 5.15.4, partly because this warning was so hard to trigger.  (See
842 the previous item.)
843
844 =item *
845
846 C<newCONSTSUB> used to use compile-time warning hints, instead of run-time
847 hints.  The following code should never produce a redefinition warning, but
848 it used to, if C<newCONSTSUB> redefine and existing subroutine:
849
850     use warnings;
851     BEGIN {
852         no warnings;
853         some_XS_function_that_calls_new_CONSTSUB();
854     }
855
856 =item *
857
858 Redefinition warnings for constant subroutines are on by default (what are
859 known as severe warnings in L<perldiag>).  This was only the case when it
860 was a glob assignment or declaration of a Perl subroutine that caused the
861 warning.  If the creation of XSUBs triggered the warning, it was not a
862 default warning.  This has been corrected.
863
864 =item *
865
866 The internal check to see whether a redefinition warning should occur used
867 to emit "uninitialized" warnings in cases like this:
868
869     use warnings "uninitialized";
870     use constant {u=>undef,v=>undef};
871     sub foo(){u} sub foo(){v}
872
873 =item *
874
875 A bug fix in Perl 5.14 introduced a new bug, causing "uninitialized"
876 warnings to report the wrong variable if the operator in question has
877 two operands and one is C<%{...}> or C<@{...}>.  This has been fixed
878 [perl #103766].
879
880 =item *
881
882 C<< version->new("version") >> and C<printf "%vd", "version"> no longer
883 crash [perl #102586].
884
885 =item *
886
887 C<$tied =~ y/a/b/>, C<chop $tied> and C<chomp $tied> now call FETCH just
888 once when $tied holds a reference.
889
890 =item *
891
892 Four-argument C<select> now always calls FETCH on tied arguments.  It used
893 to skip the call if the tied argument happened to hold C<undef> or a
894 typeglob.
895
896 =item *
897
898 Four-argument C<select> no longer produces its "Non-string passed as
899 bitmask" warning on tied or tainted variables that are strings.
900
901 =item *
902
903 C<sysread> now always calls FETCH on the buffer passed to it if it is tied.
904 It used to skip the call if the tied variable happened to hold a typeglob.
905
906 =item *
907
908 C<< $tied .= <> >> now calls FETCH once on C<$tied>.  It used to call it
909 multiple times if the last value assigned to or returned from the tied
910 variable was anything other than a string or typeglob.
911
912 =item *
913
914 The C<evalbytes> keyword added in 5.15.5 was respecting C<use utf8>
915 declarations from the outer scope, when it should have been ignoring them.
916
917 =item *
918
919 C<goto &func> no longers crashes, but produces an error message, when the
920 unwinding of the current subroutine's scope fires a destructor that
921 undefines the subroutine being "goneto" [perl #99850].
922
923 =item *
924
925 Arithmetic assignment (C<$left += $right>) involving overloaded objects that
926 rely on the 'nomethod' override no longer segfault when the left operand is not
927 overloaded.
928
929 =item *
930
931 Assigning C<__PACKAGE__> or any other shared hash key scalar to a stash
932 element no longer causes a double free.  Regardless of this change, the
933 results of such assignments are still undefined.
934
935 =item *
936
937 Creating a C<UNIVERSAL::AUTOLOAD> sub no longer stops C<%+>, C<%-> and
938 C<%!> from working some of the time [perl #105024].
939
940 =item *
941
942 Assigning C<__PACKAGE__> or another shared hash key string to a variable no
943 longer stops that variable from being tied if it happens to be a PVMG or
944 PVLV internally.
945
946 =item *
947
948 When presented with malformed UTF-8 input, the XS-callable functions
949 C<is_utf8_string()>, C<is_utf8_string_loc()>, and
950 C<is_utf8_string_loclen()> could read beyond the end of the input
951 string by up to 12 bytes.  This no longer happens.  [perl #32080].
952 However, currently, C<is_utf8_char()> still has this defect,
953 see L</is_utf8_char()> above.
954
955 =item *
956
957 Doing a substitution on a tied variable returning a copy-on-write scalar
958 used to cause an assertion failure or an "Attempt to free nonexistent
959 shared string" warning.
960
961 =item *
962
963 A change in perl 5.15.4 caused C<caller()> to produce malloc errors and a
964 crash with Perl's own malloc, and possibly with other malloc
965 implementations, too [perl #104034].
966
967 =item *
968
969 A bug fix in 5.15.5 could sometimes result in assertion failures under
970 debugging builds of perl for certain syntax errors in C<eval>, such as
971 C<eval(q|""!=!~//|);>
972
973 =item *
974
975 The "c [line num]" debugger command was broken by other debugger changes
976 release in 5.15.3.  This is now fixed.
977
978 =item *
979
980 Breakpoints were not properly restored after a debugger restart using the
981 "R" command.  This was broken in 5.15.3.  This is now fixed.
982
983 =item *
984
985 The debugger prompt did not display the current line in.  This was broken
986 in 5.15.3.  This is now fixed.
987
988 =item *
989
990 Class method calls still suffered from the Unicode bug with Latin-1 package
991 names.  This was missed in the Unicode package name cleanup in 5.15.4
992 [perl #105922].
993
994 =item *
995
996 The debugger no longer tries to do C<local $_> when dumping data
997 structures.
998
999 =item *
1000
1001 Calling C<readline($fh)> where $fh is a glob copy (e.g., after
1002 C<$fh = *STDOUT>), assigning something other than a glob to $fh, and then
1003 freeing $fh (e.g., by leaving the scope where it is defined) no longer
1004 causes the internal variable used by C<$.> (C<PL_last_in_gv>) to point to
1005 a freed scalar, that could be reused for some other glob, causing C<$.> to
1006 use some unrelated filehandle [perl #97988].
1007
1008 =item *
1009
1010 A regression in 5.14 caused these statements not to set the internal
1011 variable that holds the handle used by C<$.>:
1012
1013     my $fh = *STDOUT;
1014     tell $fh;
1015     eof  $fh;
1016     seek $fh, 0,0;
1017     tell     *$fh;
1018     eof      *$fh;
1019     seek     *$fh, 0,0;
1020     readline *$fh;
1021
1022 This is now fixed, but C<tell *{ *$fh }> still has the problem, and it is
1023 not clear how to fix it [perl #106536].
1024
1025 =item *
1026
1027 Version comparisons, such as those that happen implicitly with
1028 C<use v5.43>, no longer cause locale settings to change [perl #105784].
1029
1030 =back
1031
1032 =head1 Known Problems
1033
1034 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
1035 tests that had to be C<TODO>ed for the release would be noted here, unless
1036 they were specific to a particular platform (see below).
1037
1038 This is a list of some significant unfixed bugs, which are regressions
1039 from either 5.XXX.XXX or 5.XXX.XXX.
1040
1041 [ List each fix as a =item entry ]
1042
1043 =over 4
1044
1045 =item *
1046
1047 XXX
1048
1049 =back
1050
1051 =head1 Obituary
1052
1053 XXX If any significant core contributor has died, we've added a short obituary
1054 here.
1055
1056 =head1 Acknowledgements
1057
1058 XXX Generate this with:
1059
1060   perl Porting/acknowledgements.pl v5.15.5..HEAD
1061
1062 =head1 Reporting Bugs
1063
1064 If you find what you think is a bug, you might check the articles
1065 recently posted to the comp.lang.perl.misc newsgroup and the perl
1066 bug database at http://rt.perl.org/perlbug/ .  There may also be
1067 information at http://www.perl.org/ , the Perl Home Page.
1068
1069 If you believe you have an unreported bug, please run the L<perlbug>
1070 program included with your release.  Be sure to trim your bug down
1071 to a tiny but sufficient test case.  Your bug report, along with the
1072 output of C<perl -V>, will be sent off to perlbug@perl.org to be
1073 analysed by the Perl porting team.
1074
1075 If the bug you are reporting has security implications, which make it
1076 inappropriate to send to a publicly archived mailing list, then please send
1077 it to perl5-security-report@perl.org. This points to a closed subscription
1078 unarchived mailing list, which includes
1079 all the core committers, who will be able
1080 to help assess the impact of issues, figure out a resolution, and help
1081 co-ordinate the release of patches to mitigate or fix the problem across all
1082 platforms on which Perl is supported. Please only use this address for
1083 security issues in the Perl core, not for modules independently
1084 distributed on CPAN.
1085
1086 =head1 SEE ALSO
1087
1088 The F<Changes> file for an explanation of how to view exhaustive details
1089 on what changed.
1090
1091 The F<INSTALL> file for how to build Perl.
1092
1093 The F<README> file for general stuff.
1094
1095 The F<Artistic> and F<Copying> files for copyright information.
1096
1097 =cut