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