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