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