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