This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for PerlIO::scalar and nulls
[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 Printing to an in-memory handle no longer creates scalars that confuse the regular expression engine [perl #108398].
242
243 =item *
244
245 L<Pod::Html> has been upgraded from version 1.12 to 1.13
246
247 =item *
248
249 L<POSIX> has been upgraded from version 1.27 to version 1.29.
250
251 C<sigsuspend> and C<pause> now run signals handle before returning, as the
252 whole point of these two functions is to wait until a signal has
253 arrived, and then return I<after> it has been triggered.  Delayed, or
254 "safe", signals were preventing that from happening, possibly resulting in
255 race conditions [perl #107216].
256 C<POSIX::sleep> is now a direct call into the underlying OS C<sleep>
257 function, instead of being a Perl wrapper on C<CORE::sleep>. C<POSIX::dup2>
258 now returns the correct value on Win32 (I<i.e.> the file descriptor).
259 C<POSIX::SigSet> C<sigsuspend> and C<sigpending> and C<POSIX::pause> now
260 dispatch safe signals immediately before returning to their caller.
261
262 =item *
263
264 L<Pod::Perldoc> has been upgraded from version 3.15_01 to version 3.15_15.
265
266 =item *
267
268 L<Term::UI> has been upgraded from version 0.26 to version 0.30.
269
270 =item *
271
272 L<Tie::File> has been upgraded from version 0.96 to version 0.98.
273
274 =item *
275
276 L<Unicode::UCD> has been upgraded from version 0.37 to version 0.38.
277 This changes the output of C<prop_invmap()> for the Name_Alias property
278 to reflect the changes that are planned for Unicode 6.1, so that there
279 won't be a format change when upgrading to 6.1.  Briefly, a second
280 component of each alias is added that gives the type of alias it is.
281 Examples are at L<Unicode::UCD/prop_invmap()>.
282
283 =item *
284
285 L<Version::Requirements> has been upgraded from version 0.101020 to version 0.101021.
286
287 Version::Requirements is now DEPRECATED, use CPAN::Meta::Requirements,
288 which is a drop-in replacement.
289
290 =back
291
292 =head1 Documentation
293
294 =head2 Changes to Existing Documentation
295
296 =head3 L<perlfunc>
297
298 =over 4
299
300 =item *
301
302 C<dbmopen> treats a 0 mode as a special case, that prevents a nonexistent
303 file from being created.  This has been the case since Perl 5.000, but was
304 never documented anywhere.  Now the perlfunc entry mentions it
305 [perl #90064].
306
307 =item *
308
309 The entry for C<split> has been rewritten.  It is now far clearer than
310 before.
311
312 =back
313
314 =head3 L<perlop> and L<perlsyn>
315
316 =over 4
317
318 =item *
319
320 Documentation of the smartmatch operator has been reworked and moved from
321 perlsyn to perlop where it belongs.
322
323 =item *
324
325 Documentation of the ellipsis statement (C<...>) has been reworked and
326 moved from perlop to perlsyn.
327
328 =back
329
330 =head1 Diagnostics
331
332 The following additions or changes have been made to diagnostic output,
333 including warnings and fatal error messages.  For the complete list of
334 diagnostic messages, see L<perldiag>.
335
336 =head2 New Diagnostics
337
338 =head3 New Errors
339
340 =over 4
341
342 =item *
343
344 L<Cannot set tied @DB::args|perldiag/"Cannot set tied @DB::args">
345
346 This error occurs when C<caller> tries to set C<@DB::args> but finds it
347 tied.  Before this error was added, it used to crash instead.
348
349 =item *
350
351 L<Cannot tie unreifiable array|perldiag/"Cannot tie unreifiable array">
352
353 This error is part of a safety check that the C<tie> operator does before
354 tying a special array like C<@_>.  You should never see this message.
355
356 =back
357
358 =head3 New Warnings
359
360 =over 4
361
362 =item *
363
364 L<defined(@array) is deprecated|perldiag/"defined(@array) is deprecated">
365
366 The long-deprecated C<defined(@array)> now also warns for package variables.
367 Previously it only issued a warning for lexical variables.
368
369 =item *
370
371 L<Useless use of \E|perldiag/"Useless use of \E">
372
373 C<\E> does nothing unless preceded by C<\Q>, C<\L> or C<\U>.
374
375 =item *
376
377 L<overload arg '%s' is invalid|perldiag/"overload arg '%s' is invalid">
378
379 This warning, in the "overload" category, is produced when the overload
380 pragma is given an argument it doesn't recognize, presumably a mistyped
381 operator.
382
383 =back
384
385 =head2 Removals
386
387 =over 4
388
389 =item *
390
391 "sort is now a reserved word"
392
393 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
394 OK.)  This error message was added in Perl 3 to catch code like
395 C<close(sort)> which would no longer work.  More than two decades later,
396 this message is no longer appropriate.  Now C<sort> without arguments is
397 always allowed, and returns an empty list, as it did in those cases where
398 it was already allowed [perl #90030].
399
400 =back
401
402 =head1 Utility Changes
403
404 =head3 L<splain>
405
406 =over 4
407
408 =item *
409
410 splain no longer emits backtraces with the first line number repeated.
411 This:
412
413     Uncaught exception from user code:
414             Cannot fwiddle the fwuddle at -e line 1.
415      at -e line 1
416             main::baz() called at -e line 1
417             main::bar() called at -e line 1
418             main::foo() called at -e line 1
419
420 has become this:
421
422     Uncaught exception from user code:
423             Cannot fwiddle the fwuddle at -e line 1.
424             main::baz() called at -e line 1
425             main::bar() called at -e line 1
426             main::foo() called at -e line 1
427
428 =item *
429
430 Some error messages consist of multiple lines that are listed as separate
431 entries in L<perldiag>.  splain has been taught to find the separate
432 entries in these cases, instead of simply failing to find the message.
433
434 =back
435
436 =head1 Configuration and Compilation
437
438 =over 4
439
440 =item *
441
442 The Pod files for the perl FAQ, L<perlxs>, L<perlxstut> and L<perldoc>
443 are once again correctly installed in the same directory as the other core
444 Pods.
445
446 =for 5.16.0 This isn't a regression from 5.14.x, so don't mention this.
447
448 =back
449
450 =head1 Testing
451
452 =over 4
453
454 =item *
455
456 F<t/porting/utils.t> now tests that various utility scripts compile cleanly.
457 During development, this avoids the embarrassment of inadvertently pushing a
458 commit which breaks code which isn't otherwise tested by the regression test
459 suite. For example, F<installperl> and F<installman>, needed by
460 C<make install>, are tested here.
461
462 =back
463
464 =head1 Internal Changes
465
466 =over 4
467
468 =item *
469
470 There are now feature bundle hints in C<PL_hints> (C<$^H>) that version
471 declarations use, to avoid having to load F<feature.pm>.  One setting of
472 the hint bits indicates a "custom" feature bundle, which means that the
473 entries in C<%^H> still apply.  F<feature.pm> uses that.
474
475 The C<HINT_FEATURE_MASK> macro is defined in F<perl.h> along with other
476 hints.  Other macros for setting and testing features and bundles are in
477 the new F<feature.h>.  C<FEATURE_IS_ENABLED> (which has moved to
478 F<feature.h>) is no longer used throughout the codebase, but more specific
479 macros, e.g., C<FEATURE_SAY_IS_ENABLED>, that are defined in F<feature.h>.
480
481 =item *
482
483 F<lib/feature.pm> is now a generated file, created by the new
484 F<regen/feature.pl> script, which also generates F<feature.h>.
485
486 =item *
487
488 Tied arrays are now always C<AvREAL>.  If C<@_> or C<DB::args> is tied, it
489 is reified first, to make sure this is always the case.
490
491 =back
492
493 =head1 Selected Bug Fixes
494
495 =over 4
496
497 =item * "b . COND" in the debugger has been fixed
498
499 Breaking on the current line with C<b . COND> was broken by previous work and
500 has now been fixed.
501
502 =item * Tying C<%^H>
503
504 Tying C<%^H> no longer causes perl to crash or ignore
505 the contents of C<%^H> when entering a compilation
506 scope [perl #106282].
507
508 =item * C<~> on vstrings
509
510 The bitwise complement operator (and possibly other operators, too) when
511 passed a vstring would leave vstring magic attached to the return value,
512 even though the string had changed.  This meant that
513 C<< version->new(~v1.2.3) >> would create a version looking like "v1.2.3"
514 even though the string passed to C<< version->new >> was actually
515 "\376\375\374".  This also caused L<B::Deparse> to deparse C<~v1.2.3>
516 incorrectly, without the C<~> [perl #29070].
517
518 =item * Vstrings blowing away magic
519
520 Assigning a vstring to a magic (e.g., tied, C<$!>) variable and then
521 assigning something else used to blow away all the magic.  This meant that
522 tied variables would come undone, C<$!> would stop getting updated on
523 failed system calls, C<$|> would stop setting autoflush, and other
524 mischief would take place.  This has been fixed.
525
526 =item * C<newHVhv> and tied hashes
527
528 The C<newHVhv> XS function now works on tied hashes, instead of crashing or
529 returning an empty hash.
530
531 =item * Hashes will null elements
532
533 It is possible from XS code to create hashes with elements that have no
534 values.  Perl itself sometimes creates such hashes, but they are rarely
535 visible to Perl code.  The hash element and slice operators used to crash
536 when handling these in lvalue context.  These have been fixed.  They now
537 produce a "Modification of non-creatable hash value attempted" error
538 message.
539
540 =item * No warning for C<open(foo::bar)>
541
542 When one writes C<open foo || die>, which used to work in Perl 4, a
543 "Precedence problem" warning is produced.  This warning used erroneously to
544 apply to fully-qualified bareword handle names not followed by C<||>.  This
545 has been corrected.
546
547 =item * C<select> and package aliasing
548
549 After package aliasing (C<*foo:: = *bar::>), C<select> with 0 or 1 argument
550 would sometimes return a name that could not be used to refer to the
551 filehandle, or sometimes it would return C<undef> even when a filehandle
552 was selected.  Now it returns a typeglob reference in such cases.
553
554 =item * C<PerlIO::get_layers> and tied variables
555
556 C<PerlIO::get_layers> no longer ignores FETCH on tied variables as it used
557 to most of the time [perl #97956].
558
559 =item * C<PerlIO::get_layers> and numbers
560
561 C<PerlIO::get_layers> no longer ignores some arguments that it thinks are
562 numeric, while treating others as filehandle names.  It is now consistent
563 for flat scalars (i.e., not references).
564
565 =item * Lvalue subs and strict mode
566
567 Lvalue sub calls that are not determined to be such at compile time
568 (C<&$name> or &{"name"}) are no longer exempt from strict refs if they
569 occur in the last statement of an lvalue subroutine [perl #102486].
570
571 =item * Non-lvalue sub calls in potentially lvalue context
572
573 Sub calls whose subs are not visible at compile time, if
574 they occurred in the last statement of an lvalue subroutine,
575 would reject non-lvalue subroutines and die with "Can't modify non-lvalue
576 subroutine call" [perl #102486].
577
578 Non-lvalue sub calls whose subs I<are> visible at compile time exhibited
579 the opposite bug.  If the call occurred in the last statement of an lvalue
580 subroutine, there would be no error when the lvalue sub was called in
581 lvalue context.  Perl would blindly assign to the temporary value returned
582 by the non-lvalue subroutine.
583
584 =item * AUTOLOADing lvalue subs
585
586 C<AUTOLOAD> routines used to take precedence over the actual sub being
587 called (i.e., when autoloading wasn't needed), for sub calls in lvalue or
588 potential lvalue context, if the subroutine was not visible at compile
589 time.
590
591 =item * C<caller> and tied C<@DB::args>
592
593 C<caller> sets C<@DB::args> to the subroutine arguments when called from
594 the DB package.  It used to crash when doing so if C<@DB::args> happened to
595 be tied.  Now it croaks instead.
596
597 =item * Tying C<@_>
598
599 Under debugging builds, this code:
600
601   sub TIEARRAY{bless[]}
602   sub {
603     tie @_, "";
604     \@_;
605   }->(1);
606
607 use to produce an "av_reify called on tied array" warning.  It doesn't any
608 more.
609
610 =item * Unrecognised switches on C<#!> line
611
612 If a switch, such as B<-x>, that cannot occur on the C<#!> line is used
613 there, perl dies with "Can't emulate...".
614
615 It used to produce the same message for switches that perl did not
616 recognise at all, whether on the command line or the C<#!> line.
617
618 Now it produces the "Unrecognized switch" error message [perl #104288].
619
620 =item * C<system> and SIGCHLD
621
622 C<system> now temporarily blocks the SIGCHLD signal handler, to prevent the
623 signal handler from stealing the exit status [perl #105700].
624
625 =item * Deleting methods via C<delete>
626
627 Deletion of methods via C<delete $Class::{method}> syntax used to update
628 method caches if called in void context, but not scalar or list context.
629 Now it always updates those caches.
630
631 =item * Hash element deletion and destructors
632
633 When hash elements are deleted in void context, the internal hash entry is
634 now freed before the value is freed, to prevent destructors called by that
635 latter freeing from seeing the hash in an inconsistent state.  It was
636 possible to cause double-frees if the destructor freed the hash itself
637 [perl #100340].
638
639 =item * C<(s)printf>'s %n formatting code
640
641 The %n formatting code, which causes the number of characters to be
642 assigned to the next argument to C<printf> or C<sprintf> now actually
643 assigns the number of characters, instead of the number of bytes.
644
645 It also works now with special lvalue functions like C<substr> and with
646 nonexistent hash and array elements [perl #103492].
647
648 =item * Typeglobs and threads
649
650 Typeglobs returned from threads are no longer cloned if the parent thread
651 already has a glob with the same name.  This means that returned
652 subroutines will now assign to the right package variables [perl #107366].
653
654 =item * C<local $_>
655
656 In Perl 5.14, C<local $_> was changed to create a new variable not tied to
657 anything, even if $_ was tied before that.  But, due to an oversight, it
658 would still call FETCH once on a tied $_ before replacing it with the new
659 variable.  This has been fixed [perl #105912].
660
661 =item * Returning tied variables
662
663 When returning a value from a non-lvalue subroutine, Perl copies the value.
664 Sometimes it cheats for the sake of speed, and does not copy the value if
665 it makes no observable difference.  This optimisation was erroneously
666 allowing the copy to be skipped on tied variables, causing a difference in
667 behaviour depending on the tied variable's reference count.  This has been
668 fixed [perl #95548].
669
670 =item * C<{@a = sort}> no longer crashes
671
672 This particular piece of code (C<sort> with no arguments assigned to an
673 array, inside a block with no C<;>) started crashing in an earlier 5.15.x
674 release.  It has been fixed.
675
676 =item * C<utf8::decode> and read-only scalars
677
678 C<utf8::decode> now refuses to modify read-only scalars [perl #91850].
679
680 =item * C<dbmopen> with undefined mode
681
682 C<dbmopen> now only warns once, rather than three times, if the mode
683 argument is C<undef> [perl #90064].
684
685 =item * Freeing an aggregate during list assignment
686
687 If list assignment to a hash or array triggered destructors that freed the
688 hash or array itself, a crash would ensue.  This is no longer the case
689 [perl #107440].
690
691 =item * Confused internal bookkeeping with @ISA arrays
692
693 Creating a weak reference to an @ISA array or accessing the array index
694 (C<$#ISA>) could result in confused internal bookkeeping for elements
695 subsequently added to the @ISA array.  For instance, creating a weak
696 reference to the element itself could push that weak reference on to @ISA;
697 and elements added after use of C<$#ISA> would be ignored by method lookup
698 [perl #85670].
699
700 =item * DELETE on scalar ties
701
702 Tying an element of %ENV or C<%^H> and then deleting that element would
703 result in a call to the tie object's DELETE method, even though tying the
704 element itself is supposed to be equivalent to tying a scalar (the element
705 is, of course, a scalar) [perl #67490].
706
707 =item * Freeing $_ inside C<grep> or C<map>
708
709 Freeing $_ inside a C<grep> or C<map> block or a code block embedded in a
710 regular expression used to result in double frees [perl #92254, #92256].
711
712 =item * Warnings with C<+=>
713
714 The C<+=> operator does not usually warn when the left-hand side is
715 C<undef>, but it was doing so for tied variables.  This has been fixed
716 [perl #44895].
717
718 =item * Tying and autovivification
719
720 When Perl autovivifies an element of a tied array or hash (which entails
721 calling STORE with a new reference), it now calls FETCH immediately after
722 the STORE, instead of assuming that FETCH would have returned the same
723 reference.  This can make it easier to implement tied objects [perl #35865, #43011].
724
725 =item * C<@&> and C<$&>
726
727 Mentioning a variable named "&" other than C<$&> (i.e., C<@&> or C<%&>) no
728 longer stops C<$&> from working.  The same applies to variables named "'"
729 and "`" [perl #24237].
730
731 =item * Stacked filetests
732
733 C<-T> and C<-B> now work when stacked up with other filetest operators
734 [perl #77388].
735
736 =item * Filetests and stat buffers
737
738 Perl keeps several internal variables to keep track of the last stat
739 buffer, from which file(handle) it originated, what type it was, and
740 whether the last stat succeeded.
741
742 There were various cases where these could get out of synch, resulting in
743 inconsistent or erratic behaviour in edge cases (every mention of C<-T>
744 applies to C<-B> as well):
745
746 =over
747
748 =item *
749
750 C<-T I<HANDLE>>, even though it does a C<stat>, was not resetting the last
751 stat type, so an C<lstat _> following it would merrily return the wrong
752 results.  Also, it was not setting the success status.
753
754 =item *
755
756 Freeing the handle last used by C<stat> or a filetest could result in
757 S<C<-T _>> using an unrelated handle.
758
759 =item *
760
761 C<stat> with an IO reference (as returned by C<*STDIO{IO}>, for instance)
762 would not reset the stat type.
763
764 =item *
765
766 C<stat> with an IO reference was not recording the filehandle for
767 S<C<-T _>> to use.
768
769 =item *
770
771 The presence of fatal warnings could cause the stat buffer not to be reset
772 for a filetest operator on an unopened filehandle or C<-l> on any handle.
773
774 =item *
775
776 Fatal warnings would stop C<-T> from setting C<$!>.
777
778 =item *
779
780 When the last stat was on an unreadable file, C<-T _> is supposed to
781 return C<undef>, leaving the last stat buffer unchanged.  But it was
782 setting the stat type, causing C<lstat _> to stop working.
783
784 =item *
785
786 C<-T I<FILENAME>> was not resetting the internal stat buffers for
787 unreadable files.
788
789 =back
790
791 These have all been fixed.
792
793 =item * C<defined *{"!"}>
794
795 An earlier 5.15.x release caused this construct to stop the C<%!> hash
796 from working.  Likewise C<defined *{"+"}> and C<defined *{"-"}> caused
797 C<%+> and C<%->, respectively, to stop working.  This has been fixed.
798
799 =item * C<-T _> with no preceding C<stat>
800
801 This used to produce a confusing "uninitialized" warning, even though there
802 is no visible uninitialized value to speak of.
803
804 =item * C<stat I<HANDLE>> and fstat failures
805
806 If the operating system's C<fstat> function failed, C<stat> would warn
807 about an unopened handle, even though that was not the case.  This has been
808 fixed.
809
810 =item * C<lstat I<IOREF>>
811
812 C<lstat> is documented to fall back to C<stat> (with a warning) when given
813 a filehandle.  When passed an IO reference, it was actually doing the
814 equivalent of S<C<stat _>> and ignoring the handle.
815
816 =item * Crashes with warnings
817
818 Two warning messages that mention variable names started crashing in
819 5.15.5, but have been fixed [perl #106726, #107656].
820
821 =item * Bitwise assignment operators and copy-on-write
822
823 In 5.14.0, the bitwise assignment operators C<|=>, C<^=> and C<&=> starting
824 leaving the left-hand side undefined if it happened to be a copy-on-write
825 string.  This has been fixed [perl #108480].
826
827 =item * Three problematic Unicode characters now work better in regex pattern matching under C</i>
828
829 In the past, three Unicode characters:
830 LATIN SMALL LETTER SHARP S,
831 GREEK SMALL LETTER IOTA WITH DIALYTIKA AND TONOS,
832 and
833 GREEK SMALL LETTER UPSILON WITH DIALYTIKA AND TONOS,
834 along with the sequences that they fold to
835 (including "ss" in the case of LATIN SMALL LETTER SHARP S),
836 did not properly match under C</i>.  5.14.0 fixed some of these cases,
837 but introduced others, including a panic when one of the characters or
838 sequences was used in the C<(?(DEFINE)> regular expression predicate.
839 The known bugs that were introduced in 5.14 have now been fixed; as well
840 as some other edge cases that have never worked until now.  All these
841 involve using the characters and sequences outside bracketed character
842 classes under C</i>.  This closes [perl #98546].
843
844 There remain known problems when using certain characters with
845 multi-character folds inside bracketed character classes, including such
846 constructs as C<qr/[\N{LATIN SMALL LETTER SHARP}a-z]/i>.  These
847 remaining bugs are addressed in [perl #89774].
848
849 =back
850
851 =head1 Acknowledgements
852
853 Perl 5.15.7 represents approximately 4 weeks of development since Perl 5.15.6
854 and contains approximately 50,000 lines of changes across 470 files from 28
855 authors.
856
857 Perl continues to flourish into its third decade thanks to a vibrant community
858 of users and developers. The following people are known to have contributed the
859 improvements that became Perl 5.15.7:
860
861 Alberto Simões, Bo Lindbergh, Brian Fraser,
862 Chris 'BinGOs' Williams, Craig A. Berry, Dave
863 Rolsky, David Mitchell, Eric Brine, Father Chrysostomos, Florian Ragwitz,
864 H.Merijn Brand, Hojung Youn, James E Keenan, Joel Berger, Joshua ben Jore, Karl
865 Williamson, Leon Timmermans, Matthew Horsfall, Michael Witten, Nicholas Clark,
866 Reini Urban, Ricardo Signes, Shlomi Fish,
867 Steffen Müller, Steffen Schwigon, Todd Rinaldo,
868 Tom Christiansen, Tom Hukins, Tony Cook, Ævar Arnfjörð Bjarmason.
869
870 The list above is almost certainly incomplete as it is automatically generated
871 from version control history. In particular, it does not include the names of
872 the (very much appreciated) contributors who reported issues to the Perl bug
873 tracker.
874
875 Many of the changes included in this version originated in the CPAN modules
876 included in Perl's core. We're grateful to the entire CPAN community for
877 helping Perl to flourish.
878
879 For a more complete list of all of Perl's historical contributors, please see
880 the F<AUTHORS> file in the Perl source distribution.
881
882 =head1 Reporting Bugs
883
884 If you find what you think is a bug, you might check the articles
885 recently posted to the comp.lang.perl.misc newsgroup and the perl
886 bug database at http://rt.perl.org/perlbug/ .  There may also be
887 information at http://www.perl.org/ , the Perl Home Page.
888
889 If you believe you have an unreported bug, please run the L<perlbug>
890 program included with your release.  Be sure to trim your bug down
891 to a tiny but sufficient test case.  Your bug report, along with the
892 output of C<perl -V>, will be sent off to perlbug@perl.org to be
893 analysed by the Perl porting team.
894
895 If the bug you are reporting has security implications, which make it
896 inappropriate to send to a publicly archived mailing list, then please send
897 it to perl5-security-report@perl.org. This points to a closed subscription
898 unarchived mailing list, which includes
899 all the core committers, who will be able
900 to help assess the impact of issues, figure out a resolution, and help
901 co-ordinate the release of patches to mitigate or fix the problem across all
902 platforms on which Perl is supported. Please only use this address for
903 security issues in the Perl core, not for modules independently
904 distributed on CPAN.
905
906 =head1 SEE ALSO
907
908 The F<Changes> file for an explanation of how to view exhaustive details
909 on what changed.
910
911 The F<INSTALL> file for how to build Perl.
912
913 The F<README> file for general stuff.
914
915 The F<Artistic> and F<Copying> files for copyright information.
916
917 =cut