This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
009b0c127dfbe9c9844948a11ddebc6fc69abbd0
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =head1 NAME
4
5 perldelta - what is new for perl v5.26.0
6
7 =head1 DESCRIPTION
8
9 This document describes the differences between the 5.24.0 release and the
10 5.26.0 release.
11
12 =head1 Core Enhancements
13
14 =head2 New regular expression modifier C</xx>
15
16 Specifying two C<x> characters to modify a regular expression pattern
17 does everything that a single one does, but additionally TAB and SPACE
18 characters within a bracketed character class are generally ignored and
19 can be added to improve readability, like
20 S<C</[ ^ A-Z d-f p-x ]/xx>>.  Details are at
21 L<perlre/E<sol>x and E<sol>xx>.
22
23 =head2 New Hash Function For 64-bit Builds
24
25 We have switched to a hybrid hash function to better balance
26 performance for short and long keys.
27
28 For short keys, 16 bytes and under, we use an optimised variant of
29 One At A Time Hard, and for longer keys we use Siphash 1-3. For very
30 long keys this is a big improvement in performance. For shorter keys
31 there is a modest improvement.
32
33 =head2 Indented Here-documents
34
35 This adds a new modifier '~' to here-docs that tells the parser
36 that it should look for /^\s*$DELIM\n/ as the closing delimiter.
37
38 These syntaxes are all supported:
39
40     <<~EOF;
41     <<~\EOF;
42     <<~'EOF';
43     <<~"EOF";
44     <<~`EOF`;
45     <<~ 'EOF';
46     <<~ "EOF";
47     <<~ `EOF`;
48
49 The '~' modifier will strip, from each line in the here-doc, the
50 same whitespace that appears before the delimiter.
51
52 Newlines will be copied as is, and lines that don't include the
53 proper beginning whitespace will cause perl to croak.
54
55 For example:
56
57     if (1) {
58       print <<~EOF;
59         Hello there
60         EOF
61     }
62
63 prints "Hello there\n" with no leading whitespace.
64
65 =head2 '.' and @INC
66
67 Perl now provides a way to build perl without C<.> in @INC by default. If you
68 want this feature, you can build with -Ddefault_inc_excludes_dot
69
70 Because the testing / make process for perl modules does not function well with
71 C<.> missing from @INC, Perl now supports the environment variable
72 PERL_USE_UNSAFE_INC=1 which makes Perl behave as it previously did, returning
73 C<.> to @INC in all child processes.
74
75 =head2 create a safer utf8_hop() called utf8_hop_safe()
76
77 Unlike utf8_hop(), utf8_hop_safe() won't navigate before the beginning or after
78 the end of the supplied buffer.
79
80 =head2 @{^CAPTURE}, %{^CAPTURE}, and %{^CAPTURE_ALL}
81
82 C<@{^CAPTURE}> exposes the capture buffers of the last match as an
83 array. So C<$1> is C<${^CAPTURE}[0]>.
84
85 C<%{^CAPTURE}> is the equivalent to C<%+> (ie named captures)
86
87 C<%{^CAPTURE_ALL}> is the equivalent to C<%-> (ie all named captures).
88
89 =head2 Unicode 9.0 is now supported
90
91 A list of changes is at L<http://www.unicode.org/versions/Unicode9.0.0/>.
92 Modules that are shipped with core Perl but not maintained by p5p do not
93 necessarily support Unicode 9.0.  L<Unicode::Normalize> does work on 9.0.
94
95 =head2 Use of C<\p{I<script>}> uses the improved Script_Extensions property
96
97 Unicode 6.0 introduced an improved form of the Script (C<sc>) property, and
98 called it Script_Extensions (C<scx>).  As of now, Perl uses this improved
99 version when a property is specified as just C<\p{I<script>}>.  The meaning of
100 compound forms, like C<\p{sc=I<script>}> are unchanged.  This should make
101 programs be more accurate when determining if a character is used in a given
102 script, but there is a slight chance of breakage for programs that very
103 specifically needed the old behavior.  See L<perlunicode/Scripts>.
104
105 =head2 Declaring a reference to a variable
106
107 As an experimental feature, Perl now allows the referencing operator to come
108 after L<C<my()>|perlfunc/my>, L<C<state()>|perlfunc/state>,
109 L<C<our()>|perlfunc/our>, or L<C<local()>|perlfunc/local>.  This syntax must
110 be enabled with C<use feature 'declared_refs'>.  It is experimental, and will
111 warn by default unless C<no warnings 'experimental::refaliasing'> is in effect.
112 It is intended mainly for use in assignments to references.  For example:
113
114     use experimental 'refaliasing', 'declared_refs';
115     my \$a = \$b;
116
117 See L<perlref/Assigning to References> for more details.
118
119 =head2 Perl can now do default collation in UTF-8 locales on platforms
120 that support it
121
122 Some platforms natively do a reasonable job of collating and sorting in
123 UTF-8 locales.  Perl now works with those.  For portability and full
124 control, L<Unicode::Collate> is still recommended, but now you may
125 not need to do anything special to get good-enough results, depending on
126 your application.  See
127 L<perllocale/Category C<LC_COLLATE>: Collation: Text Comparisons and Sorting>.
128
129 =head2 Better locale collation of strings containing embedded C<NUL>
130 characters
131
132 In locales that have multi-level character weights, these are now
133 ignored at the higher priority ones.  There are still some gotchas in
134 some strings, though.  See
135 L<perllocale/Collation of strings containing embedded C<NUL> characters>.
136
137 =head2 Lexical subroutines are no longer experimental
138
139 Using the C<lexical_subs> feature introduced in v5.18 no longer emits a warning. Existing
140 code that disables the C<experimental::lexical_subs> warning category
141 that the feature previously used will continue to work. The
142 C<lexical_subs> feature has no effect; all Perl code can use lexical
143 subroutines, regardless of what feature declarations are in scope.
144
145 =head2 C<CORE> subroutines for hash and array functions callable via
146 reference
147
148 The hash and array functions in the C<CORE> namespace--C<keys>, C<each>,
149 C<values>, C<push>, C<pop>, C<shift>, C<unshift> and C<splice>--, can now
150 be called with ampersand syntax (C<&CORE::keys(\%hash>) and via reference
151 (C<< my $k = \&CORE::keys; $k-E<gt>(\%hash) >>).  Previously they could only be
152 used when inlined.
153
154 =head2 POSIX::tmpnam() has been removed
155
156 The fundamentally unsafe C<tmpnam()> interface was deprecated in
157 Perl 5.22.0 and has now been removed.  In its place you can use
158 for example the L<File::Temp> interfaces.
159
160 =head2 require ::Foo::Bar is now illegal.
161
162 Formerly, C<require ::Foo::Bar> would try to read F</Foo/Bar.pm>. Now any
163 bareword require which starts with a double colon dies instead.
164
165 =head2 Unescaped literal C<"{"> characters in regular expression
166 patterns are no longer permissible
167
168 You have to now say something like C<"\{"> or C<"[{]"> to specify to
169 match a LEFT CURLY BRACKET.  This will allow future extensions to the
170 language.  This restriction is not enforced, nor are there current plans
171 to enforce it, if the C<"{"> is the first character in the pattern.
172
173 These have been deprecated since v5.16, with a deprecation message
174 displayed starting in v5.22.
175
176 =head2 Literal control character variable names are no longer permissible
177
178 A variable name may no longer contain a literal control character under
179 any circumstances.  These previously were allowed in single-character
180 names on ASCII platforms, but have been deprecated there since Perl
181 v5.20.  This affects things like C<$I<\cT>>, where I<\cT> is a literal
182 control (such as a C<NAK> or C<NEGATIVE ACKNOWLEDGE> character) in the
183 source code.
184
185 =head2 C<NBSP> is no longer permissible in C<\N{...}>
186
187 The name of a character may no longer contain non-breaking spaces.  It
188 has been deprecated to do so since Perl v5.22.
189
190 =head1 Security
191
192 =head2 Remove current dir (C<.>) from C<@INC>
193
194 For security reasons, C<@INC> no longer contains the default directory
195 (C<.>).
196
197 =head2 "Escaped" colons and relative paths in PATH
198
199 On Unix systems, Perl treats any relative paths in the PATH environment
200 variable as tainted when starting a new process.  Previously, it was
201 allowing a backslash to escape a colon (unlike the OS), consequently
202 allowing relative paths to be considered safe if the PATH was set to
203 something like C</\:.>.  The check has been fixed to treat C<.> as tainted
204 in that example.
205
206 =head2 C<-Di> switch is now required for PerlIO debugging output
207
208 Previously PerlIO debugging output would be sent to the file specified
209 by the C<PERLIO_DEBUG> environment variable if perl wasn't running
210 setuid and the C<-T> or C<-t> switches hadn't been parsed yet.
211
212 If perl performed output at a point where it hadn't yet parsed its
213 switches this could result in perl creating or overwriting the file
214 named by C<PERLIO_DEBUG> even when the C<-T> switch had been supplied.
215
216 Perl now requires the C<-Di> switch to produce PerlIO debugging
217 output.  By default this is written to C<stderr>, but can optionally
218 be redirected to a file by setting the C<PERLIO_DEBUG> environment
219 variable.
220
221 If perl is running setuid or the C<-T> switch has supplied
222 C<PERLIO_DEBUG> is ignored and the debugging output is sent to
223 C<stderr> as for any other C<-D> switch.
224
225 =head1 Incompatible Changes
226
227 =head2 C<${^ENCODING}> has been removed
228
229 Consequently, the L<encoding> pragma's default mode is no longer supported.  If
230 you still need to write your source code in encodings other than UTF-8, use a
231 source filter such as L<Filter::Encoding> on CPAN or L<encoding>'s C<Filter>
232 option.
233
234 =head2 C<scalar(%hash)> return signature changed
235
236 The value returned for C<scalar(%hash)> will no longer show information about
237 the buckets allocated in the hash.  It will simply return the count of used
238 keys.  It is thus equivalent to C<0+keys(%hash)>.
239
240 A form of backwards compatibility is provided via C<Hash::Util::bucket_ratio()>
241 which provides the same behavior as C<scalar(%hash)> provided prior to Perl
242 5.25.
243
244 =head2 C<keys> returned from an lvalue subroutine
245
246 C<keys> returned from an lvalue subroutine can no longer be assigned
247 to in list context.
248
249     sub foo : lvalue { keys(%INC) }
250     (foo) = 3; # death
251     sub bar : lvalue { keys(@_) }
252     (bar) = 3; # also an error
253
254 This makes the lvalue sub case consistent with C<(keys %hash) = ...> and
255 C<(keys @_) = ...>, which are also errors.  [perl #128187]
256
257 =head1 Deprecations
258
259 =head2 String delimiters that aren't stand-alone graphemes are now deprecated
260
261 In order for Perl to eventually allow string delimiters to be Unicode
262 grapheme clusters (which look like a single character, but may be
263 a sequence of several ones), we have to stop allowing a single char
264 delimiter that isn't a grapheme by itself.  These are unlikely to exist
265 in actual code, as they would typically display as attached to the
266 character in front of them.
267
268 =head1 Performance Enhancements
269
270 =over 4
271
272 =item *
273
274 A hash in boolean context is now sometimes faster, e.g.
275
276     if (!%h) { ... }
277
278 This was already special-cased, but some cases were missed, and even the
279 ones which weren't have been improved.
280
281 =item *
282
283 Several other ops may now also be faster in boolean context.
284
285 =item * New Faster Hash Function on 64 bit builds
286
287 We use a different hash function for short and long keys. This should
288 improve performance and security, especially for long keys.
289
290 =item * readline is faster
291
292 Reading from a file line-by-line with C<readline()> or C<< E<lt>E<gt> >> should
293 now typically be faster due to a better implementation of the code that
294 searches for the next newline character.
295
296 =item *
297
298 Reduce cost of SvVALID().
299
300 =item *
301
302 C<$ref1 = $ref2> has been optimized.
303
304 =item *
305
306 Array and hash assignment are now faster, e.g.
307
308     (..., @a) = (...);
309     (..., %h) = (...);
310
311 especially when the RHS is empty.
312
313 =item *
314
315 Reduce the number of odd special cases for the C<SvSCREAM> flag.
316
317 =item *
318
319 Avoid sv_catpvn() in do_vop() when unneeded.
320
321 =item *
322
323 Enhancements in Regex concat COW implementation.
324
325 =item *
326
327 Speed up C<AV> and C<HV> clearing/undeffing.
328
329 =item *
330
331 Better optimise array and hash assignment
332
333 =item *
334
335 Converting a single-digit string to a number is now substantially faster.
336
337 =item *
338
339 The internal op implementing the C<split> builtin has been simplified and
340 sped up. Firstly, it no longer requires a subsidiary internal C<pushre> op
341 to do its work. Secondly, code of the form C<my @x = split(...)> is now
342 optimised in the same way as C<@x = split(...)>, and is therefore a few
343 percent faster.
344
345 =item *
346
347 The rather slow implementation for the experimental subroutine signatures
348 feature has been made much faster; it is now comparable in speed with the
349 old-style C<my ($a, $b, @c) = @_>.
350
351 =item *
352
353 Bareword constant strings are now permitted to take part in constant
354 folding. They were originally exempted from constant folding in August 1999,
355 during the development of Perl 5.6, to ensure that C<use strict "subs">
356 would still apply to bareword constants. That has now been accomplished a
357 different way, so barewords, like other constants, now gain the performance
358 benefits of constant folding.
359
360 This also means that void-context warnings on constant expressions of
361 barewords now report the folded constant operand, rather than the operation;
362 this matches the behaviour for non-bareword constants.
363
364 =back
365
366 =head1 Modules and Pragmata
367
368 =head2 Updated Modules and Pragmata
369
370 =over 4
371
372 =item *
373
374 L<Archive::Tar> has been upgraded from version 2.04 to 2.24.
375
376 =item *
377
378 L<arybase> has been upgraded from version 0.11 to 0.12.
379
380 =item *
381
382 L<attributes> has been upgraded from version 0.27 to 0.29.
383
384 The deprecation message for the C<:unique> and C<:locked> attributes
385 now mention they will disappear in Perl 5.28.
386
387 =item *
388
389 L<B> has been upgraded from version 1.62 to 1.68.
390
391 =item *
392
393 L<B::Concise> has been upgraded from version 0.996 to 0.999.
394
395 Its output is now more descriptive for C<op_private> flags.
396
397 =item *
398
399 L<B::Debug> has been upgraded from version 1.23 to 1.24.
400
401 =item *
402
403 L<B::Deparse> has been upgraded from version 1.37 to 1.40.
404
405 =item *
406
407 L<B::Xref> has been upgraded from version 1.05 to 1.06.
408
409 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
410
411 =item *
412
413 L<base> has been upgraded from version 2.23 to 2.25.
414
415 =item *
416
417 L<bignum> has been upgraded from version 0.42 to 0.47.
418
419 =item *
420
421 L<Carp> has been upgraded from version 1.40 to 1.42.
422
423 =item *
424
425 L<charnames> has been upgraded from version 1.43 to 1.44.
426
427 =item *
428
429 L<Compress::Raw::Bzip2> has been upgraded from version 2.069 to 2.074.
430
431 =item *
432
433 L<Compress::Raw::Zlib> has been upgraded from version 2.069 to 2.074.
434
435 =item *
436
437 L<Config::Perl::V> has been upgraded from version 0.25 to 0.28.
438
439 =item *
440
441 L<CPAN> has been upgraded from version 2.11 to 2.18.
442
443 =item *
444
445 L<CPAN::Meta> has been upgraded from version 2.150005 to 2.150010.
446
447 =item *
448
449 L<Data::Dumper> has been upgraded from version 2.160 to 2.167.
450
451 The XS implementation now supports Deparse.
452
453 This fixes a stack management bug. [perl #130487].
454
455 =item *
456
457 L<DB_File> has been upgraded from version 1.835 to 1.840.
458
459 =item *
460
461 L<Devel::Peek> has been upgraded from version 1.23 to 1.26.
462
463 =item *
464
465 L<Devel::PPPort> has been upgraded from version 3.32 to 3.35.
466
467 =item *
468
469 L<Devel::SelfStubber> has been upgraded from version 1.05 to 1.06.
470
471 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
472
473 =item *
474
475 L<diagnostics> has been upgraded from version 1.34 to 1.36.
476
477 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
478
479 =item *
480
481 L<Digest> has been upgraded from version 1.17 to 1.17_01.
482
483 =item *
484
485 L<Digest::MD5> has been upgraded from version 2.54 to 2.55.
486
487 =item *
488
489 L<Digest::SHA> has been upgraded from version 5.95 to 5.96.
490
491 =item *
492
493 L<DynaLoader> has been upgraded from version 1.38 to 1.42.
494
495 =item *
496
497 L<Encode> has been upgraded from version 2.80 to 2.88.
498
499 =item *
500
501 L<encoding> has been upgraded from version 2.17 to 2.19.
502
503 This module's default mode is no longer supported as of Perl 5.25.3.  It now
504 dies when imported, unless the C<Filter> option is being used.
505
506 =item *
507
508 L<encoding::warnings> has been upgraded from version 0.12 to 0.13.
509
510 This module is no longer supported as of Perl 5.25.3.  It emits a warning to
511 that effect and then does nothing.
512
513 =item *
514
515 L<Errno> has been upgraded from version 1.25 to 1.28.
516
517 Document that using C<%!> loads Errno for you.
518
519 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
520
521 =item *
522
523 L<ExtUtils::Embed> has been upgraded from version 1.33 to 1.34.
524
525 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
526
527 =item *
528
529 L<ExtUtils::MakeMaker> has been upgraded from version 7.10_01 to 7.24.
530
531 =item *
532
533 L<ExtUtils::Miniperl> has been upgraded from version 1.05 to 1.06.
534
535 =item *
536
537 L<ExtUtils::ParseXS> has been upgraded from version 3.31 to 3.34.
538
539 =item *
540
541 L<ExtUtils::Typemaps> has been upgraded from version 3.31 to 3.34.
542
543 =item *
544
545 L<feature> has been upgraded from version 1.42 to 1.47.
546
547 Fixes the Unicode Bug in the range operator.
548
549 =item *
550
551 L<File::Copy> has been upgraded from version 2.31 to 2.32.
552
553 =item *
554
555 L<File::Fetch> has been upgraded from version 0.48 to 0.52.
556
557 =item *
558
559 L<File::Glob> has been upgraded from version 1.26 to 1.28.
560
561 Issue a deprecation message for C<File::Glob::glob()>.
562
563 =item *
564
565 L<File::Spec> has been upgraded from version 3.63 to 3.67.
566
567 =item *
568
569 L<FileHandle> has been upgraded from version 2.02 to 2.03.
570
571 =item *
572
573 L<Filter::Simple> has been upgraded from version 0.92 to 0.93.
574
575 It no longer treats C<no MyFilter> immediately following C<use MyFilter> as
576 end-of-file.  [perl #107726]
577
578 =item *
579
580 L<Getopt::Long> has been upgraded from version 2.48 to 2.49.
581
582 =item *
583
584 L<Getopt::Std> has been upgraded from version 1.11 to 1.12.
585
586 =item *
587
588 L<Hash::Util> has been upgraded from version 0.19 to 0.22.
589
590 =item *
591
592 L<HTTP::Tiny> has been upgraded from version 0.056 to 0.070.
593
594 Internal 599-series errors now include the redirect history.
595
596 =item *
597
598 L<I18N::LangTags> has been upgraded from version 0.40 to 0.42.
599
600 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
601
602 =item *
603
604 L<IO> has been upgraded from version 1.36 to 1.38.
605
606 =item *
607
608 IO-Compress has been upgraded from version 2.069 to 2.074.
609
610 =item *
611
612 L<IO::Socket::IP> has been upgraded from version 0.37 to 0.38.
613
614 =item *
615
616 L<IPC::Cmd> has been upgraded from version 0.92 to 0.96.
617
618 =item *
619
620 L<IPC::SysV> has been upgraded from version 2.06_01 to 2.07.
621
622 =item *
623
624 L<JSON::PP> has been upgraded from version 2.27300 to 2.27400_02.
625
626 =item *
627
628 L<lib> has been upgraded from version 0.63 to 0.64.
629
630 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
631
632 =item *
633
634 L<List::Util> has been upgraded from version 1.42_02 to 1.46_02.
635
636 =item *
637
638 L<Locale::Codes> has been upgraded from version 3.37 to 3.42.
639
640 =item *
641
642 L<Locale::Maketext> has been upgraded from version 1.26 to 1.28.
643
644 =item *
645
646 L<Locale::Maketext::Simple> has been upgraded from version 0.21 to 0.21_01.
647
648 =item *
649
650 L<Math::BigInt> has been upgraded from version 1.999715 to 1.999806.
651
652 There have also been some core customizations.
653
654 =item *
655
656 L<Math::BigInt::FastCalc> has been upgraded from version 0.40 to 0.5005.
657
658 =item *
659
660 L<Math::BigRat> has been upgraded from version 0.260802 to 0.2611.
661
662 =item *
663
664 L<Math::Complex> has been upgraded from version 1.59 to 1.5901.
665
666 =item *
667
668 L<Memoize> has been upgraded from version 1.03 to 1.03_01.
669
670 =item *
671
672 L<Module::CoreList> has been upgraded from version 5.20170420 to 5.20170520.
673
674 =item *
675
676 L<Module::Load::Conditional> has been upgraded from version 0.64 to 0.68.
677
678 =item *
679
680 L<Module::Metadata> has been upgraded from version 1.000031 to 1.000033.
681
682 =item *
683
684 L<mro> has been upgraded from version 1.18 to 1.20.
685
686 =item *
687
688 L<Net::Ping> has been upgraded from version 2.43 to 2.55.
689
690 IPv6 addresses and C<AF_INET6> sockets are now supported, along with several
691 other enhancements.
692
693 Remove sudo from 500_ping_icmp.t.
694
695 Avoid stderr noise in tests
696
697 Check for echo in new Net::Ping tests.
698
699 =item *
700
701 L<NEXT> has been upgraded from version 0.65 to 0.67.
702
703 =item *
704
705 L<Opcode> has been upgraded from version 1.34 to 1.39.
706
707 =item *
708
709 L<open> has been upgraded from version 1.10 to 1.11.
710
711 =item *
712
713 L<OS2::Process> has been upgraded from version 1.11 to 1.12.
714
715 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
716
717 =item *
718
719 L<overload> has been upgraded from version 1.26 to 1.28.
720
721 Its compilation speed has been improved slightly.
722
723 =item *
724
725 L<parent> has been upgraded from version 0.234 to 0.236.
726
727 =item *
728
729 L<perl5db.pl> has been upgraded from version 1.50 to 1.51.
730
731 Ignore F</dev/tty> on non-Unix systems. [perl #113960]
732
733 =item *
734
735 L<Perl::OSType> has been upgraded from version 1.009 to 1.010.
736
737 =item *
738
739 L<perlfaq> has been upgraded from version 5.021010 to 5.021011.
740
741 =item *
742
743 L<PerlIO> has been upgraded from version 1.09 to 1.10.
744
745 =item *
746
747 L<PerlIO::encoding> has been upgraded from version 0.24 to 0.25.
748
749 =item *
750
751 L<PerlIO::scalar> has been upgraded from version 0.24 to 0.26.
752
753 =item *
754
755 L<Pod::Checker> has been upgraded from version 1.60 to 1.73.
756
757 =item *
758
759 L<Pod::Functions> has been upgraded from version 1.10 to 1.11.
760
761 =item *
762
763 L<Pod::Html> has been upgraded from version 1.22 to 1.2202.
764
765 =item *
766
767 L<Pod::Perldoc> has been upgraded from version 3.25_02 to 3.28.
768
769 =item *
770
771 L<Pod::Simple> has been upgraded from version 3.32 to 3.35.
772
773 =item *
774
775 L<Pod::Usage> has been upgraded from version 1.68 to 1.69.
776
777 =item *
778
779 L<POSIX> has been upgraded from version 1.65 to 1.76. This remedies several
780 defects in making its symbols exportable. [perl #127821]
781 The C<POSIX::tmpnam()> interface has been removed,
782 see L</"POSIX::tmpnam() has been removed">.
783 Trying to import POSIX subs that have no real implementations
784 (like C<POSIX::atend()>) now fails at import time, instead of
785 waiting until runtime.
786
787 =item *
788
789 L<re> has been upgraded from version 0.32 to 0.34
790
791 This adds support for the new L<C<E<47>xx>|perlre/E<sol>x and E<sol>xx>
792 regular expression pattern modifier, and a change to the L<S<C<use re
793 'strict'>>|re/'strict' mode> experimental feature.  When S<C<re
794 'strict'>> is enabled, a warning now will be generated for all
795 unescaped uses of the two characters C<}> and C<]> in regular
796 expression patterns (outside bracketed character classes) that are taken
797 literally.  This brings them more in line with the C<)> character which
798 is always a metacharacter unless escaped.  Being a metacharacter only
799 sometimes, depending on action at a distance, can lead to silently
800 having the pattern mean something quite different than was intended,
801 which the S<C<re 'strict'>> mode is intended to minimize.
802
803 =item *
804
805 L<Safe> has been upgraded from version 2.39 to 2.40.
806
807 =item *
808
809 L<Scalar::Util> has been upgraded from version 1.42_02 to 1.46_02.
810
811 =item *
812
813 L<Storable> has been upgraded from version 2.56 to 2.62.
814
815 Fixes [perl #130098].
816
817 =item *
818
819 L<Symbol> has been upgraded from version 1.07 to 1.08.
820
821 =item *
822
823 L<Sys::Syslog> has been upgraded from version 0.33 to 0.35.
824
825 =item *
826
827 L<Term::ANSIColor> has been upgraded from version 4.04 to 4.06.
828
829 =item *
830
831 L<Term::ReadLine> has been upgraded from version 1.15 to 1.16.
832
833 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
834
835 =item *
836
837 L<Test> has been upgraded from version 1.28 to 1.30.
838
839 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
840
841 =item *
842
843 L<Test::Harness> has been upgraded from version 3.36 to 3.38.
844
845 =item *
846
847 L<Test::Simple> has been upgraded from version 1.001014 to 1.302073.
848
849 =item *
850
851 L<Thread::Queue> has been upgraded from version 3.09 to 3.12.
852
853 =item *
854
855 L<Thread::Semaphore> has been upgraded from 2.12 to 2.13.
856
857 Added the C<down_timed> method.
858
859 =item *
860
861 L<threads> has been upgraded from version 2.07 to 2.15.
862
863 Compatibility with 5.8 has been restored.
864
865 Fixes [perl #130469].
866
867 =item *
868
869 L<threads::shared> has been upgraded from version 1.51 to 1.56.
870
871 This fixes [cpan #119529], [perl #130457]
872
873 =item *
874
875 L<Tie::Hash::NamedCapture> has been upgraded from version 0.09 to 0.10.
876
877 =item *
878
879 L<Time::HiRes> has been upgraded from version 1.9733 to 1.9741.
880
881 It now builds on systems with C++11 compilers (such as G++ 6 and Clang++
882 3.9).
883
884 Now uses C<clockid_t>.
885
886 =item *
887
888 L<Time::Local> has been upgraded from version 1.2300 to 1.25.
889
890 =item *
891
892 L<Unicode::Collate> has been upgraded from version 1.14 to 1.19.
893
894 =item *
895
896 L<Unicode::UCD> has been upgraded from version 0.64 to 0.68.
897
898 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
899
900 =item *
901
902 L<version> has been upgraded from version 0.9916 to 0.9917.
903
904 =item *
905
906 L<VMS::DCLsym> has been upgraded from version 1.06 to 1.08.
907
908 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
909
910 =item *
911
912 L<warnings> has been upgraded from version 1.36 to 1.37.
913
914 =item *
915
916 L<XS::Typemap> has been upgraded from version 0.14 to 0.15.
917
918 =item *
919
920 L<XSLoader> has been upgraded from version 0.21 to 0.27.
921
922 Fixed a security hole in which binary files could be loaded from a path
923 outside of L<C<@INC>|perlvar/@INC>.
924
925 It now uses 3-arg C<open()> instead of 2-arg C<open()>. [perl #130122]
926
927 =back
928
929 =head1 Documentation
930
931 =head2 New Documentation
932
933 =head3 L<perldeprecation>
934
935 This file documents all upcoming deprecations, and some of the deprecations
936 which already have been removed. The purpose of this documentation is
937 two-fold: document what will disappear, and by which version, and serve
938 as a guide for people dealing with code which has features that no longer
939 work after an upgrade of their perl.
940
941 =head2 Changes to Existing Documentation
942
943 =head3 L<perlcall>
944
945 =over 4
946
947 =item *
948
949 Use of unassigned code point or non-standalone grapheme for a delimiter will be a fatal error starting in Perl 5.30
950
951 This was changed to drop a leading C<v> in C<v5.30>, so it uses the same
952 style as other deprecation messages.
953
954 =item *
955
956 "\c%c" is more clearly written simply as "%s".
957
958 It was decided to undeprecate the use of C<\c%c>, see L<http://www.nntp.perl.org/group/perl.perl5.porters/2017/02/msg242944.html>
959
960 =item *
961
962 Removed redundant C<dSP> from an example.
963
964 =back
965
966 =head3 L<perlcommunity>
967
968 =over 4
969
970 =item *
971
972 All references to Usenet have been removed.
973
974 =back
975
976 =head3 L<perldata>
977
978 =over 4
979
980 =item *
981
982 Updated documentation of C<scalar(%hash)>.  See L</scalar(%hash) return
983 signature changed> above.
984
985 =item *
986
987 Use of single character variables, with the variable name a non printable
988 character in the range C<\x80>-C<\xFF> is no longer allowed. Update the docs to
989 reflect this.
990
991 =back
992
993 =head3 L<perldelta>
994
995 =over 4
996
997 =item *
998
999 All references to Usenet have been removed.
1000
1001 =back
1002
1003 =head3 L<perldiag>
1004
1005 =over 4
1006
1007 =item *
1008
1009 Deprecations are to be marked with a D.
1010 C<"%s() is deprecated on :utf8 handles"> use a deprecation message, and as
1011 such, such be marked C<"(D deprecated)"> and not C<"(W deprecated)">.
1012
1013 =back
1014
1015 =head3 L<perlexperiment>
1016
1017 =over 4
1018
1019 =item *
1020
1021 Documented new feature: See L</Declaring a reference to a variable> above.
1022
1023 =back
1024
1025 =head3 L<perlfunc>
1026
1027 =over 4
1028
1029 =item *
1030
1031 Defined on aggregates is no longer allowed. Perlfunc was still reporting it as
1032 deprecated, and that it will be deleted in the future.
1033
1034 =item *
1035
1036 Clarified documentation of L<C<seek()>|perlfunc/seek>,
1037 L<C<tell()>|perlfunc/tell> and L<C<sysseek()>|perlfunc/sysseek>.
1038 L<[perl #128607]|https://rt.perl.org/Public/Bug/Display.html?id=128607>
1039
1040 =item *
1041
1042 Removed obsolete documentation of L<C<study()>|perlfunc/study>.
1043
1044 =back
1045
1046 =head3 L<perlguts>
1047
1048 =over 4
1049
1050 =item *
1051
1052 Add C<pTHX_> to magic method examples.
1053
1054 =back
1055
1056 =head3 L<perlhack>
1057
1058 =over 4
1059
1060 =item *
1061
1062 Document Tab VS Space.
1063
1064 =back
1065
1066 =head3 L<perlinterp>
1067
1068 =over 4
1069
1070 =item *
1071
1072 L<perlinterp> has been expanded to give a more detailed example of how to
1073 hunt around in the parser for how a given operator is handled.
1074
1075 =back
1076
1077 =head3 L<perllocale>
1078
1079 =over 4
1080
1081 =item *
1082
1083 Document C<NUL> collation handling.
1084
1085 =item *
1086
1087 Some locales aren't compatible with Perl.  Note the potential bad
1088 consequences of using them.
1089
1090 =back
1091
1092 =head3 L<perlmodinstall>
1093
1094 =over 4
1095
1096 =item *
1097
1098 All references to Usenet have been removed.
1099
1100 =back
1101
1102 =head3 L<perlmodlib>
1103
1104 =over 4
1105
1106 =item *
1107
1108 Updated the mirror list.
1109
1110 =item *
1111
1112 All references to Usenet have been removed.
1113
1114 =back
1115
1116 =head3 L<perlnewmod>
1117
1118 =over 4
1119
1120 =item *
1121
1122 All references to Usenet have been removed.
1123
1124 =back
1125
1126 =head3 L<perlobj>
1127
1128 =over 4
1129
1130 =item *
1131
1132 Added a section on calling methods using their fully qualified names.
1133
1134 =item *
1135
1136 Do not discourage manual @ISA.
1137
1138 =back
1139
1140 =head3 L<perlootut>
1141
1142 =over 4
1143
1144 =item *
1145
1146 Tidy the document.
1147
1148 =item *
1149
1150 Mention C<Moo> more.
1151
1152 =back
1153
1154 =head3 L<perlop>
1155
1156 =over 4
1157
1158 =item *
1159
1160 Clarify behavior single quote regexps.
1161
1162 =back
1163
1164 =head3 L<perlre>
1165
1166 =over 4
1167
1168 =item *
1169
1170 Several minor enhancements to the documentation.
1171
1172 =back
1173
1174 =head3 L<perlsec>
1175
1176 =over 4
1177
1178 =item *
1179
1180 Fixed link to Crosby paper on hash complexity attack.
1181
1182 =back
1183
1184 =head3 L<perlref>
1185
1186 =over 4
1187
1188 =item *
1189
1190 Documented new feature: See L</Declaring a reference to a variable> above.
1191
1192 =back
1193
1194 =head3 L<perltie>
1195
1196 =over 4
1197
1198 =item *
1199
1200 Updated documentation of C<scalar(%hash)>.  See L</scalar(%hash) return
1201 signature changed> above.
1202
1203 =back
1204
1205 =head3 L<perlunicode>
1206
1207 =over 4
1208
1209 =item *
1210
1211 Documented change to C<\p{I<script>}> to now use the improved Script_Extensions
1212 property.  See L</Use of \p{script} uses the improved Script_Extensions
1213 property> above.
1214
1215 =item *
1216
1217 Updated the text to correspond with changes in Unicode UTS#18, concerning
1218 regular expressions, and Perl compatibility with what it says.
1219
1220 =back
1221
1222 =head3 L<perlvar>
1223
1224 =over 4
1225
1226 =item *
1227
1228 Removed obsolete documentation of C<${^ENCODING}>.  See L</${^ENCODING} has
1229 been removed> above.
1230
1231 =item *
1232
1233 Document C<@ISA>. Was documented other places, not not in L<perlvar>.
1234
1235 =back
1236
1237 =head1 Diagnostics
1238
1239 =head2 New Diagnostics
1240
1241 =head3 New Errors
1242
1243 =over 4
1244
1245 =item *
1246
1247 Since C<.> is now removed from C<@INC> by default, C<do> will now trigger
1248 a warning recommending to fix the C<do> statement:
1249
1250 L<do "%s" failed, '.' is no longer in @INC|perldiag/do "%s" failed, '.' is no longer in @INC; did you mean do ".E<sol>%s"?>
1251
1252 =item *
1253
1254 Using the empty pattern (which re-executes the last successfully-matched
1255 pattern) inside a code block in another regex, as in C</(?{ s!!new! })/>, has
1256 always previously yielded a segfault. It now produces an error:
1257 L<Infinite recursion in regex|perldiag/"Infinite recursion in regex">.
1258
1259 =item *
1260
1261 L<The experimental declared_refs feature is not enabled|perldiag/"The experimental declared_refs feature is not enabled">
1262
1263 (F) To declare references to variables, as in C<my \%x>, you must first enable
1264 the feature:
1265
1266     no warnings "experimental::declared_refs";
1267     use feature "declared_refs";
1268
1269 =item *
1270
1271 L<Version control conflict marker|perldiag/"Version control conflict marker">
1272
1273 (F) The parser found a line starting with C<E<lt>E<lt>E<lt>E<lt>E<lt>E<lt>E<lt>>,
1274 C<E<gt>E<gt>E<gt>E<gt>E<gt>E<gt>E<gt>>, or C<=======>. These may be left by a
1275 version control system to mark conflicts after a failed merge operation.
1276
1277 =item *
1278
1279 L<%s: command not found|perldiag/"%s: command not found">
1280
1281 (A) You've accidentally run your script through B<bash> or another shell
1282 instead of Perl.  Check the #! line, or manually feed your script into
1283 Perl yourself.  The #! line at the top of your file could look like:
1284
1285   #!/usr/bin/perl
1286
1287 =item *
1288
1289 L<%s: command not found: %s|perldiag/"%s: command not found: %s">
1290
1291 (A) You've accidentally run your script through B<zsh> or another shell
1292 instead of Perl.  Check the #! line, or manually feed your script into
1293 Perl yourself.  The #! line at the top of your file could look like:
1294
1295   #!/usr/bin/perl
1296
1297 =item *
1298
1299 L<Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by S<E<lt>-- HERE> in mE<sol>%sE<sol>|perldiag/"Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by S<<-- HERE> in m/%s/">
1300
1301 Unescaped left braces are already illegal in some contexts in regular
1302 expression patterns, but, due to an oversight, no deprecation warning
1303 was raised in other contexts where they are intended to become illegal.
1304 This warning is now raised in these contexts.
1305
1306 =item *
1307
1308 L<Bareword in require contains "%s"|perldiag/"Bareword in require contains "%s"">
1309
1310 =item *
1311
1312 L<Bareword in require maps to empty filename|perldiag/"Bareword in require maps to empty filename">
1313
1314 =item *
1315
1316 L<Bareword in require maps to disallowed filename "%s"|perldiag/"Bareword in require maps to disallowed filename "%s"">
1317
1318 =item *
1319
1320 L<Bareword in require must not start with a double-colon: "%s"|perldiag/"Bareword in require must not start with a double-colon: "%s"">
1321
1322 =back
1323
1324 =head3 New Warnings
1325
1326 =over 4
1327
1328 =item *
1329
1330 L<Use of unassigned code point or non-standalone grapheme for a delimiter will be a fatal error starting in Perl 5.30|perldiag/"Use of unassigned code point or non-standalone grapheme for a delimiter will be a fatal error starting in Perl 5.30">
1331
1332 See L</Deprecations>
1333
1334 =item *
1335
1336 L<Declaring references is experimental|perldiag/"Declaring references is experimental">
1337
1338 (S experimental::declared_refs) This warning is emitted if you use a reference
1339 constructor on the right-hand side of C<my()>, C<state()>, C<our()>, or
1340 C<local()>.  Simply suppress the warning if you want to use the feature, but
1341 know that in doing so you are taking the risk of using an experimental feature
1342 which may change or be removed in a future Perl version:
1343
1344     no warnings "experimental::declared_refs";
1345     use feature "declared_refs";
1346     $fooref = my \$foo;
1347
1348 =item *
1349
1350 L<C<${^ENCODING}> is no longer supported. Its use will be fatal in Perl 5.28|perldiag/"${^ENCODING} is no longer supported. Its use will be fatal in Perl 5.28">
1351
1352 (D deprecated) The special variable C<${^ENCODING}>, formerly used to implement
1353 the C<encoding> pragma, is no longer supported as of Perl 5.26.0.
1354
1355 =back
1356
1357 =head2 Changes to Existing Diagnostics
1358
1359 =over 4
1360
1361 =item *
1362
1363 When a C<require> fails, we now do not provide C<@INC> when the C<require>
1364 is for a file instead of a module.
1365
1366 =item *
1367
1368 When C<@INC> is not scanned for a C<require> call, we no longer display
1369 C<@INC> to avoid confusion.
1370
1371 =item *
1372
1373 Attribute "locked" is deprecated, and will disappear in Perl 5.28
1374
1375 =item *
1376
1377 Attribute "unique" is deprecated, and will disappear in Perl 5.28
1378
1379 =item *
1380
1381 Constants from lexical variables potentially modified elsewhere are
1382 deprecated. This will not be allowed in Perl 5.32
1383
1384 =item *
1385
1386 Deprecated use of my() in false conditional. This will be a fatal error
1387 in Perl 5.30
1388
1389 =item *
1390
1391 dump() better written as CORE::dump(). dump() will no longer be available
1392 in Perl 5.30
1393
1394 =item *
1395
1396 ${^ENCODING} is no longer supported. Its use will be fatal in Perl 5.28
1397
1398 =item *
1399
1400 File::Glob::glob() will disappear in perl 5.30. Use File::Glob::bsd_glob()
1401 instead.
1402
1403 =item *
1404
1405 %s() is deprecated on :utf8 handles. This will be a fatal error in Perl 5.30
1406
1407 =item *
1408
1409 $* is no longer supported. Its use will be fatal in Perl 5.30
1410
1411 =item *
1412
1413 $* is no longer supported. Its use will be fatal in Perl 5.30
1414
1415 =item *
1416
1417 Opening dirhandle %s also as a file. This will be a fatal error in Perl 5.28
1418
1419 =item *
1420
1421 Opening filehandle %s also as a directory. This will be a fatal
1422 error in Perl 5.28
1423
1424 =item *
1425
1426 Setting $/ to a reference to %s as a form of slurp is deprecated,
1427 treating as undef. This will be fatal in Perl 5.28
1428
1429 =item *
1430
1431 Unescaped left brace in regex is deprecated here (and will be fatal
1432 in Perl 5.30), passed through in regex; marked by S<< E<lt>-- HERE >> in m/%s/
1433
1434 =item *
1435
1436 Unknown charname '' is deprecated. Its use will be fatal in Perl 5.28
1437
1438 =item *
1439
1440 Use of bare E<lt>E<lt> to mean E<lt>E<lt>"" is deprecated. Its use will be fatal in Perl 5.28
1441
1442 =item *
1443
1444 Use of code point 0x%s is deprecated; the permissible max is 0x%s.
1445 This will be fatal in Perl 5.28
1446
1447 =item *
1448
1449 Use of comma-less variable list is deprecated. Its use will be fatal
1450 in Perl 5.28
1451
1452 =item *
1453
1454 Use of inherited AUTOLOAD for non-method %s() is deprecated. This
1455 will be fatal in Perl 5.28
1456
1457 =item *
1458
1459 Use of strings with code points over 0xFF as arguments to %s operator
1460 is deprecated. This will be a fatal error in Perl 5.28
1461
1462 =item *
1463
1464 Improve error for missing tie() package/method. This brings the error messages
1465 in line with the ones used for normal method calls, despite not using
1466 call_method().
1467
1468 =item *
1469
1470 Make the sysread()/syswrite/() etc :utf8 handle warnings default. These
1471 warnings were under 'deprecated' previously.
1472
1473 =item *
1474
1475 'do' errors now refer to 'do' (not 'require').
1476
1477 =item *
1478
1479 Details as to the exact problem have been added to the diagnostics that
1480 occur when malformed UTF-8 is encountered when trying to convert to a
1481 code point.
1482
1483 =item *
1484
1485 Executing C<undef $x> where C<$x> is tied or magical no longer incorrectly
1486 blames the variable for an uninitialized-value warning encountered by the
1487 tied/magical code.
1488
1489 =item *
1490
1491 L<Unescaped left brace in regex is illegal here in regex; marked by S<E<lt>-- HERE> in mE<sol>%sE<sol>|perldiag/"Unescaped left brace in regex is illegal here in regex; marked by S<<-- HERE> in m/%s/">
1492
1493 The word "here" has been added to the message that was raised in
1494 v5.25.1.  This is to indicate that there are contexts in which unescaped
1495 left braces are not (yet) illegal.
1496
1497 =item *
1498
1499 Code like C<$x = $x . "a"> was incorrectly failing to yield a
1500 L<use of uninitialized value|perldiag/"Use of uninitialized value%s">
1501 warning when C<$x> was a lexical variable with an undefined value. That has
1502 now been fixed. [perl #127877]
1503
1504 =item *
1505
1506 When the error "Experimental push on scalar is now forbidden" is raised for
1507 the hash functions C<keys>, C<each>, and C<values>, it is now followed by
1508 the more helpful message, "Type of arg 1 to whatever must be hash or
1509 array". [perl #127976]
1510
1511 =item *
1512
1513 C<undef *_; shift> or C<undef *_; pop> inside a subroutine, with no
1514 argument to C<shift> or C<pop>, began crashing in Perl 5.14.0, but has now
1515 been fixed.
1516
1517 =item *
1518
1519 C<< "string$scalar-E<gt>$*" >> now correctly prefers concat overloading to
1520 string overloading if C<< $scalar-E<gt>$* >> returns an overloaded object,
1521 bringing it into consistency with C<$$scalar>.
1522
1523 =item *
1524
1525 C<< /@0{0*-E<gt>@*/*0 >> and similar contortions used to crash, but no longer
1526 do, but merely produce a syntax error. [perl #128171]
1527
1528 =item *
1529
1530 C<do> or C<require> with a reference or typeglob which, when stringified,
1531 contains a null character started crashing in Perl 5.20.0, but has now been
1532 fixed. [perl #128182]
1533
1534 =back
1535
1536 =head1 Utility Changes
1537
1538 =head2 F<c2ph> and F<pstruct>
1539
1540 =over 4
1541
1542 =item *
1543
1544 These old utilities have long since superceded by L<h2xs>, and are
1545 now gone from the distribution.
1546
1547 =back
1548
1549 =head2 F<Porting/pod_lib.pl>
1550
1551 =over 4
1552
1553 =item *
1554
1555 Removed spurious executable bit.
1556
1557 =item *
1558
1559 Account for possibility of DOS file endings.
1560
1561 =back
1562
1563 =head2 F<Porting/sync-with-cpan>
1564
1565 =over 4
1566
1567 =item *
1568
1569 Many improvements
1570
1571 =back
1572
1573 =head2 F<perf/benchmarks>
1574
1575 =over 4
1576
1577 =item *
1578
1579 Tidy file, rename some symbols.
1580
1581 =back
1582
1583 =head2 F<Porting/checkAUTHORS.pl>
1584
1585 =over 4
1586
1587 =item *
1588
1589 Replace obscure character range with \w.
1590
1591 =back
1592
1593 =head2 F<t/porting/regen.t>
1594
1595 =over 4
1596
1597 =item *
1598
1599 try to be more helpful when tests fail.
1600
1601 =back
1602
1603 =head2 F<utils/h2xs.PL>
1604
1605 =over 4
1606
1607 =item *
1608
1609 Avoid infinite loop for enums.
1610
1611 =back
1612
1613 =head2 L<perlbug>
1614
1615 =over 4
1616
1617 =item *
1618
1619 Long lines in the message body are now wrapped at 900 characters, to stay
1620 well within the 1000-character limit imposed by SMTP mail transfer agents.
1621 This is particularly likely to be important for the list of arguments to
1622 C<Configure>, which can readily exceed the limit if, for example, it names
1623 several non-default installation paths. This change also adds the first unit
1624 tests for perlbug. [perl #128020]
1625
1626 =back
1627
1628 =head1 Configuration and Compilation
1629
1630 =over 4
1631
1632 =item *
1633
1634 C<DEFAULT_INC_EXCLUDES_DOT> has been turned on as default.
1635
1636 =item *
1637
1638 The C<dtrace> build process has further changes:
1639
1640 =over
1641
1642 =item *
1643
1644 If the C<-xnolibs> is available, use that so a F<dtrace> perl can be
1645 built within a FreeBSD jail.
1646
1647 =item *
1648
1649 On systems that build a dtrace object file (FreeBSD, Solaris and
1650 SystemTap's dtrace emulation), copy the input objects to a separate
1651 directory and process them there, and use those objects in the link,
1652 since C<dtrace -G> also modifies these objects.
1653
1654 =item *
1655
1656 Add libelf to the build on FreeBSD 10.x, since dtrace adds references
1657 to libelf symbols.
1658
1659 =item *
1660
1661 Generate a dummy dtrace_main.o if C<dtrace -G> fails to build it.  A
1662 default build on Solaris generates probes from the unused inline
1663 functions, while they don't on FreeBSD, which causes C<dtrace -G> to
1664 fail.
1665
1666 =back
1667
1668 [perl #130108]
1669
1670 =item *
1671
1672 You can now disable perl's use of the PERL_HASH_SEED and
1673 PERL_PERTURB_KEYS environment variables by configuring perl with
1674 C<-Accflags=NO_PERL_HASH_ENV>.
1675
1676 =item *
1677
1678 You can now disable perl's use of the PERL_HASH_SEED_DEBUG environment
1679 variable by configuring perl with
1680 C<-Accflags=-DNO_PERL_HASH_SEED_DEBUG>.
1681
1682 =item *
1683
1684 Zero out the alignment bytes when calculating the bytes for 80-bit C<NaN>
1685 and C<Inf> to make builds more reproducible. [perl #130133]
1686
1687 =item *
1688
1689 Since 5.18 for testing purposes we have included support for
1690 building perl with a variety of non-standard, and non-recommended
1691 hash functions. Since we do not recommend the use of these functions
1692 we have removed them and their corresponding build options. Specifically
1693 this includes the following build options:
1694
1695     PERL_HASH_FUNC_SDBM
1696     PERL_HASH_FUNC_DJB2
1697     PERL_HASH_FUNC_SUPERFAST
1698     PERL_HASH_FUNC_MURMUR3
1699     PERL_HASH_FUNC_ONE_AT_A_TIME
1700     PERL_HASH_FUNC_ONE_AT_A_TIME_OLD
1701     PERL_HASH_FUNC_MURMUR_HASH_64A
1702     PERL_HASH_FUNC_MURMUR_HASH_64B
1703
1704 =item *
1705
1706 Remove "Warning: perl appears in your path"
1707
1708 This install warning is more or less obsolete, since most platforms already
1709 *will* have a /usr/bin/perl or similar provided by the OS.
1710
1711 =item *
1712
1713 Reduce verbosity of "make install.man"
1714
1715 Previously, two progress messages were emitted for each manpage: one by
1716 installman itself, and one by the function in install_lib.pl that it calls to
1717 actually install the file. Disabling the second of those in each case saves
1718 over 750 lines of unhelpful output.
1719
1720 =item *
1721
1722 Cleanup for clang -Weverything support. [perl 129961]
1723
1724 =item *
1725
1726 Configure: signbit scan was assuming too much, stop assuming negative 0.
1727
1728 =item *
1729
1730 Various compiler warnings have been silenced.
1731
1732 =item *
1733
1734 Several smaller changes have been made to remove impediments to compiling under
1735 C++11.
1736
1737 =item *
1738
1739 Builds using C<USE_PAD_RESET> now work again; this configuration had
1740 bit-rotted.
1741
1742 =item *
1743
1744 A probe for C<gai_strerror> was added to F<Configure> that checks if the
1745 the gai_strerror() routine is available and can be used to
1746 translate error codes returned by getaddrinfo() into human
1747 readable strings.
1748
1749 =item *
1750
1751 F<Configure> now aborts if both "-Duselongdouble" and "-Dusequadmath" are
1752 requested.
1753 L<[perl #126203]|https://rt.perl.org/Public/Bug/Display.html?id=126203>
1754
1755 =item *
1756
1757 Fixed a bug in which F<Configure> could append "-quadmath" to the archname even
1758 if it was already present.
1759 L<[perl #128538]|https://rt.perl.org/Public/Bug/Display.html?id=128538>
1760
1761 =item *
1762
1763 Clang builds with "-DPERL_GLOBAL_STRUCT" or "-DPERL_GLOBAL_STRUCT_PRIVATE" have
1764 been fixed (by disabling Thread Safety Analysis for these configurations).
1765
1766 =item *
1767
1768 F<make_ext.pl> no longer updates a module's F<pm_to_blib> file when no
1769 files require updates.  This could cause dependencies, F<perlmain.c>
1770 in particular, to be rebuilt unnecessarily.  [perl #126710]
1771
1772 =item *
1773
1774 The output of C<perl -V> has been reformatted so that each configuration
1775 and compile-time option is now listed one per line, to improve
1776 readability.
1777
1778 =item *
1779
1780 C<Configure> now builds C<miniperl> and C<generate_uudmap> if you
1781 invoke it with C<-Dusecrosscompiler> but not C<-Dtargethost=somehost>.
1782 This means you can supply your target platform C<config.sh>, generate
1783 the headers and proceed to build your cross-target perl.  [perl #127234]
1784
1785 =item *
1786
1787 Builds with C<-Accflags=-DPERL_TRACE_OPS> now only dump the operator
1788 counts when the environment variable C<PERL_TRACE_OPS> to be set to a
1789 non-zero integer.  This allows C<make test> to pass on such a build.
1790
1791 =item *
1792
1793 When building with GCC 6 and link-time optimization (the C<-flto> option to
1794 C<gcc>), C<Configure> was treating all probed symbols as present on the
1795 system, regardless of whether they actually exist. This has been fixed.
1796 [perl #128131]
1797
1798 =item *
1799
1800 The F<t/test.pl> library is used for internal testing of Perl itself, and
1801 also copied by several CPAN modules. Some of those modules must work on
1802 older versions of Perl, so F<t/test.pl> must in turn avoid newer Perl
1803 features. Compatibility with Perl 5.8 was inadvertently removed some time
1804 ago; it has now been restored. [perl #128052]
1805
1806 =item *
1807
1808 The build process no longer emits an extra blank line before building each
1809 "simple" extension (those with only F<*.pm> and F<*.pod> files).
1810
1811 =back
1812
1813 =head1 Testing
1814
1815 =over 4
1816
1817 =item *
1818
1819 F<XS-APItest/t/utf8.t>: Several small fixes and enhancements.
1820
1821 =item *
1822
1823 Tests for locales were erroneously using locales incompatible with Perl.
1824
1825 =item *
1826
1827 Some parts of the test suite that try to exhaustively test edge cases in the
1828 regex implementation have been restricted to running for a maximum of five
1829 minutes. On slow systems they could otherwise take several hours, without
1830 significantly improving our understanding of the correctness of the code
1831 under test.
1832
1833 In addition, some of those test cases have been split into more files, to
1834 allow them to be run in parallel on suitable systems.
1835
1836 =item *
1837
1838 A new internal facility allows analysing the time taken by the individual
1839 tests in Perl's own test suite; see F<Porting/harness-timer-report.pl>.
1840
1841 =item *
1842
1843 F<t/re/regexp_nonull.t> has been added to test that the regular expression
1844 engine can handle scalars that do not have a null byte just past the end of
1845 the string.
1846
1847 =item *
1848
1849 A new test script, F<t/op/decl-refs.t>, has been added to test the new feature,
1850 "Declaring a reference to a variable".
1851
1852 =item *
1853
1854 A new test script, F<t/re/anyof.t>, has been added to test that the ANYOF nodes
1855 generated by bracketed character classes are as expected.
1856
1857 =item *
1858
1859 F<t/harness> now tries really hard not to run tests outside of the Perl
1860 source tree. [perl #124050]
1861
1862 =back
1863
1864 =head1 Platform Support
1865
1866 =head2 New Platforms
1867
1868 =over 4
1869
1870 =item NetBSD/VAX
1871
1872 Perl now compiles under NetBSD on VAX machines.  However, it's not
1873 possible for that platform to implement floating-point infinities and
1874 NaNs compatibly with most modern systems, which implement the IEEE-754
1875 floating point standard.  The hexadecimal floating point (C<0x...p[+-]n>
1876 literals, C<printf %a>) is not implemented, either.
1877 The C<make test> passes 98% of tests.
1878
1879 =over 4
1880
1881 =item *
1882
1883 Test fixes and minor updates.
1884
1885 =item *
1886
1887 Account for lack of C<inf>, C<nan>, and C<-0.0> support.
1888
1889 =back
1890
1891 =back
1892
1893 =head2 Platform-Specific Notes
1894
1895 =over 4
1896
1897 =item Darwin
1898
1899 don't treat -Dprefix=/usr as special, instead require an extra option
1900 -Ddarwin_distribution to produce the same results.
1901
1902 =item POSIX
1903
1904 Finish removing POSIX deprecated functions.
1905
1906 =item OS X
1907
1908 OS X El Capitan doesn't implement the clock_gettime() or clock_getres() APIs,
1909 emulate them as necessary.
1910
1911 =item macOS
1912
1913 Deprecated syscall(2) on macOS 10.12.
1914
1915 =item EBCDIC
1916
1917 Several tests have been updated to work (or be skipped) on EBCDIC platforms.
1918
1919 =item HP-UX
1920
1921 L<Net::Ping> UDP test is skipped on HP-UX.
1922
1923 =item Hurd
1924
1925 The hints for Hurd have been improved enabling malloc wrap and reporting the
1926 GNU libc used (previously it was an empty string when reported).
1927
1928 =item VAX
1929
1930 VAX floating point formats are now supported.
1931
1932 =item VMS
1933
1934 =over 4
1935
1936 =item *
1937
1938 The path separator for the C<PERL5LIB> and C<PERLLIB> environment entries is
1939 now a colon (C<:>) when running under a Unix shell. There is no change when
1940 running under DCL (it's still C<|>).
1941
1942 =item *
1943
1944 Remove some VMS-specific hacks from C<showlex.t>. These were added 15 years
1945 ago, and are no longer necessary for any VMS version now supported.
1946
1947 =item *
1948
1949 Move C<_pDEPTH> and C<_aDEPTH> after F<config.h> otherwise DEBUGGING
1950 may not be defined yet.
1951
1952 =item *
1953
1954 VAXC has not been a possibility for a good long while, and the versions of the
1955 DEC/Compaq/HP/VSI C compiler that report themselves as "DEC" in a listing file
1956 are 15 years or more out-of-date and can be safely desupported.
1957
1958 =back
1959
1960 =item Windows
1961
1962 =over 4
1963
1964 =item *
1965
1966 Support for compiling perl on Windows using Microsoft Visual Studio 2015
1967 (containing Visual C++ 14.0) has been added.
1968
1969 This version of VC++ includes a completely rewritten C run-time library, some
1970 of the changes in which mean that work done to resolve a socket close() bug in
1971 perl #120091 and perl #118059 is not workable in its current state with this
1972 version of VC++.  Therefore, we have effectively reverted that bug fix for
1973 VS2015 onwards on the basis that being able to build with VS2015 onwards is
1974 more important than keeping the bug fix.  We may revisit this in the future to
1975 attempt to fix the bug again in a way that is compatible with VS2015.
1976
1977 These changes do not affect compilation with GCC or with Visual Studio versions
1978 up to and including VS2013, i.e. the bug fix is retained (unchanged) for those
1979 compilers.
1980
1981 Note that you may experience compatibility problems if you mix a perl built
1982 with GCC or VS E<lt>= VS2013 with XS modules built with VS2015, or if you mix a
1983 perl built with VS2015 with XS modules built with GCC or VS E<lt>= VS2013.
1984 Some incompatibility may arise because of the bug fix that has been reverted
1985 for VS2015 builds of perl, but there may well be incompatibility anyway because
1986 of the rewritten CRT in VS2015 (e.g. see discussion at
1987 http://stackoverflow.com/questions/30412951).
1988
1989 =back
1990
1991 =item Win32
1992
1993 =over 4
1994
1995 =item *
1996
1997 Tweaks for Win32 VC vs GCC detection makefile code. This fixes issue that CCHOME
1998 depends on CCTYPE, which in auto detect mode is set after CCHOME, so CCHOME uses
1999 the uninit CCTYPE var. Also fix else vs .ELSE in makefile.mk
2000
2001 =item *
2002
2003 fp definitions have been updated.
2004
2005 =back
2006
2007 =item VMS And Win32
2008
2009 Fix some breakage, add 'undef' value for default_inc_excludes_dot in build
2010 scripts.
2011
2012 =item Linux
2013
2014 Drop support for Linux a.out Linux has used ELF for over twenty years.
2015
2016 =item OpenBSD 6
2017
2018 OpenBSD 6 still does not support returning pid, gid or uid with SA_SIGINFO.
2019 Make sure this is accounted for.
2020
2021 =item FreeBSD
2022
2023 t/uni/overload.t: Skip hanging test on FreeBSD.
2024
2025 =back
2026
2027 =head1 Internal Changes
2028
2029 =over 4
2030
2031 =item *
2032
2033 The C<op_class()> API function has been added. This is like the existing
2034 C<OP_CLASS()> macro, but can more accurately determine what struct an op
2035 has been allocated as. For example C<OP_CLASS()> might return
2036 C<OA_BASEOP_OR_UNOP> indicating that ops of this type are usually
2037 allocated as an C<OP> or C<UNOP>; while C<op_class()> will return
2038 C<OPclass_BASEOP> or C<OPclass_UNOP> as appropriate.
2039
2040 =item *
2041
2042 The output format of the C<op_dump()> function (as used by C<perl -Dx>)
2043 has changed: it now displays an "ASCII-art" tree structure, and shows more
2044 low-level details about each op, such as its address and class.
2045
2046 =item *
2047
2048 New versions of macros like C<isALPHA_utf8> and C<toLOWER_utf8>  have
2049 been added, each with the
2050 suffix C<_safe>, like C<isSPACE_utf8_safe>.  These take an extra
2051 parameter, giving an upper limit of how far into the string it is safe
2052 to read.  Using the old versions could cause attempts to read beyond the
2053 end of the input buffer if the UTF-8 is not well-formed, and their use
2054 now raises a deprecation warning.  Details are at
2055 L<perlapi/Character classification>.
2056
2057 =item *
2058
2059 Calling macros like C<isALPHA_utf8> on malformed UTF-8 have issued a
2060 deprecation warning since Perl v5.18.  They now die.
2061 Similarly, macros like C<toLOWER_utf8> on malformed UTF-8 now die.
2062
2063 =item *
2064
2065 Calling the functions C<utf8n_to_uvchr> and its derivatives, while
2066 passing a string length of 0 is now asserted against in DEBUGGING
2067 builds, and otherwise returns the Unicode REPLACEMENT CHARACTER.   If
2068 you have nothing to decode, you shouldn't call the decode function.
2069
2070 =item *
2071
2072 The functions C<utf8n_to_uvchr> and its derivatives now return the
2073 Unicode REPLACEMENT CHARACTER if called with UTF-8 that has the overlong
2074 malformation, and that malformation is allowed by the input parameters.
2075 This malformation is where the UTF-8 looks valid syntactically, but
2076 there is a shorter sequence that yields the same code point.  This has
2077 been forbidden since Unicode version 3.1.
2078
2079 =item *
2080
2081 The functions C<utf8n_to_uvchr> and its derivatives now accept an input
2082 flag to allow the overflow malformation.  This malformation is when the
2083 UTF-8 may be syntactically valid, but the code point it represents is
2084 not capable of being represented in the word length on the platform.
2085 What "allowed" means in this case is that the function doesn't return an
2086 error, and advances the parse pointer to beyond the UTF-8 in question,
2087 but it returns the Unicode REPLACEMENT CHARACTER as the value of the
2088 code point (since the real value is not representable).
2089
2090 =item *
2091
2092 The C<PADOFFSET> type has changed from being unsigned to signed, and
2093 several pad-related variables such as C<PL_padix> have changed from being
2094 of type C<I32> to type C<PADOFFSET>.
2095
2096 =item *
2097
2098 The function C<L<perlapi/utf8n_to_uvchr>> has been changed to not
2099 abandon searching for other malformations when the first one is
2100 encountered.  A call to it thus can generate multiple diagnostics,
2101 instead of just one.
2102
2103 =item *
2104
2105 A new function, C<L<perlapi/utf8n_to_uvchr_error>>, has been added for
2106 use by modules that need to know the details of UTF-8 malformations
2107 beyond pass/fail.  Previously, the only ways to know why a sequence was
2108 ill-formed was to capture and parse the generated diagnostics, or to do
2109 your own analysis.
2110
2111 =item *
2112
2113 Several new functions for handling Unicode have been added to the API:
2114 C<L<perlapi/is_strict_utf8_string>>,
2115 C<L<perlapi/is_c9strict_utf8_string>>,
2116 C<L<perlapi/is_utf8_string_flags>>,
2117 C<L<perlapi/is_strict_utf8_string_loc>>,
2118 C<L<perlapi/is_strict_utf8_string_loclen>>,
2119 C<L<perlapi/is_c9strict_utf8_string_loc>>,
2120 C<L<perlapi/is_c9strict_utf8_string_loclen>>,
2121 C<L<perlapi/is_utf8_string_loc_flags>>,
2122 C<L<perlapi/is_utf8_string_loclen_flags>>,
2123 C<L<perlapi/is_utf8_fixed_width_buf_flags>>,
2124 C<L<perlapi/is_utf8_fixed_width_buf_loc_flags>>,
2125 C<L<perlapi/is_utf8_fixed_width_buf_loclen_flags>>.
2126
2127 These functions are all extensions of the C<is_utf8_string_*()> functions,
2128 that apply various restrictions to the UTF-8 recognized as valid.
2129
2130 =item *
2131
2132 A new API function C<sv_setvpv_bufsize()> allows simultaneously setting the
2133 length and allocated size of the buffer in an C<SV>, growing the buffer if
2134 necessary.
2135
2136 =item *
2137
2138 A new API macro C<SvPVCLEAR()> sets its C<SV> argument to an empty string,
2139 like Perl-space C<$x = ''>, but with several optimisations.
2140
2141 =item *
2142
2143 All parts of the internals now agree that the C<sassign> op is a C<BINOP>;
2144 previously it was listed as a C<BASEOP> in F<regen/opcodes>, which meant
2145 that several parts of the internals had to be special-cased to accommodate
2146 it. This oddity's original motivation was to handle code like C<$x ||= 1>;
2147 that is now handled in a simpler way.
2148
2149 =item *
2150
2151 Several new internal C macros have been added that take a string literal as
2152 arguments, alongside existing routines that take the equivalent value as two
2153 arguments, a character pointer and a length. The advantage of this is that
2154 the length of the string is calculated automatically, rather than having to
2155 be done manually. These routines are now used where appropriate across the
2156 entire codebase.
2157
2158 =item *
2159
2160 The code in F<gv.c> that determines whether a variable has a special meaning
2161 to Perl has been simplified.
2162
2163 =item *
2164
2165 The C<DEBUGGING>-mode output for regex compilation and execution has been
2166 enhanced.
2167
2168 =item *
2169
2170 Several macros and functions have been added to the public API for
2171 dealing with Unicode and UTF-8-encoded strings.  See
2172 L<perlapi/Unicode Support>.
2173
2174 =item *
2175
2176 Use C<my_strlcat()> in C<locale.c>. While C<strcat()> is safe in this context,
2177 some compilers were optimizing this to C<strcpy()> causing a porting test to
2178 fail that looks for unsafe code. Rather than fighting this, we just use
2179 C<my_strlcat()> instead.
2180
2181 =item *
2182
2183 Three new ops, C<OP_ARGELEM>, C<OP_ARGDEFELEM> and C<OP_ARGCHECK> have
2184 been added. These are intended principally to implement the individual
2185 elements of a subroutine signature, plus any overall checking required.
2186
2187 =item *
2188
2189 Perl no longer panics when switching into some locales on machines with
2190 buggy C<strxfrm()> implementations in their libc. [perl #121734]
2191
2192 =item *
2193
2194 Perl is now built with the C<PERL_OP_PARENT> compiler define enabled by
2195 default. To disable it, use the C<PERL_NO_OP_PARENT> compiler define.
2196 This flag alters how the C<op_sibling> field is used in C<OP> structures,
2197 and has been available optionally since perl 5.22.0.
2198
2199 See L<perl5220delta/"Internal Changes"> for more details of what this
2200 build option does.
2201
2202 =item *
2203
2204 The meanings of some internal SV flags have been changed
2205
2206 OPpRUNTIME, SVpbm_VALID, SVpbm_TAIL, SvTAIL_on, SvTAIL_off, SVrepl_EVAL,
2207 SvEVALED
2208
2209 =item *
2210
2211 Change C<hv_fetch(…, "…", …, …)> to C<hv_fetchs(…, "…", …)>
2212
2213 The dual-life dists all use Devel::PPPort, so they can use this function even
2214 though it was only added in 5.10.
2215
2216 =back
2217
2218 =head1 Selected Bug Fixes
2219
2220 =over 4
2221
2222 =item *
2223
2224 C< $-{$name} > would leak an C<AV> on each access if the regular
2225 expression had no named captures.  The same applies to access to any
2226 hash tied with L<Tie::Hash::NamedCapture> and C<< all =E<gt> 1 >>. [perl
2227 #130822]
2228
2229 =item *
2230
2231 Attempting to use the deprecated variable C<$#> as the object in an
2232 indirect object method call could cause a heap use after free or
2233 buffer overflow.  [perl #129274]
2234
2235 =item *
2236
2237 When checking for an indirect object method call in some rare cases
2238 the parser could reallocate the line buffer but then continue to use
2239 pointers to the old buffer.  [perl #129190]
2240
2241 =item *
2242
2243 Supplying a glob as the format argument to L<perlfunc/formline> would
2244 cause an assertion failure.  [perl #130722]
2245
2246 =item *
2247
2248 Code like C< $value1 =~ qr/.../ ~~ $value2 > would have the match
2249 converted into a qr// operator, leaving extra elements on the stack to
2250 confuse any surrounding expression.  [perl #130705]
2251
2252 =item *
2253
2254 Since 5.24.0 in some obscure cases, a regex which included code blocks
2255 from multiple sources (e.g. via embedded via qr// objects) could end up
2256 with the wrong current pad and crash or give weird results. [perl #129881]
2257
2258 =item *
2259
2260 Occasionally C<local()>s in a code block within a patterns weren't being
2261 undone when the pattern matching backtracked over the code block.
2262 [perl #126697]
2263
2264 =item *
2265
2266 Using C<substr()> to modify a magic variable could access freed memory
2267 in some cases.  [perl #129340]
2268
2269 =item *
2270
2271 Perl 5.25.9 was fixed so that under C<use utf8>, the entire Perl program
2272 is checked that the UTF-8 is wellformed.  It turns out that several edge
2273 cases were missed, and are now fixed.  [perl #126310] was the original
2274 ticket.
2275
2276 =item *
2277
2278 Under C<use utf8>, the entire Perl program is now checked that the UTF-8
2279 is wellformed.  This resolves [perl #126310].
2280
2281 =item *
2282
2283 The range operator C<..> on strings now handles its arguments correctly when in
2284 the scope of the L<< C<unicode_strings>|feature/"The 'unicode_strings' feature" >>
2285 feature. The previous behaviour was sufficiently unexpected that we believe no
2286 correct program could have made use of it.
2287
2288 =item *
2289
2290 The S<split> operator did not ensure enough space was allocated for
2291 its return value in scalar context.  It could then write a single
2292 pointer immediately beyond the end of the memory block allocated for
2293 the stack.  [perl #130262]
2294
2295 =item *
2296
2297 Using a large code point with the C<W> pack template character with
2298 the current output position aligned at just the right point could
2299 cause a write a single zero byte immediately beyond the end of an
2300 allocated buffer.  [perl #129149]
2301
2302 =item *
2303
2304 Supplying the form picture argument as part of the form argument list
2305 where the picture specifies modifying the argument could cause an
2306 access to the new freed compiled form.  [perl #129125]
2307
2308 =item *
2309
2310 Fix a problem with sort's build-in compare, where it would not sort
2311 correctly with 64-bit integers, and non-long doubles. [perl #130335]
2312
2313 =item *
2314
2315 Fix issues with /(?{ ... E<lt>E<lt>EOF })/ that broke Method-Signatures. [perl #130398]
2316
2317 =item *
2318
2319 Fix a macro which caused syntax error on an EBCDIC build.
2320
2321 =item *
2322
2323 Prevent tests from getting hung up on 'NonStop' option. [perl #130445]
2324
2325 =item *
2326
2327 Fixed an assertion failure with C<chop> and C<chomp>, which
2328 could be triggered by C<chop(@x =~ tr/1/1/)>. [perl #130198].
2329
2330 =item *
2331
2332 Fixed a comment skipping error under C</x>; it could stop skipping a
2333 byte early, which could be in the middle of a UTF-8 character.
2334 [perl #130495].
2335
2336 =item *
2337
2338 F<perldb> now ignores F</dev/tty> on non-Unix systems. [perl #113960];
2339
2340 =item *
2341
2342 Fix assertion failure for C<{}-E<gt>$x> when C<$x> isn't defined. [perl #130496].
2343
2344 =item *
2345
2346 DragonFly BSD now has support for setproctitle(). [perl #130068].
2347
2348 =item *
2349
2350 Fix an assertion error which could be triggered when lookahead string
2351 in patterns exceeded a minimum length. [perl #130522].
2352
2353 =item *
2354
2355 Only warn once per literal about a misplaced C<_>. [perl #70878].
2356
2357 =item *
2358
2359 Ensure range-start is set after error in C<tr///>. [perl #129342].
2360
2361 =item *
2362
2363 Don't read past start of string for unmatched backref; otherwise,
2364 we may have heap buffer overflow. [perl #129377].
2365
2366 =item *
2367
2368 Properly recognize mathematical digit ranges starting at U+1D7E.
2369 C<use re 'strict'> is supposed to warn if you use a range whose start
2370 and end digit aren't from the same group of 10. It didn't do that
2371 for five groups of mathematical digits starting at U+1D7E.
2372
2373 =item *
2374
2375 A sub containing a "forward" declaration with the same name (e.g.,
2376 C<sub c { sub c; }>) could sometimes crash or loop infinitely.  [perl
2377 #129090]
2378
2379 =item *
2380
2381 A crash in executing a regex with a floating UTF-8 substring against a
2382 target string that also used UTF-8 has been fixed. [perl #129350]
2383
2384 =item *
2385
2386 Previously, a shebang line like C<#!perl -i u> could be erroneously
2387 interpreted as requesting the C<-u> option. This has been fixed. [perl
2388 #129336]
2389
2390 =item *
2391
2392 The regex engine was previously producing incorrect results in some rare
2393 situations when backtracking past a trie that matches only one thing; this
2394 showed up as capture buffers (C<$1>, C<$2>, etc) erroneously containing data
2395 from regex execution paths that weren't actually executed for the final
2396 match.  [perl #129897]
2397
2398 =item *
2399
2400 Certain regexes making use of the experimental C<regex_sets> feature could
2401 trigger an assertion failure. This has been fixed. [perl #129322]
2402
2403 =item *
2404
2405 Invalid assignments to a reference constructor (e.g., C<\eval=time>) could
2406 sometimes crash in addition to giving a syntax error.  [perl #125679]
2407
2408 =item *
2409
2410 The parser could sometimes crash if a bareword came after C<evalbytes>.
2411 [perl #129196]
2412
2413 =item *
2414
2415 Autoloading via a method call would warn erroneously ("Use of inherited
2416 AUTOLOAD for non-method") if there was a stub present in the package into
2417 which the invocant had been blessed.  The warning is no longer emitted in
2418 such circumstances.  [perl #47047]
2419
2420 =item *
2421
2422 A sub containing with a "forward" declaration with the same name (e.g.,
2423 C<sub c { sub c; }>) could sometimes crash or loop infinitely.  [perl
2424 #129090]
2425
2426 =item *
2427
2428 The use of C<splice> on arrays with nonexistent elements could cause other
2429 operators to crash.  [perl #129164]
2430
2431 =item *
2432
2433 Fixed case where C<re_untuit_start> will overshoot the length of a utf8
2434 string. [perl #129012]
2435
2436 =item *
2437
2438 Handle C<CXt_SUBST> better in C<Perl_deb_stack_all>, previously it wasn't
2439 checking that the I<current> C<cx> is the right type, and instead was always
2440 checking the base C<cx> (effectively a noop). [perl #129029]
2441
2442 =item *
2443
2444 Fixed two possible use-after-free bugs in C<Perl_yylex>. C<Perl_yylex>
2445 maintains up to two pointers into the parser buffer, one of which can
2446 become stale under the right conditions. [perl #129069]
2447
2448 =item *
2449
2450 Fixed a crash with C<s///l> where it thought it was dealing with UTF-8
2451 when it wasn't. [perl #129038]
2452
2453 =item *
2454
2455 Fixed place where regex was not setting the syntax error correctly.
2456 [perl #129122]
2457
2458 =item *
2459
2460 The C<&.> operator (and the C<&> operator, when it treats its arguments as
2461 strings) were failing to append a trailing null byte if at least one string
2462 was marked as utf8 internally.  Many code paths (system calls, regexp
2463 compilation) still expect there to be a null byte in the string buffer
2464 just past the end of the logical string.  An assertion failure was the
2465 result.  [perl #129287]
2466
2467 =item *
2468
2469 Check C<pack_sockaddr_un()>'s return value because C<pack_sockaddr_un()>
2470 silently truncates the supplied path if it won't fit into the C<sun_path>
2471 member of C<sockaddr_un>. This may change in the future, but for now
2472 check the path in theC<sockaddr> matches the desired path, and skip if
2473 it doesn't. [perl #128095]
2474
2475 =item *
2476
2477 Make sure C<PL_oldoldbufptr> is preserved in C<scan_heredoc()>. In some
2478 cases this is used in building error messages. [perl #128988]
2479
2480 =item *
2481
2482 Check for null PL_curcop in IN_LC() [perl #129106]
2483
2484 =item *
2485
2486 Fixed the parser error handling for an 'C<:attr(foo>' that does not have
2487 an ending 'C<)>'.
2488
2489 =item *
2490
2491 Fix C<Perl_delimcpy()> to handle a backslash as last char, this
2492 actually fixed two bugs, [perl #129064] and [perl #129176].
2493
2494 =item *
2495
2496 [perl #129267] rework gv_fetchmethod_pvn_flags separator parsing to
2497 prevent possible string overrun with invalid len in gv.c
2498
2499 =item *
2500
2501 Problems with in-place array sorts: code like C<@a = sort { ... } @a>,
2502 where the source and destination of the sort are the same plain array, are
2503 optimised to do less copying around. Two side-effects of this optimisation
2504 were that the contents of C<@a> as visible to to sort routine were
2505 partially sorted, and under some circumstances accessing C<@a> during the
2506 sort could crash the interpreter. Both these issues have been fixed, and
2507 Sort functions see the original value of C<@a>.
2508
2509 =item *
2510
2511 Non-ASCII string delimiters are now reported correctly in error messages
2512 for unterminated strings.  [perl #128701]
2513
2514 =item *
2515
2516 C<pack("p", ...)> used to emit its warning ("Attempt to pack pointer to
2517 temporary value") erroneously in some cases, but has been fixed.
2518
2519 =item *
2520
2521 C<@DB::args> is now exempt from "used once" warnings.  The warnings only
2522 occurred under B<-w>, because F<warnings.pm> itself uses C<@DB::args>
2523 multiple times.
2524
2525 =item *
2526
2527 The use of built-in arrays or hash slices in a double-quoted string no
2528 longer issues a warning ("Possible unintended interpolation...") if the
2529 variable has not been mentioned before.  This affected code like
2530 C<qq|@DB::args|> and C<qq|@SIG{'CHLD', 'HUP'}|>.  (The special variables
2531 C<@-> and C<@+> were already exempt from the warning.)
2532
2533 =item *
2534
2535 C<gethostent> and similar functions now perform a null check internally, to
2536 avoid crashing with torsocks.  This was a regression from 5.22.  [perl
2537 #128740]
2538
2539 =item *
2540
2541 C<defined *{'!'}>, C<defined *{'['}>, and C<defined *{'-'}> no longer leak
2542 memory if the typeglob in question has never been accessed before.
2543
2544 =item *
2545
2546 In 5.25.4 fchown() was changed not to accept negative one as an argument
2547 because in some platforms that is an error.  However, in some other platforms
2548 that is an acceptable argument.  This change has been reverted [perl #128967].
2549
2550 =item *
2551
2552 Mentioning the same constant twice in a row (which is a syntax error) no
2553 longer fails an assertion under debugging builds.  This was a regression
2554 from 5.20.  [perl #126482]
2555
2556 =item *
2557
2558 Many issues relating to C<printf "%a"> of hexadecimal floating point
2559 were fixed.  In addition, the "subnormals" (formerly known as "denormals")
2560 floating point anumbers are now supported both with the plain IEEE 754
2561 floating point numbers (64-bit or 128-bit) and the x86 80-bit
2562 "extended precision".  Note that subnormal hexadecimal floating
2563 point literals will give a warning about "exponent underflow".
2564 [perl #128843, #128889, #128890, #128893, #128909, #128919]
2565
2566 =item *
2567
2568 A regression in 5.24 with C<tr/\N{U+...}/foo/> when the code point was between
2569 128 and 255 has been fixed. [perl #128734].
2570
2571 =item *
2572
2573 A regression from the previous development release, 5.23.3, where
2574 compiling a regular expression could crash the interpreter has been
2575 fixed. [perl #128686].
2576
2577 =item *
2578
2579 Use of a string delimiter whose code point is above 2**31 now works
2580 correctly on platforms that allow this.  Previously, certain characters,
2581 due to truncation, would be confused with other delimiter characters
2582 with special meaning (such as C<?> in C<m?...?>), resulting
2583 in inconsistent behaviour.  Note that this is non-portable,
2584 and is based on Perl's extension to UTF-8, and is probably not
2585 displayable nor enterable by any editor. [perl #128738]
2586
2587 =item *
2588
2589 C<@{x> followed by a newline where C<x> represents a control or non-ASCII
2590 character no longer produces a garbled syntax error message or a crash.
2591 [perl #128951]
2592
2593 =item *
2594
2595 An assertion failure with C<%: = 0> has been fixed.
2596 L<[perl #128238]|https://rt.perl.org/Public/Bug/Display.html?id=128238>
2597
2598 =item *
2599
2600 In Perl 5.18, the parsing of C<"$foo::$bar"> was accidentally changed, such
2601 that it would be treated as C<$foo."::".$bar>.  The previous behavior, which
2602 was to parse it as C<$foo:: . $bar>, has been restored.
2603 L<[perl #128478]|https://rt.perl.org/Public/Bug/Display.html?id=128478>
2604
2605 =item *
2606
2607 Since Perl 5.20, line numbers have been off by one when perl is invoked with
2608 the B<-x> switch.  This has been fixed.
2609 L<[perl #128508]|https://rt.perl.org/Public/Bug/Display.html?id=128508>
2610
2611 =item *
2612
2613 Vivifying a subroutine stub in a deleted stash (e.g., C<delete $My::{"Foo::"};
2614 \&My::Foo::foo>) no longer crashes.  It had begun crashing in Perl 5.18.
2615 L<[perl #128532]|https://rt.perl.org/Public/Bug/Display.html?id=128532>
2616
2617 =item *
2618
2619 Some obscure cases of subroutines and file handles being freed at the same time
2620 could result in crashes, but have been fixed.  The crash was introduced in Perl
2621 5.22.
2622 L<[perl #128597]|https://rt.perl.org/Public/Bug/Display.html?id=128597>
2623
2624 =item *
2625
2626 Code that looks for a variable name associated with an uninitialized value
2627 could cause an assertion in cases where magic is involved, such as
2628 C<$ISA[0][0]>.  This has now been fixed.
2629 L<[perl #128253]|https://rt.perl.org/Public/Bug/Display.html?id=128253>
2630
2631 =item *
2632
2633 A crash caused by code generating the warning "Subroutine STASH::NAME
2634 redefined" in cases such as C<sub P::f{} undef *P::; *P::f =sub{};> has been
2635 fixed.  In these cases, where the STASH is missing, the warning will now appear
2636 as "Subroutine NAME redefined".
2637 L<[perl #128257]|https://rt.perl.org/Public/Bug/Display.html?id=128257>
2638
2639 =item *
2640
2641 Fixed an assertion triggered by some code that handles deprecated behavior in
2642 formats, e.g. in cases like this:
2643
2644     format STDOUT =
2645     @
2646     0"$x"
2647
2648 L<[perl #128255]|https://rt.perl.org/Public/Bug/Display.html?id=128255>
2649
2650 =item *
2651
2652 A possible divide by zero in string transformation code on Windows has been
2653 avoided, fixing a crash when collating an empty string.
2654 L<[perl #128618]|https://rt.perl.org/Public/Bug/Display.html?id=128618>
2655
2656 =item *
2657
2658 Some regular expression parsing glitches could lead to assertion failures with
2659 regular expressions such as C</(?E<lt>=/> and C</(?E<lt>!/>.  This has now been fixed.
2660 L<[perl #128170]|https://rt.perl.org/Public/Bug/Display.html?id=128170>
2661
2662 =item *
2663
2664 C< until ($x = 1) { ... } > and C< ... until $x = 1 > now properly
2665 warn when syntax warnings are enabled.  [perl #127333]
2666
2667 =item *
2668
2669 socket() now leaves the error code returned by the system in C<$!> on
2670 failure.  [perl #128316]
2671
2672 =item *
2673
2674 Assignment variants of any bitwise ops under the C<bitwise> feature would
2675 crash if the left-hand side was an array or hash.  [perl #128204]
2676
2677 =item *
2678
2679 C<require> followed by a single colon (as in C<foo() ? require : ...> is
2680 now parsed correctly as C<require> with implicit $_, rather than
2681 C<require "">.  [perl #128307]
2682
2683 =item *
2684
2685 Scalar C<keys %hash> can now be assigned to consistently in all scalar
2686 lvalue contexts.  Previously it worked for some contexts but not others.
2687
2688 =item *
2689
2690 List assignment to C<vec> or C<substr> with an array or hash for its first
2691 argument used to result in crashes or "Can't coerce" error messages at run
2692 time, unlike scalar assignment, which would give an error at compile time.
2693 List assignment now gives a compile-time error, too.  [perl #128260]
2694
2695 =item *
2696
2697 Expressions containing an C<&&> or C<||> operator (or their synonyms C<and>
2698 and C<or>) were being compiled incorrectly in some cases. If the left-hand
2699 side consisted of either a negated bareword constant or a negated C<do {}>
2700 block containing a constant expression, and the right-hand side consisted of
2701 a negated non-foldable expression, one of the negations was effectively
2702 ignored. The same was true of C<if> and C<unless> statement modifiers,
2703 though with the left-hand and right-hand sides swapped. This long-standing
2704 bug has now been fixed. [perl #127952]
2705
2706 =item *
2707
2708 C<reset> with an argument no longer crashes when encountering stash entries
2709 other than globs. [perl #128106]
2710
2711 =item *
2712
2713 Assignment of hashes to, and deletion of, typeglobs named C<*::::::> no
2714 longer causes crashes. [perl #128086]
2715
2716 =item *
2717
2718 Handle SvIMMORTALs in LHS of list assign. [perl #129991]
2719
2720 =item *
2721
2722 [perl #130010] a5540cf breaks texinfo
2723
2724 This involved user-defined Unicode properties.
2725
2726 =item *
2727
2728 Fix error message for unclosed C<\N{> in regcomp.
2729
2730 An unclosed C<\N{> could give the wrong error message
2731 C<"\N{NAME} must be resolved by the lexer">.
2732
2733 =item *
2734
2735 List assignment in list context where the LHS contained aggregates and
2736 where there were not enough RHS elements, used to skip scalar lvalues.
2737 Previously, C<(($a,$b,@c,$d) = (1))> in list context returned C<($a)>; now
2738 it returns C<($a,$b,$d)>. C<(($a,$b,$c) = (1))> is unchanged: it still
2739 returns C<($a,$b,$c)>. This can be seen in the following:
2740
2741     sub inc { $_++ for @_ }
2742     inc(($a,$b,@c,$d) = (10))
2743
2744 Formerly, the values of C<($a,$b,$d)> would be left as C<(11,undef,undef)>;
2745 now they are C<(11,1,1)>.
2746
2747 =item *
2748
2749 [perl 129903]
2750
2751 The basic problem is that code like this: /(?{ s!!! })/ can trigger infinite
2752 recursion on the C stack (not the normal perl stack) when the last successful
2753 pattern in scope is itself. Since the C stack overflows this manifests as an
2754 untrappable error/segfault, which then kills perl.
2755
2756 We avoid the segfault by simply forbidding the use of the empty pattern when it
2757 would resolve to the currently executing pattern.
2758
2759 =item *
2760
2761 [perl 128997] Avoid reading beyond the end of the line buffer when there's a
2762 short UTF-8 character at the end.
2763
2764 =item *
2765
2766 [perl 129950] fix firstchar bitmap under utf8 with prefix optimisation.
2767
2768 =item *
2769
2770 [perl 129954] Carp/t/arg_string.t: be liberal in f/p formats.
2771
2772 =item *
2773
2774 [perl 129928] make do "a\0b" fail silently instead of throwing.
2775
2776 =item *
2777
2778 [perl 129130] make chdir allocate the stack it needs.
2779
2780 =back
2781
2782 =head1 Known Problems
2783
2784 =over 4
2785
2786 =item *
2787
2788 Some modules have been broken by the L<context stack rework|/Internal Changes>.
2789 These modules were relying on non-guaranteed implementation details in perl.
2790 Their maintainers have been informed, and should contact perl5-porters for
2791 advice if needed.  Below is a subset of these modules:
2792
2793 =over 4
2794
2795 =item * L<Algorithm::Permute>
2796
2797 =item * L<Coro>
2798
2799 L<Coro> and perl v5.22.0 were already incompatible due to a change in the perl,
2800 and the reworking on the perl context stack creates a further incompatibility.
2801 perl5-porters has L<discussed the issue on the mailing
2802 list|http://www.nntp.perl.org/group/perl.perl5.porters/2016/05/msg236174.html>.
2803
2804 =item * L<Data::Alias>
2805
2806 =item * L<RPerl>
2807
2808 =item * L<Scope::Upper>
2809
2810 =item * L<TryCatch>
2811
2812 =back
2813
2814 =item *
2815
2816 The module L<lexical::underscore> no longer works on perl v5.24.0, because perl
2817 no longer has a lexical C<$_>!
2818
2819 =item *
2820
2821 C<mod_perl> has been patched for compatibility for v5.22.0 and later but no
2822 release has been made.  The relevant patch (and other changes) can be found in
2823 their source code repository, L<mirrored at
2824 GitHub|https://github.com/apache/mod_perl/commit/82827132efd3c2e25cc413c85af61bb63375da6e>.
2825
2826 =back
2827
2828 =head1 Errata From Previous Releases
2829
2830 =over 4
2831
2832 =item *
2833
2834 Parsing bad POSIX charclasses no longer leaks memory.  This was fixed in Perl
2835 5.25.2
2836 L<[perl #128313]|https://rt.perl.org/Public/Bug/Display.html?id=128313>
2837
2838 =item *
2839
2840 Fixed issues with recursive regexes.  The behavior was fixed in Perl 5.24.0.
2841 L<[perl #126182]|https://rt.perl.org/Public/Bug/Display.html?id=126182>
2842
2843 =back
2844
2845 =head1 Obituary
2846
2847 Jon Portnoy (AVENJ), a prolific Perl author and admired Gentoo community
2848 member, has passed away on August 10, 2016. He will be remembered and
2849 missed by all those with which he came in contact and enriched with his
2850 intellect, wit, and spirit.
2851
2852 It is with great sadness we also note Kip Hampton's passing.. Probably
2853 best known as the author of the Perl & XML column on XML.com, he was a
2854 core contributor to AxKit, an XML server platform that became an Apache
2855 Foundation project. He was a frequent speaker in the early days at
2856 OSCON, and most recently at YAPC::NA in Madison. He was frequently on
2857 irc.perl.org as `ubu`, generally in the #axkit-dahut community, the
2858 group responsible for YAPC::NA Asheville in 2011.
2859
2860 Kip and his constant contributions to the community will be greatly
2861 missed.
2862
2863 =head1 Acknowledgements
2864
2865 Perl 5.26.0 represents approximately 12 months of development since Perl 5.24.0
2866 and contains approximately 370,000 lines of changes across 2,600 files from 86
2867 authors.
2868
2869 Excluding auto-generated files, documentation and release tools, there were
2870 approximately 230,000 lines of changes to 1,800 .pm, .t, .c and .h files.
2871
2872 Perl continues to flourish into its third decade thanks to a vibrant community
2873 of users and developers. The following people are known to have contributed the
2874 improvements that became Perl 5.24.1:
2875
2876 Aaron Crane, Abigail, Ævar Arnfjörð Bjarmason, Alex Vandiver, Andreas
2877 König, Andreas Voegele, Andrew Fresh, Andy Lester, Aristotle Pagaltzis, Chad
2878 Granum, Chase Whitener, Chris 'BinGOs' Williams, Chris Lamb, Christian Hansen,
2879 Christian Millour, Colin Newell, Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan
2880 Collins, Daniel Dragan, Dave Cross, Dave Rolsky, David Golden, David H.
2881 Gutteridge, David Mitchell, Dominic Hargreaves, Doug Bell, E. Choroba, Ed Avis,
2882 Father Chrysostomos, François Perrad, Hauke D, H.Merijn Brand, Hugo van der
2883 Sanden, Ivan Pozdeev, James E Keenan, James Raspass, Jarkko Hietaniemi, Jerry
2884 D. Hedden, Jim Cromie, J. Nick Koston, John Lightsey, Karen Etheridge, Karl
2885 Williamson, Leon Timmermans, Lukas Mai, Matthew Horsfall, Maxwell Carey, Misty
2886 De Meo, Neil Bowers, Nicholas Clark, Nicolas R., Niko Tyni, Pali, Paul
2887 Marquess, Peter Avalos, Petr Písař, Pino Toscano, Rafael Garcia-Suarez, Reini
2888 Urban, Renee Baecker, Ricardo Signes, Richard Levitte, Rick Delaney, Salvador
2889 Fandiño, Samuel Thibault, Sawyer X, Sébastien Aperghis-Tramoni, Sergey
2890 Aleynikov, Shlomi Fish, Smylers, Stefan Seifert, Steffen Müller, Stevan
2891 Little, Steve Hay, Steven Humphrey, Sullivan Beck, Theo Buehler, Thomas Sibley,
2892 Todd Rinaldo, Tomasz Konojacki, Tony Cook, Unicode Consortium, Yaroslav Kuzmin,
2893 Yves Orton, Zefram.
2894
2895 The list above is almost certainly incomplete as it is automatically generated
2896 from version control history. In particular, it does not include the names of
2897 the (very much appreciated) contributors who reported issues to the Perl bug
2898 tracker.
2899
2900 Many of the changes included in this version originated in the CPAN modules
2901 included in Perl's core. We're grateful to the entire CPAN community for
2902 helping Perl to flourish.
2903
2904 For a more complete list of all of Perl's historical contributors, please see
2905 the F<AUTHORS> file in the Perl source distribution.
2906
2907 =head1 Reporting Bugs
2908
2909 If you find what you think is a bug, you might check the articles recently
2910 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
2911 L<https://rt.perl.org/> .  There may also be information at
2912 L<http://www.perl.org/> , the Perl Home Page.
2913
2914 If you believe you have an unreported bug, please run the L<perlbug> program
2915 included with your release.  Be sure to trim your bug down to a tiny but
2916 sufficient test case.  Your bug report, along with the output of C<perl -V>,
2917 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
2918
2919 If the bug you are reporting has security implications which make it
2920 inappropriate to send to a publicly archived mailing list, then see
2921 L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
2922 for details of how to report the issue.
2923
2924 =head1 SEE ALSO
2925
2926 The F<Changes> file for an explanation of how to view exhaustive details on
2927 what changed.
2928
2929 The F<INSTALL> file for how to build Perl.
2930
2931 The F<README> file for general stuff.
2932
2933 The F<Artistic> and F<Copying> files for copyright information.
2934
2935 =cut