This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for 5c0877fa4ac0 (VMS include files).
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
61174fb5 5perldelta - what is new for perl v5.17.1
27f00e3d 6
f9001595 7=head1 DESCRIPTION
2630d42b 8
61174fb5
Z
9This document describes differences between the 5.17.0 release and
10the 5.17.1 release.
7620cb10 11
f9001595 12If you are upgrading from an earlier release such as 5.16.0, first read
61174fb5
Z
13L<perl5170delta>, which describes differences between 5.16.0 and
145.17.0.
d7c042c9 15
61174fb5 16=head1 Core Enhancements
417a992d 17
028c8719
FC
18=head2 More CORE:: subs
19
20Several more built-in functions have been added as subroutines to the
21CORE:: namespace, namely, those non-overridable keywords that can be
22implemented without custom parsers: C<defined>, C<delete>, C<exists>,
f1303084 23C<glob>, C<pos>, C<protoytpe>, C<scalar>, C<split>, C<study>, and C<undef>.
028c8719
FC
24
25As some of these have prototypes, C<prototype('CORE::...')> has been
b1c9e38d 26changed to not make a distinction between overridable and non-overridable
028c8719
FC
27keywords. This is to make C<prototype('CORE::pos')> consistent with
28C<prototype(&CORE::pos)>.
29
61174fb5 30=head1 Incompatible Changes
30608892 31
954945b8 32=head2 C</(?{})/> and C</(??{})/> have been heavily reworked
e128ab2c 33
b1c9e38d 34The implementation of this feature has been almost completely rewritten.
954945b8 35Although its main intent is to fix bugs, some behaviors, especially
e128ab2c
DM
36related to the scope of lexical variables, will have changed. This is
37described more fully in the L</Selected Bug Fixes> section.
38
fe3193b5
KW
39=head2 C<\N{BELL}> now refers to U+1F514 instead of U+0007
40
41Unicode 6.0 reused the name "BELL" for a different code point than it
42traditionally had meant. Since Perl v5.14, use of this name still
954945b8 43referred to U+0007, but would raise a deprecation warning. Now, "BELL"
fe3193b5
KW
44refers to U+1F514, and the name for U+0007 is "ALERT". All the
45functions in L<charnames> have been correspondingly updated.
05c8f9ed 46
0da72d5e 47=head2 Alphanumeric operators must now be separated from the closing
b1c9e38d 48delimiter of regular expressions
0da72d5e
KW
49
50You may no longer write something like:
51
52 m/a/and 1
53
54Instead you must write
55
56 m/a/ and 1
57
58with whitespace separating the operator from the closing delimiter of
59the regular expression. Not having whitespace has resulted in a
954945b8 60deprecation warning since Perl v5.14.0.
0da72d5e 61
e2f0c3bb
FC
62=head2 C<require> dies for unreadable files
63
64When C<require> encounters an unreadable file, it now dies. It used to
65ignore the file and continue searching the directories in @INC
66[perl #113422].
67
7d101ed1
JL
68=head2 Upgrade to the Unicode 6.2 beta
69
70Unicode 6.2 is proposing some changes that may very well break some CPAN
71modules. The timing of this nicely coincides with Perl's being early in the
72release cycle. This commit takes the current beta 6.2, adds the proposed
73changes that aren't yet in it, and subtracts the changes that would affect \X
74processing, as those turn out to have errors, and may have to be rethought.
75Unicode has been notified of these problems.
76
77This will allow us to gather data as to whether or not the proposed changes
78cause us problems. These will be presented to Unicode to aid in their final
79decision as to whether or not to go forward with the changes.
80
81These changes will be replaced by the final version of Unicode 6.2 before
825.18.0 is released.
83
61174fb5 84=head1 Performance Enhancements
95ce428c 85
f9001595 86=over 4
75ff5956 87
2630d42b 88=item *
c11980ad 89
e2f0c3bb
FC
90The C<x> repetition operator is now folded to a single constant at compile
91time if called in scalar context with constant operands and no parentheses
92around the left operand.
53de3ff0 93
61174fb5 94=back
ef7131e9 95
61174fb5 96=head1 Modules and Pragmata
ef7131e9 97
61174fb5 98=head2 Updated Modules and Pragmata
83fb037c 99
61174fb5 100=over 4
83fb037c
FC
101
102=item *
103
95c6c5c5 104L<Archive::Extract> has been upgraded from version 0.58 to 0.60.
c01b3876 105
95c6c5c5
JL
106Work around an edge case on Linux with Busybox's unzip.
107
108=item *
109
110L<Archive::Tar> has been upgraded from version 1.82 to 1.88.
111
954945b8
JL
112ptar now supports the -T option as well as dashless options
113[rt.cpan.org #75473], [rt.cpan.org #75475].
95c6c5c5
JL
114
115Auto-encode filenames marked as UTF-8 [rt.cpan.org #75474].
116
954945b8 117Don't use C<tell> on L<IO::Zlib> handles [rt.cpan.org #64339].
95c6c5c5
JL
118
119Don't try to C<chown> on symlinks.
120
121=item *
122
123L<attributes> has been upgraded from version 0.19 to 0.20.
124
95c6c5c5
JL
125=item *
126
127L<autodie> has been upgraded from version 2.10 to 2.11.
128
c01b3876
SH
129=item *
130
5cefbec9
FC
131L<B> has been upgraded from version 1.35 to 1.36.
132
133C<B::COP::stashlen> has been replaced with C<B::COP::stashoff>.
134
954945b8 135C<B::COP::stashpv> now supports UTF-8 package names and embedded NULs.
fbdb83f3 136
5cefbec9
FC
137=item *
138
95c6c5c5
JL
139L<B::Deparse> has been upgraded from version 1.14 to 1.15.
140
141Avoid warning when run under C<perl -w>.
142
143=item *
144
e2f0c3bb
FC
145L<Class::Struct> has been upgraded from version 0.63 to 0.64.
146
147The constructor now respects overridden accessor methods [perl #29230].
148
149=item *
150
95c6c5c5
JL
151L<Compress::Raw::Bzip2> has been upgraded from version 2.048 to 2.052.
152
95c6c5c5
JL
153=item *
154
155L<Compress::Raw::Zlib> has been upgraded from version 2.048 to 2.054.
156
157Upgrade bundled zlib to version 1.2.7.
158
159Fix build failures on Irix, Solaris, and Win32, and also when building as C++
160[rt.cpan.org #69985], [rt.cpan.org #77030], [rt.cpan.org #75222].
161
162=item *
163
164L<CPAN::Meta> has been upgraded from version 2.120630 to 2.120921.
165
95c6c5c5
JL
166=item *
167
168L<CPAN::Meta::Requirements> has been upgraded from version 2.120630 to 2.122.
169
170Treat undef requirements to C<from_string_hash> as 0 (with a warning).
171
172Added C<requirements_for_module> method.
173
174=item *
175
176L<CPAN::Meta::YAML> has been upgraded from version 0.007 to 0.008.
177
95c6c5c5
JL
178=item *
179
180L<CPANPLUS> has been upgraded from version 0.9121 to 0.9130.
181
182Allow adding F<blib/script> to PATH.
183
184Save the history between invocations of the shell.
185
186Handle multiple C<makemakerargs> and C<makeflags> arguments better.
187
188Use C<File::HomeDir> when available, and provide C<PERL5_CPANPLUS_HOME> to
189override the autodetection.
190
954945b8 191Always re-fetch F<CHECKSUMS> if C<fetchdir> is set.
95c6c5c5
JL
192
193=item *
194
195L<Digest::MD5> has been upgraded from version 2.51 to 2.52.
196
954945b8 197Fix C<Digest::Perl::MD5> OO fallback [rt.cpan.org #66634].
95c6c5c5
JL
198
199=item *
200
9331f04e
NC
201L<DynaLoader> has been upgraded from version 1.14 to 1.15.
202
203This is due to a minor code change in the XS for the VMS implementation.
204
205=item *
206
95c6c5c5
JL
207L<ExtUtils::CBuilder> has been upgraded from version 0.280206 to 0.280208.
208
209Manifest files are now correctly embedded for those versions of VC++ which
210make use of them. [perl #111782, #111798].
211
212=item *
213
ff3f295c
NC
214L<File::DosGlob> has been upgraded from version 1.07 to 1.08.
215
ff3f295c
NC
216=item *
217
95c6c5c5
JL
218L<File::Fetch> has been upgraded from version 0.32 to 0.34.
219
95c6c5c5
JL
220=item *
221
c506fc7e
FC
222L<File::Spec::Unix> has been upgraded from version 3.39_02 to 3.39_03.
223
224C<abs2rel> could produce incorrect results when given two relative paths or
225the root directory twice [perl #111510].
226
227=item *
228
95c6c5c5
JL
229L<Filter::Util::Call> has been upgraded from version 1.40 to 1.45.
230
95c6c5c5
JL
231=item *
232
233L<HTTP::Tiny> has been upgraded from version 0.017 to 0.022.
234
235Add SSL verification features [github #6], [github #9].
236
237Include the final URL in the response hashref.
238
239Add C<local_address> option.
240
241=item *
242
d9661073 243L<IO> has been upgraded from version 1.25_06 to 1.25_07.
1c633914 244
d9661073 245C<sync()> can now be called on read-only file handles [perl #64772].
f558db2f 246
66aa79e2
KW
247=item *
248
95c6c5c5
JL
249L<IPC::Cmd> has been upgraded from version 0.76 to 0.78.
250
251Use C<POSIX::_exit> instead of C<exit> in C<run_forked> [rt.cpan.org #76901].
252
253=item *
254
255L<Memoize> has been upgraded from version 1.02 to 1.03.
256
257Fix the C<MERGE> cache option.
258
259=item *
260
261L<Module::Build> has been upgraded from version 0.39_01 to 0.40.
262
263Fixed bug where modules without C<$VERSION> might have a version of '0' listed
264in 'provides' metadata, which will be rejected by PAUSE.
265
266Fixed bug in PodParser to allow numerals in module names.
267
268Fixed bug where giving arguments twice led to them becoming arrays, resulting
269in install paths like F<ARRAY(0xdeadbeef)/lib/Foo.pm>.
270
271=item *
272
273L<Module::Load::Conditional> has been upgraded from version 0.46 to 0.50.
274
275Fix use of C<requires> on perls installed to a path with spaces.
276
277=item *
278
279L<Object::Accessor> has been upgraded from version 0.42 to 0.44.
280
95c6c5c5
JL
281=item *
282
283L<Params::Check> has been upgraded from version 0.32 to 0.36.
284
95c6c5c5
JL
285=item *
286
287L<Parse::CPAN::Meta> has been upgraded from version 1.4402 to 1.4404.
288
95c6c5c5
JL
289=item *
290
291L<PerlIO::mmap> has been upgraded from version 0.010 to 0.011.
292
95c6c5c5
JL
293=item *
294
295L<PerlIO::via::QuotedPrint> has been upgraded from version 0.06 to 0.07.
296
95c6c5c5
JL
297=item *
298
99565752
NC
299L<Pod::Html> has been upgraded from version 1.15_02 to 1.16.
300
b1c9e38d 301The option C<--libpods> has been reinstated. It is deprecated, and its use
99565752
NC
302does nothing other than issue a warning that it is no longer supported.
303
954945b8
JL
304Since the HTML files generated by pod2html claim to have a UTF-8 charset,
305actually write the files out using UTF-8 [perl #111446].
7d101ed1 306
99565752
NC
307=item *
308
95c6c5c5 309L<POSIX> has been upgraded from version 1.30 to 1.31.
d9661073 310
95c6c5c5
JL
311=item *
312
313L<re> has been upgraded from version 0.19 to 0.20.
314
315See note about C<op_comp> in the L</Internal Changes> section below.
316
317=item *
318
319L<Safe> has been upgraded from version 2.31_01 to 2.33_01.
320
954945b8
JL
321Fix interactions with C<Devel::Cover>.
322
323Don't eval code under C<no strict>.
66aa79e2 324
3630f57e
CBW
325=item *
326
327L<Scalar::Util> has been upgraded from version 1.23 to version 1.25.
328
95c6c5c5
JL
329Fix an overloading issue with C<sum>.
330
331C<first> and C<reduce> now check the callback first (so C<&first(1)> is
332disallowed).
333
334Fix C<tainted> on magical values [rt.cpan.org #55763].
335
336Fix C<sum> on previously magical values [rt.cpan.org #61118].
337
338Fix reading past the end of a fixed buffer [rt.cpan.org #72700].
339
340=item *
341
342L<Search::Dict> has been upgraded from version 1.04 to 1.07.
343
344No longer require C<stat> on filehandles.
345
346Use C<fc> for casefolding.
347
348=item *
349
350L<Storable> has been upgraded from version 2.35 to 2.36.
351
95c6c5c5
JL
352=item *
353
354L<Term::ANSIColor> has been upgraded from version 3.01 to 3.02.
355
356Add support for italics.
357
358Improve error handling.
359
360=item *
361
362L<Test::Harness> has been upgraded from version 3.23 to 3.25.
363
364Fix glob semantics on Win32 [rt.cpan.org #49732].
365
954945b8 366Don't use C<Win32::GetShortPathName> when calling perl [rt.cpan.org #47890].
95c6c5c5
JL
367
368Ignore -T when reading shebang [rt.cpan.org #64404].
369
370Handle the case where we don't know the wait status of the test more
371gracefully.
372
954945b8 373Make the test summary 'ok' line overridable so that it can be changed to a
95c6c5c5
JL
374plugin to make the output of prove idempotent.
375
376Don't run world-writable files.
377
378=item *
379
380L<Unicode::UCD> has been upgraded from version 0.43 to 0.44.
381
382This adds a function L<all_casefolds()|Unicode::UCD/all_casefolds()>
383that returns all the casefolds.
384
61174fb5 385=back
f558db2f 386
61174fb5 387=head1 Documentation
80b8b050 388
61174fb5 389=head2 Changes to Existing Documentation
30608892 390
c7166200 391=head3 L<perlfaq>
ecd144ea 392
f9001595 393=over 4
05c8f9ed
RS
394
395=item *
396
954945b8 397L<perlfaq> has been synchronized with version 5.0150040 from CPAN.
9dea6244 398
204b72a4 399=back
9dea6244 400
7d101ed1
JL
401=head3 L<perlcheat>
402
403=over 4
404
405=item *
406
407L<perlcheat> has been reorganized, and a few new sections were added.
408
409=back
410
61174fb5 411=head1 Diagnostics
ef7131e9 412
4a301309
FC
413=head2 Removals of Diagnostics
414
415=over 4
416
a1d2df36
FC
417=item *
418
4a301309
FC
419The "Runaway prototype" warning that occurs in bizarre cases has been
420removed as being unhelpful and inconsistent.
421
8dffc0ab
FC
422=item *
423
424The "Not a format reference" error has been removed, as the only case in
425which it could be triggered was a bug.
426
dbc84d79
FC
427=item *
428
429The "Unable to create sub named %s" error has been removed for the same
430reason.
431
4a301309
FC
432=back
433
61174fb5 434=head1 Platform Support
05c8f9ed 435
61174fb5 436=head2 Platform-Specific Notes
ceb0881c 437
61174fb5 438=over 4
89cbc6b8 439
4aa4c0a5 440=item Win32
c6b15a5a 441
4aa4c0a5
TC
442C<link> on Win32 now attempts to set C<$!> to more appropriate values
443based on the Win32 API error code. [perl #112272]
c6b15a5a 444
0998713f
SH
445Perl no longer mangles the environment block, e.g. when launching a new
446sub-process, when the environment contains non-ASCII characters. Known
447problems still remain, however, when the environment contains characters
448outside of the current ANSI codepage (e.g. see the item about Unicode in
449C<%ENV> in L<http://perl5.git.perl.org/perl.git/blob/HEAD:/Porting/todo.pod>).
450[perl #113536]
451
112b6866
CB
452=item VMS
453
454All C header files from the top-level directory of the distribution are now
455installed on VMS, providing consistency with a long-standing practice on other
456platforms. Previously only a subset were installed, which broke non-core extension
457builds for extensions that depended on the missing include files.
458
61174fb5 459=back
8e125188 460
61174fb5 461=head1 Internal Changes
8e125188 462
61174fb5 463=over 4
c4643160 464
422287bf
FC
465=item *
466
b7e9bef4
FC
467The C<study> function was made a no-op in 5.16. It was simply disabled via
468a C<return> statement; the code was left in place. Now the code supporting
469what C<study> used to do has been removed.
53de3ff0 470
f8ef51fd
FC
471=item *
472
473Under threaded perls, there is no longer a separate PV allocated for every
474COP to store its package name (C<< cop->stashpv >>). Instead, there is an
475offset (C<< cop->stashoff >>) into the new C<PL_stashpad> array, which
476holds stash pointers.
477
e128ab2c
DM
478=item *
479
480In the pluggable regex API, the C<regexp_engine> struct has acquired a new
481field C<op_comp>, which is currently just for perl's internal use, and
b1c9e38d 482should be initialised to NULL by other regex plugin modules.
e128ab2c 483
e2f0c3bb
FC
484=item *
485
486A new function C<alloccoptash> has been added to the API, but is considered
487experimental. See L<perlapi>.
488
61174fb5 489=back
422287bf 490
61174fb5 491=head1 Selected Bug Fixes
2de6ba8d 492
61174fb5 493=over 4
52c4b146 494
9aa9a888
KW
495=item *
496
e128ab2c 497The implementation of code blocks in regular expressions, such as C<(?{})>
954945b8 498and C<(??{})>, has been heavily reworked to eliminate a whole slew of bugs.
e128ab2c
DM
499The main user-visible changes are:
500
501=over 4
502
503=item *
504
505Code blocks within patterns are now parsed in the same pass as the
506surrounding code; in particular it is no longer necessary to have balanced
507braces: this now works:
508
509 /(?{ $x='{' })/
510
511This means that this error message is longer generated:
512
513 Sequence (?{...}) not terminated or not {}-balanced in regex
514
515but a new error may be seen:
516
517 Sequence (?{...}) not terminated with ')'
518
519In addition, literal code blocks within run-time patterns are only
520compiled once, at perl compile-time:
521
522 for my $p (...) {
523 # this 'FOO' block of code is compiled once,
524 # at the same time as the surrounding 'for' loop
525 /$p{(?{FOO;})/;
526 }
527
528=item *
529
530Lexical variables are now sane as regards scope, recursion and closure
954945b8 531behavior. In particular, C</A(?{B})C/> behaves (from a closure viewpoint)
e128ab2c
DM
532exactly like C</A/ && do { B } && /C/>, while C<qr/A(?{B})C/> is like
533C<sub {/A/ && do { B } && /C/}>. So this code now works how you might
be722aee 534expect, creating three regexes that match 0, 1, and 2:
e128ab2c
DM
535
536 for my $i (0..2) {
537 push @r, qr/^(??{$i})$/;
538 }
539 "1" =~ $r[1]; # matches
540
541=item *
542
b1c9e38d
JL
543The C<use re 'eval'> pragma is now only required for code blocks defined
544at runtime; in particular in the following, the text of the C<$r> pattern is
e128ab2c 545still interpolated into the new pattern and recompiled, but the individual
b1c9e38d 546compiled code-blocks within C<$r> are reused rather than being recompiled,
e128ab2c
DM
547and C<use re 'eval'> isn't needed any more:
548
549 my $r = qr/abc(?{....})def/;
550 /xyz$r/;
551
552=item *
553
554Flow control operators no longer crash. Each code block runs in a new
555dynamic scope, so C<next> etc. will not see any enclosing loops and
556C<caller> will not see any calling subroutines. C<return> returns a value
557from the code block, not from any enclosing subroutine.
558
559=item *
560
561Perl normally caches the compilation of run-time patterns, and doesn't
954945b8
JL
562recompile if the pattern hasn't changed, but this is now disabled if
563required for the correct behavior of closures. For example:
e128ab2c
DM
564
565 my $code = '(??{$x})';
566 for my $x (1..3) {
567 # recompile to see fresh value of $x each time
568 $x =~ /$code/;
569 }
570
571
572=item *
573
574The C</msix> and C<(?msix)> etc. flags are now propagated into the return
575value from C<(??{})>; this now works:
576
577 "AB" =~ /a(??{'b'})/i;
578
579=item *
580
581Warnings and errors will appear to come from the surrounding code (or for
582run-time code blocks, from an eval) rather than from an C<re_eval>:
583
584 use re 'eval'; $c = '(?{ warn "foo" })'; /$c/;
585 /(?{ warn "foo" })/;
586
587formerly gave:
588
589 foo at (re_eval 1) line 1.
590 foo at (re_eval 2) line 1.
591
592and now gives:
593
594 foo at (eval 1) line 1.
595 foo at /some/prog line 2.
596
597=back
598
599=item *
600
7ade940c
KW
601Perl now works as well as can be expected on all releases of Unicode so
602far. In v5.16, it worked on Unicodes 6.0 and 6.1, but there were
603various bugs for earlier releases; the older the release the more
604problems.
9aa9a888 605
701da2e9
FC
606=item *
607
608C<vec> no longer produces "uninitialized" warnings in lvalue context
609[perl #9423].
610
d67d4c0e
FC
611=item *
612
954945b8 613An optimization involving fixed strings in regular expressions could cause
d67d4c0e
FC
614a severe performance penalty in edge cases. This has been fixed
615[perl #76546].
616
b9dc63e8
FC
617=item *
618
7d101ed1
JL
619In certain cases, including empty subpatterns within a regular expression (such
620as C<(?:)> or C<(?:|)>) could disable some optimizations. This has been fixed.
621
622=item *
623
b9dc63e8 624The "Can't find an opnumber" message that C<prototype> produces when passed
954945b8 625a string like "CORE::nonexistent_keyword" now passes UTF-8 and embedded
18a66a2d 626NULs through unchanged [perl #97478].
b9dc63e8 627
b6d5888c
FC
628=item *
629
c0df136d
FC
630C<prototype> now treats magical variables like C<$1> the same way as
631non-magical variables when checking for the CORE:: prefix, instead of
632treating them as subroutine names.
633
634=item *
635
b1c9e38d 636Under threaded perls, a runtime code block in a regular expression could
b6d5888c
FC
637corrupt the package name stored in the op tree, resulting in bad reads
638in C<caller>, and possibly crashes [perl #113060].
639
d8816adc
FC
640=item *
641
642Referencing a closure prototype (C<\&{$_[1]}> in an attribute handler for a
643closure) no longer results in a copy of the subroutine (or assertion
644failures on debugging builds).
645
9b9df0bb
FC
646=item *
647
648C<eval '__PACKAGE__'> now returns the right answer on threaded builds if
649the current package has been assigned over (as in
650C<*ThisPackage:: = *ThatPackage::>) [perl #78742].
651
b16ca463
FC
652=item *
653
654If a package is deleted by code that it calls, it is possible for C<caller>
655to see a stack frame belonging to that deleted package. C<caller> could
656crash if the stash's memory address was reused for a scalar and a
657substitution was performed on the same scalar [perl #113486].
658
6fe02df8
FC
659=item *
660
661C<UNIVERSAL::can> no longer treats its first argument differently
662depending on whether it is a string or number internally.
663
2aab098d
FC
664=item *
665
954945b8
JL
666C<open> with C<< <& >> for the mode checks to see whether the third argument is
667a number, in determining whether to treat it as a file descriptor or a handle
668name. Magical variables like C<$1> were always failing the numeric check and
669being treated as handle names.
2aab098d 670
38d77b7f
FC
671=item *
672
673C<warn>'s handling of magical variables (C<$1>, ties) has undergone several
954945b8 674fixes. C<FETCH> is only called once now on a tied argument or a tied C<$@>
38d77b7f
FC
675[perl #97480]. Tied variables returning objects that stringify as "" are
676no longer ignored. A tied C<$@> that happened to return a reference the
677I<previous> time is was used is no longer ignored.
678
e811dbaa
FC
679=item *
680
8b9712e0
FC
681C<warn ""> now treats C<$@> with a number in it the same way, regardless of
682whether it happened via C<$@=3> or C<$@="3">. It used to ignore the
683former. Now it appends "\t...caught", as it has always done with
684C<$@="3">.
685
686=item *
687
e811dbaa 688Numeric operators on magical variables (e.g., S<C<$1 + 1>>) used to use
0998713f
SH
689floating point operations even where integer operations were more appropriate,
690resulting in loss of accuracy on 64-bit platforms [perl #109542].
e811dbaa 691
844115ec
FC
692=item *
693
694Unary negation no longer treats a string as a number if the string happened
b1c9e38d 695to be used as a number at some point. So, if C<$x> contains the string "dogs",
844115ec
FC
696C<-$x> returns "-dogs" even if C<$y=0+$x> has happened at some point.
697
a7143705
FC
698=item *
699
700In Perl 5.14, C<-'-10'> was fixed to return "10", not "+10". But magical
701variables (C<$1>, ties) were not fixed till now [perl #57706].
702
9c308096
FC
703=item *
704
705Unary negation now treats strings consistently, regardless of the internal
954945b8 706C<UTF8> flag.
9c308096 707
fc67deb3
KW
708=item *
709
710A regression introduced in Perl v5.16.0 involving
711C<tr/I<SEARCHLIST>/I<REPLACEMENTLIST>/> has been fixed. Only the first
712instance is supposed to be meaningful if a character appears more than
713once in C<I<SEARCHLIST>>. Under some circumstances, the final instance
714was overriding all earlier ones. [perl #113584]
715
45e0f58a
KW
716=item *
717
718Regular expressions like C<qr/\87/> previously silently inserted a NUL
719character, thus matching as if it had been written C<qr/\00087/>. Now it
b1c9e38d 720matches as if it had been written as C<qr/87/>, with a message that the
45e0f58a
KW
721sequence C<"\8"> is unrecognized.
722
e2f0c3bb
FC
723=item *
724
954945b8 725C<__SUB__> now works in special blocks (C<BEGIN>, C<END>, etc.).
e2f0c3bb
FC
726
727=item *
728
729Thread creation on Windows could theoretically result in a crash if done
954945b8 730inside a C<BEGIN> block. It still does not work properly, but it no longer
e2f0c3bb
FC
731crashes [perl #111610].
732
dbc84d79
FC
733=item *
734
735C<\&{''}> (with the empty string) now autovivifies a stub like any other
736sub name, and no longer produces the "Unable to create sub" error
737[perl #94476].
738
61174fb5 739=back
53de3ff0 740
233bba44
JL
741=head1 Known Problems
742
743=over 4
744
745=item *
746
954945b8 747On VMS, L<Module::Build> still fails its test suite.
233bba44
JL
748
749=item *
750
751On Win32, several tests fail intermittently, and may hang unless STDERR is
752redirected.
753
754=back
755
61174fb5 756=head1 Acknowledgements
d5dc7001 757
61174fb5 758XXX Generate this with:
f9001595 759
61174fb5 760 perl Porting/acknowledgements.pl v5.17.0..HEAD
29cf780c 761
44691e6f
AB
762=head1 Reporting Bugs
763
764If you find what you think is a bug, you might check the articles
52deee2e 765recently posted to the comp.lang.perl.misc newsgroup and the perl
f9001595
RS
766bug database at http://rt.perl.org/perlbug/ . There may also be
767information at http://www.perl.org/ , the Perl Home Page.
44691e6f
AB
768
769If you believe you have an unreported bug, please run the L<perlbug>
52deee2e
DR
770program included with your release. Be sure to trim your bug down
771to a tiny but sufficient test case. Your bug report, along with the
772output of C<perl -V>, will be sent off to perlbug@perl.org to be
773analysed by the Perl porting team.
44691e6f
AB
774
775If the bug you are reporting has security implications, which make it
f9001595
RS
776inappropriate to send to a publicly archived mailing list, then please send
777it to perl5-security-report@perl.org. This points to a closed subscription
778unarchived mailing list, which includes
779all the core committers, who will be able
780to help assess the impact of issues, figure out a resolution, and help
781co-ordinate the release of patches to mitigate or fix the problem across all
782platforms on which Perl is supported. Please only use this address for
783security issues in the Perl core, not for modules independently
784distributed on CPAN.
44691e6f
AB
785
786=head1 SEE ALSO
787
52deee2e
DR
788The F<Changes> file for an explanation of how to view exhaustive details
789on what changed.
44691e6f
AB
790
791The F<INSTALL> file for how to build Perl.
792
793The F<README> file for general stuff.
794
795The F<Artistic> and F<Copying> files for copyright information.
796
797=cut