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