.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
.\}
.\" ========================================================================
.\"
.IX Title "PERL5256DELTA 1"
.TH PERL5256DELTA 1 "2017-05-20" "perl v5.26.0" "Perl Programmers Reference Guide"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
perl5256delta \- what is new for perl v5.25.6
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This document describes differences between the 5.25.5 release and the 5.25.6
release.
.PP
If you are upgrading from an earlier release such as 5.25.4, first read
perl5255delta, which describes differences between 5.25.4 and 5.25.5.
.SH "Performance Enhancements"
.IX Header "Performance Enhancements"
.IP "\(bu" 4
Converting a single-digit string to a number is now substantially faster.
.IP "\(bu" 4
The internal op implementing the \f(CW\*(C`split\*(C'\fR builtin has been simplified and
sped up. Firstly, it no longer requires a subsidiary internal \f(CW\*(C`pushre\*(C'\fR op
to do its work. Secondly, code of the form \f(CW\*(C`my @x = split(...)\*(C'\fR is now
optimised in the same way as \f(CW\*(C`@x = split(...)\*(C'\fR, and is therefore a few
percent faster.
.SH "Modules and Pragmata"
.IX Header "Modules and Pragmata"
.SS "Updated Modules and Pragmata"
.IX Subsection "Updated Modules and Pragmata"
.IP "\(bu" 4
Archive::Tar has been upgraded from version 2.10 to 2.14.
.IP "\(bu" 4
attributes has been upgraded from version 0.27 to 0.28.
.IP "\(bu" 4
B has been upgraded from version 1.63 to 1.64.
.IP "\(bu" 4
B::Concise has been upgraded from version 0.998 to 0.999.
.Sp
Its output is now more descriptive for \f(CW\*(C`op_private\*(C'\fR flags.
.IP "\(bu" 4
B::Deparse has been upgraded from version 1.38 to 1.39.
.IP "\(bu" 4
Data::Dumper has been upgraded from version 2.161 to 2.162.
.IP "\(bu" 4
Devel::Peek has been upgraded from version 1.24 to 1.25.
.IP "\(bu" 4
HTTP::Tiny has been upgraded from version 0.064 to 0.070.
.Sp
Internal 599\-series errors now include the redirect history.
.IP "\(bu" 4
List::Util has been upgraded from version 1.45_01 to 1.46.
.IP "\(bu" 4
Module::CoreList has been upgraded from version 5.20160920 to 5.20161020.
.IP "\(bu" 4
mro has been upgraded from version 1.18 to 1.19.
.IP "\(bu" 4
Net::Ping has been upgraded from version 2.44 to 2.51.
.Sp
IPv6 addresses and \f(CW\*(C`AF_INET6\*(C'\fR sockets are now supported, along with several
other enhancements.
.IP "\(bu" 4
Opcode has been upgraded from version 1.37 to 1.38.
.IP "\(bu" 4
overload has been upgraded from version 1.26 to 1.27.
.Sp
Its compilation speed has been improved slightly.
.IP "\(bu" 4
parent has been upgraded from version 0.234 to 0.236.
.IP "\(bu" 4
PerlIO::encoding has been upgraded from version 0.24 to 0.25.
.IP "\(bu" 4
podlators has been upgraded from version 4.07 to 4.08.
.IP "\(bu" 4
\&\s-1POSIX\s0 has been upgraded from version 1.72 to 1.73.
.IP "\(bu" 4
Scalar::Util has been upgraded from version 1.45_01 to 1.46.
.IP "\(bu" 4
Storable has been upgraded from version 2.57 to 2.58.
.IP "\(bu" 4
Test::Simple has been upgraded from version 1.302056 to 1.302059.
.IP "\(bu" 4
Time::HiRes has been upgraded from version 1.9739 to 1.9740_01.
.Sp
It now builds on systems with \*(C+11 compilers (such as G++ 6 and Clang++
3.9).
.IP "\(bu" 4
VMS::Stdio has been upgraded from version 2.41 to 2.42.
.SH "Diagnostics"
.IX Header "Diagnostics"
The following additions or changes have been made to diagnostic output,
including warnings and fatal error messages. For the complete list of
diagnostic messages, see perldiag.
.SS "New Diagnostics"
.IX Subsection "New Diagnostics"
\fINew Errors\fR
.IX Subsection "New Errors"
.IP "\(bu" 4
Using the empty pattern (which re-executes the last successfully-matched
pattern) inside a code block in another regex, as in \f(CW\*(C`/(?{ s!!new! })/\*(C'\fR, has
always previously yielded a segfault. It now produces an error: Use of the
empty pattern inside of a regex code block is forbidden.
.SS "Changes to Existing Diagnostics"
.IX Subsection "Changes to Existing Diagnostics"
.IP "\(bu" 4
Details as to the exact problem have been added to the diagnostics that
occur when malformed \s-1UTF\-8\s0 is encountered when trying to convert to a
code point.
.IP "\(bu" 4
Executing \f(CW\*(C`undef $x\*(C'\fR where \f(CW$x\fR is tied or magical no longer incorrectly
blames the variable for an uninitialized-value warning encountered by the
tied/magical code.
.SH "Configuration and Compilation"
.IX Header "Configuration and Compilation"
.IP "\(bu" 4
Builds using \f(CW\*(C`USE_PAD_RESET\*(C'\fR now work again; this configuration had
bit-rotted.
.SH "Testing"
.IX Header "Testing"
.IP "\(bu" 4
Some parts of the test suite that try to exhaustively test edge cases in the
regex implementation have been restricted to running for a maximum of five
minutes. On slow systems they could otherwise take several hours, without
significantly improving our understanding of the correctness of the code
under test.
.Sp
In addition, some of those test cases have been split into more files, to
allow them to be run in parallel on suitable systems.
.IP "\(bu" 4
A new internal facility allows analysing the time taken by the individual
tests in Perl's own test suite; see \fIPorting/harness\-timer\-report.pl\fR.
.SH "Platform Support"
.IX Header "Platform Support"
.SS "New Platforms"
.IX Subsection "New Platforms"
.IP "NetBSD/VAX" 4
.IX Item "NetBSD/VAX"
Perl now compiles under NetBSD on \s-1VAX\s0 machines. However, it's not
possible for that platform to implement floating-point infinities and
NaNs compatibly with most modern systems, which implement the \s-1IEEE\-754\s0
floating point standard. The hexadecimal floating point (\f(CW\*(C`0x...p[+\-]n\*(C'\fR
literals, \f(CW\*(C`printf %a\*(C'\fR) is not implemented, either.
The \f(CW\*(C`make test\*(C'\fR passes 98% of tests.
.SH "Internal Changes"
.IX Header "Internal Changes"
.IP "\(bu" 4
The \f(CW\*(C`PADOFFSET\*(C'\fR type has changed from being unsigned to signed, and
several pad-related variables such as \f(CW\*(C`PL_padix\*(C'\fR have changed from being
of type \f(CW\*(C`I32\*(C'\fR to type \f(CW\*(C`PADOFFSET\*(C'\fR.
.IP "\(bu" 4
The function \f(CW\*(C`"utf8n_to_uvchr" in perlapi\*(C'\fR has been changed to not
abandon searching for other malformations when the first one is
encountered. A call to it thus can generate multiple diagnostics,
instead of just one.
.IP "\(bu" 4
A new function, \f(CW\*(C`"utf8n_to_uvchr_error" in perlapi\*(C'\fR, has been added for
use by modules that need to know the details of \s-1UTF\-8\s0 malformations
beyond pass/fail. Previously, the only ways to know why a sequence was
ill-formed was to capture and parse the generated diagnostics, or to do
your own analysis.
.IP "\(bu" 4
Several new functions for handling Unicode have been added to the \s-1API:\s0
\&\f(CW\*(C`"is_strict_utf8_string" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_c9strict_utf8_string" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_utf8_string_flags" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_strict_utf8_string_loc" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_strict_utf8_string_loclen" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_c9strict_utf8_string_loc" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_c9strict_utf8_string_loclen" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_utf8_string_loc_flags" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_utf8_string_loclen_flags" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_utf8_fixed_width_buf_flags" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_utf8_fixed_width_buf_loc_flags" in perlapi\*(C'\fR,
\&\f(CW\*(C`"is_utf8_fixed_width_buf_loclen_flags" in perlapi\*(C'\fR.
.Sp
These functions are all extensions of the \f(CW\*(C`is_utf8_string_*()\*(C'\fR functions,
that apply various restrictions to the \s-1UTF\-8\s0 recognized as valid.
.IP "\(bu" 4
A new \s-1API\s0 function \f(CW\*(C`sv_setvpv_bufsize()\*(C'\fR allows simultaneously setting the
length and allocated size of the buffer in an \f(CW\*(C`SV\*(C'\fR, growing the buffer if
necessary.
.IP "\(bu" 4
A new \s-1API\s0 macro \f(CW\*(C`SvPVCLEAR()\*(C'\fR sets its \f(CW\*(C`SV\*(C'\fR argument to an empty string,
like Perl-space \f(CW\*(C`$x = \*(Aq\*(Aq\*(C'\fR, but with several optimisations.
.IP "\(bu" 4
All parts of the internals now agree that the \f(CW\*(C`sassign\*(C'\fR op is a \f(CW\*(C`BINOP\*(C'\fR;
previously it was listed as a \f(CW\*(C`BASEOP\*(C'\fR in \fIregen/opcodes\fR, which meant
that several parts of the internals had to be special-cased to accommodate
it. This oddity's original motivation was to handle code like \f(CW\*(C`$x ||= 1\*(C'\fR;
that is now handled in a simpler way.
.IP "\(bu" 4
Several new internal C macros have been added that take a string literal as
arguments, alongside existing routines that take the equivalent value as two
arguments, a character pointer and a length. The advantage of this is that
the length of the string is calculated automatically, rather than having to
be done manually. These routines are now used where appropriate across the
entire codebase.
.IP "\(bu" 4
The code in \fIgv.c\fR that determines whether a variable has a special meaning
to Perl has been simplified.
.IP "\(bu" 4
The \f(CW\*(C`DEBUGGING\*(C'\fR\-mode output for regex compilation and execution has been
enhanced.
.SH "Selected Bug Fixes"
.IX Header "Selected Bug Fixes"
.IP "\(bu" 4
A sub containing a \*(L"forward\*(R" declaration with the same name (e.g.,
\&\f(CW\*(C`sub c { sub c; }\*(C'\fR) could sometimes crash or loop infinitely. [perl
#129090]
.IP "\(bu" 4
A crash in executing a regex with a floating \s-1UTF\-8\s0 substring against a
target string that also used \s-1UTF\-8\s0 has been fixed. [perl #129350]
.IP "\(bu" 4
Previously, a shebang line like \f(CW\*(C`#!perl \-i u\*(C'\fR could be erroneously
interpreted as requesting the \f(CW\*(C`\-u\*(C'\fR option. This has been fixed. [perl
#129336]
.IP "\(bu" 4
The regex engine was previously producing incorrect results in some rare
situations when backtracking past a trie that matches only one thing; this
showed up as capture buffers (\f(CW$1\fR, \f(CW$2\fR, etc) erroneously containing data
from regex execution paths that weren't actually executed for the final
match. [perl #129897]
.IP "\(bu" 4
Certain regexes making use of the experimental \f(CW\*(C`regex_sets\*(C'\fR feature could
trigger an assertion failure. This has been fixed. [perl #129322]
.SH "Acknowledgements"
.IX Header "Acknowledgements"
Perl 5.25.6 represents approximately 4 weeks of development since Perl 5.25.5
and contains approximately 16,000 lines of changes across 300 files from 23
authors.
.PP
Excluding auto-generated files, documentation and release tools, there were
approximately 10,000 lines of changes to 190 .pm, .t, .c and .h files.
.PP
Perl continues to flourish into its third decade thanks to a vibrant community
of users and developers. The following people are known to have contributed the
improvements that became Perl 5.25.6:
.PP
Aaron Crane, Andy Lester, Chris 'BinGOs' Williams, Dagfinn Ilmari Mannsåker,
Dan Collins, David Mitchell, François Perrad, Hugo van der Sanden, James E
Keenan, James Raspass, Jarkko Hietaniemi, Karl Williamson, Lukas Mai, Nicolas
R., Reini Urban, Sawyer X, Sergey Aleynikov, Stevan Little, Steve Hay, Steven
Humphrey, Thomas Sibley, Tony Cook, Yves Orton.
.PP
The list above is almost certainly incomplete as it is automatically generated
from version control history. In particular, it does not include the names of
the (very much appreciated) contributors who reported issues to the Perl bug
tracker.
.PP
Many of the changes included in this version originated in the \s-1CPAN\s0 modules
included in Perl's core. We're grateful to the entire \s-1CPAN\s0 community for
helping Perl to flourish.
.PP
For a more complete list of all of Perl's historical contributors, please see
the \fI\s-1AUTHORS\s0\fR file in the Perl source distribution.
.SH "Reporting Bugs"
.IX Header "Reporting Bugs"
If you find what you think is a bug, you might check the perl bug database
at . There may also be information at
, the Perl Home Page.
.PP
If you believe you have an unreported bug, please run the perlbug program
included with your release. Be sure to trim your bug down to a tiny but
sufficient test case. Your bug report, along with the output of \f(CW\*(C`perl \-V\*(C'\fR,
will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
.PP
If the bug you are reporting has security implications which make it
inappropriate to send to a publicly archived mailing list, then see
\&\*(L"\s-1SECURITY VULNERABILITY CONTACT INFORMATION\*(R"\s0 in perlsec
for details of how to report the issue.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
The \fIChanges\fR file for an explanation of how to view exhaustive details on
what changed.
.PP
The \fI\s-1INSTALL\s0\fR file for how to build Perl.
.PP
The \fI\s-1README\s0\fR file for general stuff.
.PP
The \fIArtistic\fR and \fICopying\fR files for copyright information.