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