This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Update Module::CoreList for v5.15.7
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perldelta - what is new for perl v5.15.7
6
7 =head1 DESCRIPTION
8
9 This document describes differences between the 5.15.6 release and
10 the 5.15.7 release.
11
12 If you are upgrading from an earlier release such as 5.15.5, first read
13 L<perl5156delta>, which describes differences between 5.15.5 and
14 5.15.6.
15
16 =head1 Core Enhancements
17
18 =head2 C<use charnames> no longer needed for C<\N{I<name>}>
19
20 The C<charnames> module is now automatically loaded when needed as if
21 the C<:full> and C<:short> options had been specified.  See
22 L<charnames>.
23
24 =head2 Improved performance for Unicode properties in regular expressions
25
26 Matching a code point against a Unicode property is now done via a
27 binary search instead of linear.  This means for example that the worst
28 case for a 1000 item property is 10 probes instead of 1000.  This
29 inefficiency has been compensated for in the past by permanently storing
30 in a hash the results of a given probe plus the results for the adjacent
31 64 code points, under the theory that near-by code points are likely to
32 be searched for.  A separate hash was used for each mention of a Unicode
33 property in each regular expression.  Thus, C<qr/\p{foo}abc\p{foo}/>
34 would generate two hashes.  Any probes in one instance would be unknown
35 to the other, and the hashes could expand separately to be quite large
36 if the regular expression were used on many different widely-separated
37 code points.  This can lead to running out of memory in extreme cases.
38 Now, however, there is just one hash shared by all instances of a given
39 property.  This means that if C<\p{foo}> is matched against "A" in one
40 regular expression in a thread, the result will be known immediately to
41 all regular expressions, and the relentless march of using up memory is
42 slowed considerably.
43
44 =head1 Deprecations
45
46 =head2 Deprecated Modules
47
48 =over
49
50 =item L<Version::Requirements>
51
52 Version::Requirements is now DEPRECATED, use CPAN::Meta::Requirements,
53 which is a drop-in replacement. It will be deleted from perl.git blead
54 in v5.17.0.
55
56 =back
57
58 =head1 Performance Enhancements
59
60 =over 4
61
62 =item *
63
64 Version declarations with the C<use> keyword (e.g., C<use 5.012>) are now
65 faster, as they enable features without loading F<feature.pm>.
66
67 =item *
68
69 C<local $_> is faster now, as it no longer iterates through magic that it
70 is not going to copy anyway.
71
72 =back
73
74 =head1 Modules and Pragmata
75
76 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
77 go here.  If Module::CoreList is updated, generate an initial draft of the
78 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
79 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
80 below.  A paragraph summary for important changes should then be added by hand.
81 In an ideal world, dual-life modules would have a F<Changes> file that could be
82 cribbed.
83
84 [ Within each section, list entries as a =item entry ]
85
86 =head2 Updated Modules and Pragmata
87
88 =over 4
89
90 =item *
91
92 L<B::Deparse> has been upgraded from version 1.10 to version 1.11.
93
94 It now deparses C<open('random string')> correctly.  It used to omit the
95 quotation marks, which did not work if the string were not a valid
96 identifier [perl #91416].
97
98 A similar bug also affected hash and array elements such as
99 C<< 'random string'->[0] >>, which would deparse as C<$random string[0]>.
100 This has been fixed.
101
102 Those same syntaxes used to drop the package name from variables beginning
103 with a punctuation mark, as in C<< "foo::]"->{$key} >>.  This, too, has
104 been fixed.
105
106 B::Deparse no longer hangs when deparsing a program with stash
107 circularities, such as C<BEGIN { *Acme::Acme:: = *Acme:: }> [perl #91384].
108
109 C</$s[1]/> used to be deparsed as C<$s[1]> if @s were a lexical variable
110 [perl #81424].  Similarly, C</$#s/> would be deparsed as C<$#s> for both
111 lexical and package variables.  These has been fixed.
112
113 The C</applaud> regular expression flags are no longer omitted.
114
115 Feature hints are now deparsed with C<use feature> rather than C<%^H>
116 assignments.
117
118 A regression in 1.10 that caused C<ambient_pragmas> to disable strict mode
119 in obscure cases has been fixed.
120
121 Strict mode is now fully deparsed, including subs and vars [perl #24027].
122
123 The global variables C<$(>, C<$|> and C<$)> are now deparsed with braces
124 (i.e., C<${(}>) in regular expressions [perl #86060].
125
126 C<continue> blocks after C<for> loops are now deparsed correctly, as they
127 were back in 0.67 (included with Perl 5.8.5) [perl #108224]
128
129 =item *
130
131 L<CGI> has been upgraded from version 3.58 to version 3.59.
132
133 We no longer read from STDIN when the Content-Length is not set, preventing
134 requests with no Content-Length from freezing in some cases. This is consistent
135 with the CGI RFC 3875, and is also consistent with CGI::Simple. However, the old
136 behavior may have been expected by some command-line uses of CGI.pm.
137
138 =item *
139
140 L<CPAN::Meta> has been upgraded from version 2.112621 to version 2.113640.
141
142 Version::Requirements has now been merged as CPAN::Meta::Requirements.
143
144 =item *
145
146 L<CPANPLUS> has been upgraded from version 0.9113 to version 0.9116.
147
148 =item *
149
150 L<Data::Dumper> has been upgraded from version 2.135_01 to version
151 2.135_03.
152
153 It can now dump vstrings [perl #101162].
154
155 The nameless typeglob (C<*{""}>) is now dumped properly.
156
157 =item *
158
159 L<diagnostics> has been upgraded from version 1.26 to version 1.27.
160
161 See the entry for splain in the L</Utility Changes> section, for the
162 changes.  The diagnostics module and the splain utility are actually one
163 and the same.
164
165 =item *
166
167 L<ExtUtils::Packlist> has been upgraded from version 1.45 to version 1.46.
168
169 It no longer produces "used once" warnings when the C<read> and C<write>
170 methods are called while the main program is still compiling (e.g., from
171 within a BEGIN block) [perl #107410] [rt.cpan.org #50315].
172
173 =item *
174
175 L<ExtUtils::ParseXS> has been upgraded from version 3.08 to version 3.12.
176
177 =item *
178
179 L<Locale::Maketext> has been upgraded from version 1.21 to version 1.22.
180
181 =item *
182
183 L<Module::CoreList> has been upgraded from version 2.59 to version 2.60.
184
185 =item *
186
187 L<Module::Pluggable> has been upgraded from version 3.9 to version 4.0.
188
189 =item *
190
191 L<overload> has been upgraded from version 1.16 to version 1.17.
192
193 C<overload::Overloaded> no longer calls C<can> on the class, but uses
194 another means to determine whether the object has overloading.  It was
195 never correct for it to call C<can>, as overloading does not respect
196 AUTOLOAD.  So classes that autoload methods and implement C<can> no longer
197 have to account for overloading [perl #40333].
198
199 A warning is now produced for invalid arguments.  See L</New Diagnostics>.
200
201 =item *
202
203 L<perlfaq> has been upgraded from version 5.0150036 to version 5.0150038.
204
205 =item *
206
207 L<PerlIO::scalar> has been upgraded from version 0.12 to version 0.13.
208
209 (This is the module that implements C<< open $fh, '>', \$scalar >>.)
210
211 It no longer assumes during C<seek> that $scalar is a string internally.
212 If it didn't crash, it was close to doing so [perl #92706].  Also, the
213 internal print routine no longer assumes that the position set by C<seek>
214 is valid, but extends the string to that position, filling the intervening
215 bytes (between the old length and the seek position) with nulls
216 [perl #78980].
217
218 Printing to an in-memory handle now works if the $scalar holds a reference,
219 stringifying the reference before modifying it.  References used to be
220 treated as empty strings.
221
222 Printing to an in-memory handle no longer crashes if the $scalar happens to
223 hold a number internally, but no string buffer.
224
225 Printing to an in-memory handle no longer creates scalars that confuse the regular expression engine [perl #108398].
226
227 =item *
228
229 L<Pod::Html> has been upgraded from version 1.12 to 1.13
230
231 =item *
232
233 L<POSIX> has been upgraded from version 1.27 to version 1.29.
234
235 C<sigsuspend> and C<pause> now run signals handle before returning, as the
236 whole point of these two functions is to wait until a signal has
237 arrived, and then return I<after> it has been triggered.  Delayed, or
238 "safe", signals were preventing that from happening, possibly resulting in
239 race conditions [perl #107216].
240 C<POSIX::sleep> is now a direct call into the underlying OS C<sleep>
241 function, instead of being a Perl wrapper on C<CORE::sleep>. C<POSIX::dup2>
242 now returns the correct value on Win32 (I<i.e.> the file descriptor).
243 C<POSIX::SigSet> C<sigsuspend> and C<sigpending> and C<POSIX::pause> now
244 dispatch safe signals immediately before returning to their caller.
245
246 =item *
247
248 L<Pod::Perldoc> has been upgraded from version 3.15_01 to version 3.15_15.
249
250 =item *
251
252 L<Term::UI> has been upgraded from version 0.26 to version 0.30.
253
254 =item *
255
256 L<Tie::File> has been upgraded from version 0.96 to version 0.98.
257
258 =item *
259
260 L<Unicode::UCD> has been upgraded from version 0.37 to version 0.38.
261 This changes the output of C<prop_invmap()> for the Name_Alias property
262 to reflect the changes that are planned for Unicode 6.1, so that there
263 won't be a format change when upgrading to 6.1.  Briefly, a second
264 component of each alias is added that gives the type of alias it is.
265 Examples are at L<Unicode::UCD/prop_invmap()>.
266
267 =item *
268
269 L<Version::Requirements> has been upgraded from version 0.101020 to version 0.101021.
270
271 Version::Requirements is now DEPRECATED, use CPAN::Meta::Requirements,
272 which is a drop-in replacement.
273
274 =back
275
276 =head1 Documentation
277
278 =head2 Changes to Existing Documentation
279
280 =head3 L<perlfunc>
281
282 =over 4
283
284 =item *
285
286 C<dbmopen> treats a 0 mode as a special case, that prevents a nonexistent
287 file from being created.  This has been the case since Perl 5.000, but was
288 never documented anywhere.  Now the perlfunc entry mentions it
289 [perl #90064].
290
291 =item *
292
293 The entry for C<split> has been rewritten.  It is now far clearer than
294 before.
295
296 =back
297
298 =head3 L<perlop> and L<perlsyn>
299
300 =over 4
301
302 =item *
303
304 Documentation of the smartmatch operator has been reworked and moved from
305 perlsyn to perlop where it belongs.
306
307 =item *
308
309 Documentation of the ellipsis statement (C<...>) has been reworked and
310 moved from perlop to perlsyn.
311
312 =back
313
314 =head1 Diagnostics
315
316 The following additions or changes have been made to diagnostic output,
317 including warnings and fatal error messages.  For the complete list of
318 diagnostic messages, see L<perldiag>.
319
320 =head2 New Diagnostics
321
322 =head3 New Errors
323
324 =over 4
325
326 =item *
327
328 L<Cannot set tied @DB::args|perldiag/"Cannot set tied @DB::args">
329
330 This error occurs when C<caller> tries to set C<@DB::args> but finds it
331 tied.  Before this error was added, it used to crash instead.
332
333 =item *
334
335 L<Cannot tie unreifiable array|perldiag/"Cannot tie unreifiable array">
336
337 This error is part of a safety check that the C<tie> operator does before
338 tying a special array like C<@_>.  You should never see this message.
339
340 =back
341
342 =head3 New Warnings
343
344 =over 4
345
346 =item *
347
348 L<defined(@array) is deprecated|perldiag/"defined(@array) is deprecated">
349
350 The long-deprecated C<defined(@array)> now also warns for package variables.
351 Previously it only issued a warning for lexical variables.
352
353 =item *
354
355 L<Useless use of \E|perldiag/"Useless use of \E">
356
357 C<\E> does nothing unless preceded by C<\Q>, C<\L> or C<\U>.
358
359 =item *
360
361 L<overload arg '%s' is invalid|perldiag/"overload arg '%s' is invalid">
362
363 This warning, in the "overload" category, is produced when the overload
364 pragma is given an argument it doesn't recognize, presumably a mistyped
365 operator.
366
367 =back
368
369 =head2 Removals
370
371 =over 4
372
373 =item *
374
375 "sort is now a reserved word"
376
377 This error used to occur when C<sort> was called without arguments, followed by C<;> or C<)>.  (E.g., C<sort;> would die, but C<{sort}> was
378 OK.)  This error message was added in Perl 3 to catch code like
379 C<close(sort)> which would no longer work.  More than two decades later,
380 this message is no longer appropriate.  Now C<sort> without arguments is
381 always allowed, and returns an empty list, as it did in those cases where
382 it was already allowed [perl #90030].
383
384 =back
385
386 =head1 Utility Changes
387
388 =head3 L<splain>
389
390 =over 4
391
392 =item *
393
394 splain no longer emits backtraces with the first line number repeated.
395 This:
396
397     Uncaught exception from user code:
398             Cannot fwiddle the fwuddle at -e line 1.
399      at -e line 1
400             main::baz() called at -e line 1
401             main::bar() called at -e line 1
402             main::foo() called at -e line 1
403
404 has become this:
405
406     Uncaught exception from user code:
407             Cannot fwiddle the fwuddle at -e line 1.
408             main::baz() called at -e line 1
409             main::bar() called at -e line 1
410             main::foo() called at -e line 1
411
412 =item *
413
414 Some error messages consist of multiple lines that are listed as separate
415 entries in L<perldiag>.  splain has been taught to find the separate
416 entries in these cases, instead of simply failing to find the message.
417
418 =back
419
420 =head1 Configuration and Compilation
421
422 =over 4
423
424 =item *
425
426 The Pod files for the perl FAQ, L<perlxs>, L<perlxstut> and L<perldoc>
427 are once again correctly installed in the same directory as the other core
428 Pods.
429
430 =for 5.16.0 This isn't a regression from 5.14.x, so don't mention this.
431
432 =back
433
434 =head1 Testing
435
436 =over 4
437
438 =item *
439
440 F<t/porting/utils.t> now tests that various utility scripts compile cleanly.
441 During development, this avoids the embarrassment of inadvertently pushing a
442 commit which breaks code which isn't otherwise tested by the regression test
443 suite. For example, F<installperl> and F<installman>, needed by
444 C<make install>, are tested here.
445
446 =back
447
448 =head1 Internal Changes
449
450 =over 4
451
452 =item *
453
454 There are now feature bundle hints in C<PL_hints> (C<$^H>) that version
455 declarations use, to avoid having to load F<feature.pm>.  One setting of
456 the hint bits indicates a "custom" feature bundle, which means that the
457 entries in C<%^H> still apply.  F<feature.pm> uses that.
458
459 The C<HINT_FEATURE_MASK> macro is defined in F<perl.h> along with other
460 hints.  Other macros for setting and testing features and bundles are in
461 the new F<feature.h>.  C<FEATURE_IS_ENABLED> (which has moved to
462 F<feature.h>) is no longer used throughout the codebase, but more specific
463 macros, e.g., C<FEATURE_SAY_IS_ENABLED>, that are defined in F<feature.h>.
464
465 =item *
466
467 F<lib/feature.pm> is now a generated file, created by the new
468 F<regen/feature.pl> script, which also generates F<feature.h>.
469
470 =item *
471
472 Tied arrays are now always C<AvREAL>.  If C<@_> or C<DB::args> is tied, it
473 is reified first, to make sure this is always the case.
474
475 =back
476
477 =head1 Selected Bug Fixes
478
479 =over 4
480
481 =item * "b . COND" in the debugger has been fixed
482
483 Breaking on the current line with C<b . COND> was broken by previous work and
484 has now been fixed.
485
486 =item * Tying C<%^H>
487
488 Tying C<%^H> no longer causes perl to crash or ignore
489 the contents of C<%^H> when entering a compilation
490 scope [perl #106282].
491
492 =item * C<~> on vstrings
493
494 The bitwise complement operator (and possibly other operators, too) when
495 passed a vstring would leave vstring magic attached to the return value,
496 even though the string had changed.  This meant that
497 C<< version->new(~v1.2.3) >> would create a version looking like "v1.2.3"
498 even though the string passed to C<< version->new >> was actually
499 "\376\375\374".  This also caused L<B::Deparse> to deparse C<~v1.2.3>
500 incorrectly, without the C<~> [perl #29070].
501
502 =item * Vstrings blowing away magic
503
504 Assigning a vstring to a magic (e.g., tied, C<$!>) variable and then
505 assigning something else used to blow away all the magic.  This meant that
506 tied variables would come undone, C<$!> would stop getting updated on
507 failed system calls, C<$|> would stop setting autoflush, and other
508 mischief would take place.  This has been fixed.
509
510 =item * C<newHVhv> and tied hashes
511
512 The C<newHVhv> XS function now works on tied hashes, instead of crashing or
513 returning an empty hash.
514
515 =item * Hashes will null elements
516
517 It is possible from XS code to create hashes with elements that have no
518 values.  Perl itself sometimes creates such hashes, but they are rarely
519 visible to Perl code.  The hash element and slice operators used to crash
520 when handling these in lvalue context.  These have been fixed.  They now
521 produce a "Modification of non-creatable hash value attempted" error
522 message.
523
524 =item * No warning for C<open(foo::bar)>
525
526 When one writes C<open foo || die>, which used to work in Perl 4, a
527 "Precedence problem" warning is produced.  This warning used erroneously to
528 apply to fully-qualified bareword handle names not followed by C<||>.  This
529 has been corrected.
530
531 =item * C<select> and package aliasing
532
533 After package aliasing (C<*foo:: = *bar::>), C<select> with 0 or 1 argument
534 would sometimes return a name that could not be used to refer to the
535 filehandle, or sometimes it would return C<undef> even when a filehandle
536 was selected.  Now it returns a typeglob reference in such cases.
537
538 =item * C<PerlIO::get_layers> and tied variables
539
540 C<PerlIO::get_layers> no longer ignores FETCH on tied variables as it used
541 to most of the time [perl #97956].
542
543 =item * C<PerlIO::get_layers> and numbers
544
545 C<PerlIO::get_layers> no longer ignores some arguments that it thinks are
546 numeric, while treating others as filehandle names.  It is now consistent
547 for flat scalars (i.e., not references).
548
549 =item * Lvalue subs and strict mode
550
551 Lvalue sub calls that are not determined to be such at compile time
552 (C<&$name> or &{"name"}) are no longer exempt from strict refs if they
553 occur in the last statement of an lvalue subroutine [perl #102486].
554
555 =item * Non-lvalue sub calls in potentially lvalue context
556
557 Sub calls whose subs are not visible at compile time, if
558 they occurred in the last statement of an lvalue subroutine,
559 would reject non-lvalue subroutines and die with "Can't modify non-lvalue
560 subroutine call" [perl #102486].
561
562 Non-lvalue sub calls whose subs I<are> visible at compile time exhibited
563 the opposite bug.  If the call occurred in the last statement of an lvalue
564 subroutine, there would be no error when the lvalue sub was called in
565 lvalue context.  Perl would blindly assign to the temporary value returned
566 by the non-lvalue subroutine.
567
568 =item * AUTOLOADing lvalue subs
569
570 C<AUTOLOAD> routines used to take precedence over the actual sub being
571 called (i.e., when autoloading wasn't needed), for sub calls in lvalue or
572 potential lvalue context, if the subroutine was not visible at compile
573 time.
574
575 =item * C<caller> and tied C<@DB::args>
576
577 C<caller> sets C<@DB::args> to the subroutine arguments when called from
578 the DB package.  It used to crash when doing so if C<@DB::args> happened to
579 be tied.  Now it croaks instead.
580
581 =item * Tying C<@_>
582
583 Under debugging builds, this code:
584
585   sub TIEARRAY{bless[]}
586   sub {
587     tie @_, "";
588     \@_;
589   }->(1);
590
591 use to produce an "av_reify called on tied array" warning.  It doesn't any
592 more.
593
594 =item * Unrecognised switches on C<#!> line
595
596 If a switch, such as B<-x>, that cannot occur on the C<#!> line is used
597 there, perl dies with "Can't emulate...".
598
599 It used to produce the same message for switches that perl did not
600 recognise at all, whether on the command line or the C<#!> line.
601
602 Now it produces the "Unrecognized switch" error message [perl #104288].
603
604 =item * C<system> and SIGCHLD
605
606 C<system> now temporarily blocks the SIGCHLD signal handler, to prevent the
607 signal handler from stealing the exit status [perl #105700].
608
609 =item * Deleting methods via C<delete>
610
611 Deletion of methods via C<delete $Class::{method}> syntax used to update
612 method caches if called in void context, but not scalar or list context.
613 Now it always updates those caches.
614
615 =item * Hash element deletion and destructors
616
617 When hash elements are deleted in void context, the internal hash entry is
618 now freed before the value is freed, to prevent destructors called by that
619 latter freeing from seeing the hash in an inconsistent state.  It was
620 possible to cause double-frees if the destructor freed the hash itself
621 [perl #100340].
622
623 =item * C<(s)printf>'s %n formatting code
624
625 The %n formatting code, which causes the number of characters to be
626 assigned to the next argument to C<printf> or C<sprintf> now actually
627 assigns the number of characters, instead of the number of bytes.
628
629 It also works now with special lvalue functions like C<substr> and with
630 nonexistent hash and array elements [perl #3471, #103492].
631
632 =item * Typeglobs and threads
633
634 Typeglobs returned from threads are no longer cloned if the parent thread
635 already has a glob with the same name.  This means that returned
636 subroutines will now assign to the right package variables [perl #107366].
637
638 =item * C<local $_>
639
640 In Perl 5.14, C<local $_> was changed to create a new variable not tied to
641 anything, even if $_ was tied before that.  But, due to an oversight, it
642 would still call FETCH once on a tied $_ before replacing it with the new
643 variable.  This has been fixed [perl #105912].
644
645 =item * Returning tied variables
646
647 When returning a value from a non-lvalue subroutine, Perl copies the value.
648 Sometimes it cheats for the sake of speed, and does not copy the value if
649 it makes no observable difference.  This optimisation was erroneously
650 allowing the copy to be skipped on tied variables, causing a difference in
651 behaviour depending on the tied variable's reference count.  This has been
652 fixed [perl #95548].
653
654 =item * C<{@a = sort}> no longer crashes
655
656 This particular piece of code (C<sort> with no arguments assigned to an
657 array, inside a block with no C<;>) started crashing in an earlier 5.15.x
658 release.  It has been fixed.
659
660 =item * C<utf8::decode> and read-only scalars
661
662 C<utf8::decode> now refuses to modify read-only scalars [perl #91850].
663
664 =item * C<dbmopen> with undefined mode
665
666 C<dbmopen> now only warns once, rather than three times, if the mode
667 argument is C<undef> [perl #90064].
668
669 =item * Freeing an aggregate during list assignment
670
671 If list assignment to a hash or array triggered destructors that freed the
672 hash or array itself, a crash would ensue.  This is no longer the case
673 [perl #107440].
674
675 =item * Confused internal bookkeeping with @ISA arrays
676
677 Creating a weak reference to an @ISA array or accessing the array index
678 (C<$#ISA>) could result in confused internal bookkeeping for elements
679 subsequently added to the @ISA array.  For instance, creating a weak
680 reference to the element itself could push that weak reference on to @ISA;
681 and elements added after use of C<$#ISA> would be ignored by method lookup
682 [perl #85670].
683
684 =item * DELETE on scalar ties
685
686 Tying an element of %ENV or C<%^H> and then deleting that element would
687 result in a call to the tie object's DELETE method, even though tying the
688 element itself is supposed to be equivalent to tying a scalar (the element
689 is, of course, a scalar) [perl #67490].
690
691 =item * Freeing $_ inside C<grep> or C<map>
692
693 Freeing $_ inside a C<grep> or C<map> block or a code block embedded in a
694 regular expression used to result in double frees [perl #92254, #92256].
695
696 =item * Warnings with C<+=>
697
698 The C<+=> operator does not usually warn when the left-hand side is
699 C<undef>, but it was doing so for tied variables.  This has been fixed
700 [perl #44895].
701
702 =item * Tying and autovivification
703
704 When Perl autovivifies an element of a tied array or hash (which entails
705 calling STORE with a new reference), it now calls FETCH immediately after
706 the STORE, instead of assuming that FETCH would have returned the same
707 reference.  This can make it easier to implement tied objects [perl #35865, #43011].
708
709 =item * C<@&> and C<$&>
710
711 Mentioning a variable named "&" other than C<$&> (i.e., C<@&> or C<%&>) no
712 longer stops C<$&> from working.  The same applies to variables named "'"
713 and "`" [perl #24237].
714
715 =item * Stacked filetests
716
717 C<-T> and C<-B> now work when stacked up with other filetest operators
718 [perl #77388].
719
720 =item * Filetests and stat buffers
721
722 Perl keeps several internal variables to keep track of the last stat
723 buffer, from which file(handle) it originated, what type it was, and
724 whether the last stat succeeded.
725
726 There were various cases where these could get out of synch, resulting in
727 inconsistent or erratic behaviour in edge cases (every mention of C<-T>
728 applies to C<-B> as well):
729
730 =over
731
732 =item *
733
734 C<-T I<HANDLE>>, even though it does a C<stat>, was not resetting the last
735 stat type, so an C<lstat _> following it would merrily return the wrong
736 results.  Also, it was not setting the success status.
737
738 =item *
739
740 Freeing the handle last used by C<stat> or a filetest could result in
741 S<C<-T _>> using an unrelated handle.
742
743 =item *
744
745 C<stat> with an IO reference (as returned by C<*STDIO{IO}>, for instance)
746 would not reset the stat type.
747
748 =item *
749
750 C<stat> with an IO reference was not recording the filehandle for
751 S<C<-T _>> to use.
752
753 =item *
754
755 The presence of fatal warnings could cause the stat buffer not to be reset
756 for a filetest operator on an unopened filehandle or C<-l> on any handle.
757
758 =item *
759
760 Fatal warnings would stop C<-T> from setting C<$!>.
761
762 =item *
763
764 When the last stat was on an unreadable file, C<-T _> is supposed to
765 return C<undef>, leaving the last stat buffer unchanged.  But it was
766 setting the stat type, causing C<lstat _> to stop working.
767
768 =item *
769
770 C<-T I<FILENAME>> was not resetting the internal stat buffers for
771 unreadable files.
772
773 =back
774
775 These have all been fixed.
776
777 =item * C<defined *{"!"}>
778
779 An earlier 5.15.x release caused this construct to stop the C<%!> hash
780 from working.  Likewise C<defined *{"+"}> and C<defined *{"-"}> caused
781 C<%+> and C<%->, respectively, to stop working.  This has been fixed.
782
783 =item * C<-T _> with no preceding C<stat>
784
785 This used to produce a confusing "uninitialized" warning, even though there
786 is no visible uninitialized value to speak of.
787
788 =item * C<stat I<HANDLE>> and fstat failures
789
790 If the operating system's C<fstat> function failed, C<stat> would warn
791 about an unopened handle, even though that was not the case.  This has been
792 fixed.
793
794 =item * C<lstat I<IOREF>>
795
796 C<lstat> is documented to fall back to C<stat> (with a warning) when given
797 a filehandle.  When passed an IO reference, it was actually doing the
798 equivalent of S<C<stat _>> and ignoring the handle.
799
800 =item * Crashes with warnings
801
802 Two warning messages that mention variable names started crashing in
803 5.15.5, but have been fixed [perl #106726, #107656].
804
805 =item * Bitwise assignment operators and copy-on-write
806
807 In 5.14.0, the bitwise assignment operators C<|=>, C<^=> and C<&=> started
808 leaving the left-hand side undefined if it happened to be a copy-on-write
809 string.  This has been fixed [perl #108480].
810
811 =item * Three problematic Unicode characters now work better in regex pattern matching under C</i>
812
813 In the past, three Unicode characters:
814 LATIN SMALL LETTER SHARP S,
815 GREEK SMALL LETTER IOTA WITH DIALYTIKA AND TONOS,
816 and
817 GREEK SMALL LETTER UPSILON WITH DIALYTIKA AND TONOS,
818 along with the sequences that they fold to
819 (including "ss" in the case of LATIN SMALL LETTER SHARP S),
820 did not properly match under C</i>.  5.14.0 fixed some of these cases,
821 but introduced others, including a panic when one of the characters or
822 sequences was used in the C<(?(DEFINE)> regular expression predicate.
823 The known bugs that were introduced in 5.14 have now been fixed; as well
824 as some other edge cases that have never worked until now.  All these
825 involve using the characters and sequences outside bracketed character
826 classes under C</i>.  This closes [perl #98546].
827
828 There remain known problems when using certain characters with
829 multi-character folds inside bracketed character classes, including such
830 constructs as C<qr/[\N{LATIN SMALL LETTER SHARP}a-z]/i>.  These
831 remaining bugs are addressed in [perl #89774].
832
833 =back
834
835 =head1 Acknowledgements
836
837 Perl 5.15.7 represents approximately 4 weeks of development since Perl 5.15.6
838 and contains approximately 51,000 lines of changes across 480 files from 30
839 authors.
840
841 Perl continues to flourish into its third decade thanks to a vibrant community
842 of users and developers. The following people are known to have contributed the
843 improvements that became Perl 5.15.7:
844
845 Alberto Simões, Bo Lindbergh, Brian Fraser, Chris 'BinGOs' Williams, Craig A.
846 Berry, Dave Rolsky, David Mitchell, Eric Brine, Father Chrysostomos, Florian
847 Ragwitz, H.Merijn Brand, Hojung Youn, James E Keenan, Joel Berger, Joshua ben
848 Jore, Karl Williamson, Leon Timmermans, Matthew Horsfall, Michael Witten,
849 Nicholas Clark, Reini Urban, Ricardo Signes, Shlomi Fish, Steffen Müller,
850 Steffen Schwigon, Todd Rinaldo, Tom Christiansen, Tom Hukins, Tony Cook, Ævar
851 Arnfjörð Bjarmason.
852
853 The list above is almost certainly incomplete as it is automatically generated
854 from version control history. In particular, it does not include the names of
855 the (very much appreciated) contributors who reported issues to the Perl bug
856 tracker.
857
858 Many of the changes included in this version originated in the CPAN modules
859 included in Perl's core. We're grateful to the entire CPAN community for
860 helping Perl to flourish.
861
862 For a more complete list of all of Perl's historical contributors, please see
863 the F<AUTHORS> file in the Perl source distribution.
864
865 =head1 Reporting Bugs
866
867 If you find what you think is a bug, you might check the articles
868 recently posted to the comp.lang.perl.misc newsgroup and the perl
869 bug database at http://rt.perl.org/perlbug/ .  There may also be
870 information at http://www.perl.org/ , the Perl Home Page.
871
872 If you believe you have an unreported bug, please run the L<perlbug>
873 program included with your release.  Be sure to trim your bug down
874 to a tiny but sufficient test case.  Your bug report, along with the
875 output of C<perl -V>, will be sent off to perlbug@perl.org to be
876 analysed by the Perl porting team.
877
878 If the bug you are reporting has security implications, which make it
879 inappropriate to send to a publicly archived mailing list, then please send
880 it to perl5-security-report@perl.org. This points to a closed subscription
881 unarchived mailing list, which includes
882 all the core committers, who will be able
883 to help assess the impact of issues, figure out a resolution, and help
884 co-ordinate the release of patches to mitigate or fix the problem across all
885 platforms on which Perl is supported. Please only use this address for
886 security issues in the Perl core, not for modules independently
887 distributed on CPAN.
888
889 =head1 SEE ALSO
890
891 The F<Changes> file for an explanation of how to view exhaustive details
892 on what changed.
893
894 The F<INSTALL> file for how to build Perl.
895
896 The F<README> file for general stuff.
897
898 The F<Artistic> and F<Copying> files for copyright information.
899
900 =cut