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