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