.\" 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
.    \}
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "PERL5122DELTA 1"
.TH PERL5122DELTA 1 "2018-03-01" "perl v5.26.3" "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"
perl5122delta \- what is new for perl v5.12.2
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This document describes differences between the 5.12.1 release and
the 5.12.2 release.
.PP
If you are upgrading from an earlier major version, such as 5.10.1,
first read perl5120delta, which describes differences between 5.10.1
and 5.12.0, as well as perl5121delta, which describes earlier changes
in the 5.12 stable release series.
.SH "Incompatible Changes"
.IX Header "Incompatible Changes"
There are no changes intentionally incompatible with 5.12.1. If any exist, they
are bugs and reports are welcome.
.SH "Core Enhancements"
.IX Header "Core Enhancements"
Other than the bug fixes listed below, there should be no user-visible
changes to the core language in this release.
.SH "Modules and Pragmata"
.IX Header "Modules and Pragmata"
.SS "New Modules and Pragmata"
.IX Subsection "New Modules and Pragmata"
This release does not introduce any new modules or pragmata.
.SS "Pragmata Changes"
.IX Subsection "Pragmata Changes"
In the previous release, \f(CW\*(C`no \f(CIVERSION\f(CW;\*(C'\fR statements triggered a bug
which could cause feature bundles to be loaded and strict mode to
be enabled unintentionally.
.SS "Updated Modules"
.IX Subsection "Updated Modules"
.ie n .IP """Carp""" 4
.el .IP "\f(CWCarp\fR" 4
.IX Item "Carp"
Upgraded from version 1.16 to 1.17.
.Sp
Carp now detects incomplete \fIcaller()\fR
overrides and avoids using bogus \f(CW@DB::args\fR. To provide backtraces, Carp
relies on particular behaviour of the caller built-in. Carp now detects
if other code has overridden this with an incomplete implementation, and
modifies its backtrace accordingly. Previously incomplete overrides would
cause incorrect values in backtraces (best case), or obscure fatal errors
(worst case)
.Sp
This fixes certain cases of \f(CW\*(C`Bizarre copy of ARRAY\*(C'\fR caused by modules
overriding \f(CW\*(C`caller()\*(C'\fR incorrectly.
.ie n .IP """CPANPLUS""" 4
.el .IP "\f(CWCPANPLUS\fR" 4
.IX Item "CPANPLUS"
A patch to \fIcpanp-run-perl\fR has been backported from \s-1CPANPLUS\s0 \f(CW0.9004\fR. This
resolves \s-1RT\s0 #55964 <http://rt.cpan.org/Public/Bug/Display.html?id=55964>
and \s-1RT\s0 #57106 <http://rt.cpan.org/Public/Bug/Display.html?id=57106>, both
of which related to failures to install distributions that use
\&\f(CW\*(C`Module::Install::DSL\*(C'\fR.
.ie n .IP """File::Glob""" 4
.el .IP "\f(CWFile::Glob\fR" 4
.IX Item "File::Glob"
A regression which caused a failure to find \f(CW\*(C`CORE::GLOBAL::glob\*(C'\fR after
loading \f(CW\*(C`File::Glob\*(C'\fR to crash has been fixed.  Now, it correctly falls back
to external globbing via \f(CW\*(C`pp_glob\*(C'\fR.
.ie n .IP """File::Copy""" 4
.el .IP "\f(CWFile::Copy\fR" 4
.IX Item "File::Copy"
\&\f(CW\*(C`File::Copy::copy(FILE, DIR)\*(C'\fR is now documented.
.ie n .IP """File::Spec""" 4
.el .IP "\f(CWFile::Spec\fR" 4
.IX Item "File::Spec"
Upgraded from version 3.31 to 3.31_01.
.Sp
Several portability fixes were made in \f(CW\*(C`File::Spec::VMS\*(C'\fR: a colon is now
recognized as a delimiter in native filespecs; caret-escaped delimiters are
recognized for better handling of extended filespecs; \f(CW\*(C`catpath()\*(C'\fR returns
an empty directory rather than the current directory if the input directory
name is empty; \f(CW\*(C`abs2rel()\*(C'\fR properly handles Unix-style input.
.SH "Utility Changes"
.IX Header "Utility Changes"
.IP "\(bu" 4
\&\fIperlbug\fR now always gives the reporter a chance to change the email address it
guesses for them.
.IP "\(bu" 4
\&\fIperlbug\fR should no longer warn about uninitialized values when using the \f(CW\*(C`\-d\*(C'\fR
and \f(CW\*(C`\-v\*(C'\fR options.
.SH "Changes to Existing Documentation"
.IX Header "Changes to Existing Documentation"
.IP "\(bu" 4
The existing policy on backward-compatibility and deprecation has
been added to perlpolicy, along with definitions of terms like
\&\fIdeprecation\fR.
.IP "\(bu" 4
\&\*(L"srand\*(R" in perlfunc's usage has been clarified.
.IP "\(bu" 4
The entry for \*(L"die\*(R" in perlfunc was reorganized to emphasize its
role in the exception mechanism.
.IP "\(bu" 4
Perl's \s-1INSTALL\s0 file has been clarified to explicitly state that Perl
requires a C89 compliant \s-1ANSI C\s0 Compiler.
.IP "\(bu" 4
IO::Socket's \f(CW\*(C`getsockopt()\*(C'\fR and \f(CW\*(C`setsockopt()\*(C'\fR have been documented.
.IP "\(bu" 4
\&\fI\fIalarm()\fI\fR's inability to interrupt blocking \s-1IO\s0 on Windows has been documented.
.IP "\(bu" 4
Math::TrulyRandom hasn't been updated since 1996 and has been removed
as a recommended solution for random number generation.
.IP "\(bu" 4
perlrun has been updated to clarify the behaviour of octal flags to \fIperl\fR.
.IP "\(bu" 4
To ease user confusion, \f(CW$#\fR and \f(CW$*\fR, two special variables that were
removed in earlier versions of Perl have been documented.
.IP "\(bu" 4
The version of perlfaq shipped with the Perl core has been updated from the
official \s-1FAQ\s0 version, which is now maintained in the \f(CW\*(C`briandfoy/perlfaq\*(C'\fR
branch of the Perl repository at <git://perl5.git.perl.org/perl.git>.
.SH "Installation and Configuration Improvements"
.IX Header "Installation and Configuration Improvements"
.SS "Configuration improvements"
.IX Subsection "Configuration improvements"
.IP "\(bu" 4
The \f(CW\*(C`d_u32align\*(C'\fR configuration probe on \s-1ARM\s0 has been fixed.
.SS "Compilation improvements"
.IX Subsection "Compilation improvements"
.IP "\(bu" 4
An "\f(CW\*(C`incompatible operand types\*(C'\fR" error in ternary expressions when building
with \f(CW\*(C`clang\*(C'\fR has been fixed.
.IP "\(bu" 4
Perl now skips setuid \f(CW\*(C`File::Copy\*(C'\fR tests on partitions it detects to be mounted
as \f(CW\*(C`nosuid\*(C'\fR.
.SH "Selected Bug Fixes"
.IX Header "Selected Bug Fixes"
.IP "\(bu" 4
A possible segfault in the \f(CW\*(C`T_PRTOBJ\*(C'\fR default typemap has been fixed.
.IP "\(bu" 4
A possible memory leak when using \fIcaller()\fR to set
\&\f(CW@DB::args\fR has been fixed.
.IP "\(bu" 4
Several memory leaks when loading \s-1XS\s0 modules were fixed.
.IP "\(bu" 4
\&\f(CW\*(C`unpack()\*(C'\fR now handles scalar context correctly for \f(CW%32H\fR and \f(CW%32u\fR,
fixing a potential crash.  \f(CW\*(C`split()\*(C'\fR would crash because the third item
on the stack wasn't the regular expression it expected.  \f(CW\*(C`unpack("%2H",
\&...)\*(C'\fR would return both the unpacked result and the checksum on the stack,
as would \f(CW\*(C`unpack("%2u", ...)\*(C'\fR.
[perl #73814] <http://rt.perl.org/rt3/Ticket/Display.html?id=73814>
.IP "\(bu" 4
Perl now avoids using memory after calling \f(CW\*(C`free()\*(C'\fR in \fIpp_require\fR
when there are CODEREFs in \f(CW@INC\fR.
.IP "\(bu" 4
A bug that could cause "\f(CW\*(C`Unknown error\*(C'\fR\*(L" messages when
\&\*(R"\f(CW\*(C`call_sv(code, G_EVAL)\*(C'\fR" is called from an \s-1XS\s0 destructor has been fixed.
.IP "\(bu" 4
The implementation of the \f(CW\*(C`open $fh, \*(Aq>\*(Aq \e$buffer\*(C'\fR feature
now supports get/set magic and thus tied buffers correctly.
.IP "\(bu" 4
The \f(CW\*(C`pp_getc\*(C'\fR, \f(CW\*(C`pp_tell\*(C'\fR, and \f(CW\*(C`pp_eof\*(C'\fR opcodes now make room on the
stack for their return values in cases where no argument was passed in.
.IP "\(bu" 4
When matching unicode strings under some conditions inappropriate backtracking would
result in a \f(CW\*(C`Malformed UTF\-8 character (fatal)\*(C'\fR error. This should no longer occur.
See  [perl #75680] <http://rt.perl.org/rt3/Public/Bug/Display.html?id=75680>
.SH "Platform Specific Notes"
.IX Header "Platform Specific Notes"
.SS "\s-1AIX\s0"
.IX Subsection "AIX"
.IP "\(bu" 4
\&\fI\s-1README\s0.aix\fR has been updated with information about the \s-1XL C/\*(C+ V11\s0 compiler
suite.
.SS "Windows"
.IX Subsection "Windows"
.IP "\(bu" 4
When building Perl with the mingw64 x64 cross-compiler \f(CW\*(C`incpath\*(C'\fR,
\&\f(CW\*(C`libpth\*(C'\fR, \f(CW\*(C`ldflags\*(C'\fR, \f(CW\*(C`lddlflags\*(C'\fR and \f(CW\*(C`ldflags_nolargefiles\*(C'\fR values
in \fIConfig.pm\fR and \fIConfig_heavy.pl\fR were not previously being set
correctly because, with that compiler, the include and lib directories
are not immediately below \f(CW\*(C`$(CCHOME)\*(C'\fR.
.SS "\s-1VMS\s0"
.IX Subsection "VMS"
.IP "\(bu" 4
\&\fIgit_version.h\fR is now installed on \s-1VMS.\s0 This was an oversight in v5.12.0 which
caused some extensions to fail to build.
.IP "\(bu" 4
Several memory leaks in \fIstat()\fR have been fixed.
.IP "\(bu" 4
A memory leak in \f(CW\*(C`Perl_rename()\*(C'\fR due to a double allocation has been
fixed.
.IP "\(bu" 4
A memory leak in \f(CW\*(C`vms_fid_to_name()\*(C'\fR (used by \f(CW\*(C`realpath()\*(C'\fR and
\&\f(CW\*(C`realname()\*(C'\fR) has been fixed.
.SH "Acknowledgements"
.IX Header "Acknowledgements"
Perl 5.12.2 represents approximately three months of development since
Perl 5.12.1 and contains approximately 2,000 lines of changes across
100 files from 36 authors.
.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.12.2:
.PP
Abigail, \*(Aevar Arnfjo\*:r\*(d- Bjarmason, Ben Morrow, brian d foy, Brian
Phillips, Chas. Owens, Chris 'BinGOs' Williams, Chris Williams,
Craig A. Berry, Curtis Jewell, Dan Dascalescu, David Golden, David
Mitchell, Father Chrysostomos, Florian Ragwitz, George Greer, H.Merijn
Brand, Jan Dubois, Jesse Vincent, Jim Cromie, Karl Williamson, Lars
\&\s-1DXXXXXX XXX,\s0 Leon Brocard, Maik Hentsche, Matt S Trout,
Nicholas Clark, Rafael Garcia-Suarez, Rainer Tammer, Ricardo Signes,
Salvador Ortiz Garcia, Sisyphus, Slaven Rezic, Steffen Mueller, Tony Cook,
Vincent Pit and Yves Orton.
.SH "Reporting Bugs"
.IX Header "Reporting Bugs"
If you find what you think is a bug, you might check the articles
recently posted to the comp.lang.perl.misc newsgroup and the perl
bug database at http://rt.perl.org/perlbug/ .  There may also be
information at http://www.perl.org/ , the Perl Home Page.
.PP
If you believe you have an unreported bug, please run the \fBperlbug\fR
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 please send
it to perl5\-security\-report@perl.org. This points to a closed subscription
unarchived mailing list, which includes
all the core committers, who will be able
to help assess the impact of issues, figure out a resolution, and help
co-ordinate the release of patches to mitigate or fix the problem across all
platforms on which Perl is supported. Please only use this address for
security issues in the Perl core, not for modules independently
distributed on \s-1CPAN.\s0
.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.
