path: root/upstream/debian-unstable/man1/perl587delta.1

.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PERL587DELTA 1"
.TH PERL587DELTA 1 2024-01-12 "perl v5.38.2" "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
perl587delta \- what is new for perl v5.8.7
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This document describes differences between the 5.8.6 release and
the 5.8.7 release.
.SH "Incompatible Changes"
.IX Header "Incompatible Changes"
There are no changes incompatible with 5.8.6.
.SH "Core Enhancements"
.IX Header "Core Enhancements"
.SS "Unicode Character Database 4.1.0"
.IX Subsection "Unicode Character Database 4.1.0"
The copy of the Unicode Character Database included in Perl 5.8 has
been updated to 4.1.0 from 4.0.1. See
<http://www.unicode.org/versions/Unicode4.1.0/#NotableChanges> for the
notable changes.
.SS "suidperl less insecure"
.IX Subsection "suidperl less insecure"
A pair of exploits in \f(CW\*(C`suidperl\*(C'\fR involving debugging code have been closed.
.PP
For new projects the core perl team strongly recommends that you use
dedicated, single purpose security tools such as \f(CW\*(C`sudo\*(C'\fR in preference to
\&\f(CW\*(C`suidperl\*(C'\fR.
.SS "Optional site customization script"
.IX Subsection "Optional site customization script"
The perl interpreter can be built to allow the use of a site customization
script. By default this is not enabled, to be consistent with previous perl
releases. To use this, add \f(CW\*(C`\-Dusesitecustomize\*(C'\fR to the command line flags
when running the \f(CW\*(C`Configure\*(C'\fR script. See also "\-f" in perlrun.
.ie n .SS """Config.pm"" is now much smaller."
.el .SS "\f(CWConfig.pm\fP is now much smaller."
.IX Subsection "Config.pm is now much smaller."
\&\f(CW\*(C`Config.pm\*(C'\fR is now about 3K rather than 32K, with the infrequently used
code and \f(CW%Config\fR values loaded on demand. This is transparent to the
programmer, but means that most code will save parsing and loading 29K of
script (for example, code that uses \f(CW\*(C`File::Find\*(C'\fR).
.SH "Modules and Pragmata"
.IX Header "Modules and Pragmata"
.IP \(bu 4
B upgraded to version 1.09
.IP \(bu 4
base upgraded to version 2.07
.IP \(bu 4
bignum upgraded to version 0.17
.IP \(bu 4
bytes upgraded to version 1.02
.IP \(bu 4
Carp upgraded to version 1.04
.IP \(bu 4
CGI upgraded to version 3.10
.IP \(bu 4
Class::ISA upgraded to version 0.33
.IP \(bu 4
Data::Dumper upgraded to version 2.121_02
.IP \(bu 4
DB_File upgraded to version 1.811
.IP \(bu 4
Devel::PPPort upgraded to version 3.06
.IP \(bu 4
Digest upgraded to version 1.10
.IP \(bu 4
Encode upgraded to version 2.10
.IP \(bu 4
FileCache upgraded to version 1.05
.IP \(bu 4
File::Path upgraded to version 1.07
.IP \(bu 4
File::Temp upgraded to version 0.16
.IP \(bu 4
IO::File upgraded to version 1.11
.IP \(bu 4
IO::Socket upgraded to version 1.28
.IP \(bu 4
Math::BigInt upgraded to version 1.77
.IP \(bu 4
Math::BigRat upgraded to version 0.15
.IP \(bu 4
overload upgraded to version 1.03
.IP \(bu 4
PathTools upgraded to version 3.05
.IP \(bu 4
Pod::HTML upgraded to version 1.0503
.IP \(bu 4
Pod::Perldoc upgraded to version 3.14
.IP \(bu 4
Pod::LaTeX upgraded to version 0.58
.IP \(bu 4
Pod::Parser upgraded to version 1.30
.IP \(bu 4
Symbol upgraded to version 1.06
.IP \(bu 4
Term::ANSIColor upgraded to version 1.09
.IP \(bu 4
Test::Harness upgraded to version 2.48
.IP \(bu 4
Test::Simple upgraded to version 0.54
.IP \(bu 4
Text::Wrap upgraded to version 2001.09293, to fix a bug when \fBwrap()\fR was
called with a non-space separator.
.IP \(bu 4
threads::shared upgraded to version 0.93
.IP \(bu 4
Time::HiRes upgraded to version 1.66
.IP \(bu 4
Time::Local upgraded to version 1.11
.IP \(bu 4
Unicode::Normalize upgraded to version 0.32
.IP \(bu 4
utf8 upgraded to version 1.05
.IP \(bu 4
Win32 upgraded to version 0.24, which provides Win32::GetFileVersion
.SH "Utility Changes"
.IX Header "Utility Changes"
.SS "find2perl enhancements"
.IX Subsection "find2perl enhancements"
\&\f(CW\*(C`find2perl\*(C'\fR has new options \f(CW\*(C`\-iname\*(C'\fR, \f(CW\*(C`\-path\*(C'\fR and \f(CW\*(C`\-ipath\*(C'\fR.
.SH "Performance Enhancements"
.IX Header "Performance Enhancements"
The internal pointer mapping hash used during ithreads cloning now uses an
arena for memory allocation. In tests this reduced ithreads cloning time by
about 10%.
.SH "Installation and Configuration Improvements"
.IX Header "Installation and Configuration Improvements"
.IP \(bu 4
The Win32 "dmake" makefile.mk has been updated to make it compatible
with the latest versions of dmake.
.IP \(bu 4
\&\f(CW\*(C`PERL_MALLOC\*(C'\fR, \f(CW\*(C`DEBUG_MSTATS\*(C'\fR, \f(CW\*(C`PERL_HASH_SEED_EXPLICIT\*(C'\fR and \f(CW\*(C`NO_HASH_SEED\*(C'\fR
should now work in Win32 makefiles.
.SH "Selected Bug Fixes"
.IX Header "Selected Bug Fixes"
.IP \(bu 4
The \fBsocket()\fR function on Win32 has been fixed so that it is able to use
transport providers which specify a protocol of 0 (meaning any protocol
is allowed) once more.  (This was broken in 5.8.6, and typically caused
the use of ICMP sockets to fail.)
.IP \(bu 4
Another obscure bug involving \f(CW\*(C`substr\*(C'\fR and UTF\-8 caused by bad internal
offset caching has been identified and fixed.
.IP \(bu 4
A bug involving the loading of UTF\-8 tables by the regexp engine has been
fixed \- code such as \f(CW\*(C`"\ex{100}" =~ /[[:print:]]/\*(C'\fR will no longer give
corrupt results.
.IP \(bu 4
Case conversion operations such as \f(CW\*(C`uc\*(C'\fR on a long Unicode string could
exhaust memory. This has been fixed.
.IP \(bu 4
\&\f(CW\*(C`index\*(C'\fR/\f(CW\*(C`rindex\*(C'\fR were buggy for some combinations of Unicode and
non-Unicode data. This has been fixed.
.IP \(bu 4
\&\f(CW\*(C`read\*(C'\fR (and presumably \f(CW\*(C`sysread\*(C'\fR) would expose the UTF\-8 internals when
reading from a byte oriented file handle into a UTF\-8 scalar. This has
been fixed.
.IP \(bu 4
Several \f(CW\*(C`pack\*(C'\fR/\f(CW\*(C`unpack\*(C'\fR bug fixes:
.RS 4
.IP \(bu 4
Checksums with \f(CW\*(C`b\*(C'\fR or \f(CW\*(C`B\*(C'\fR formats were broken.
.IP \(bu 4
\&\f(CW\*(C`unpack\*(C'\fR checksums could overflow with the \f(CW\*(C`C\*(C'\fR format.
.IP \(bu 4
\&\f(CW\*(C`U0\*(C'\fR and \f(CW\*(C`C0\*(C'\fR are now scoped to \f(CW\*(C`()\*(C'\fR \f(CW\*(C`pack\*(C'\fR sub-templates.
.IP \(bu 4
Counted length prefixes now don't change \f(CW\*(C`C0\*(C'\fR/\f(CW\*(C`U0\*(C'\fR mode.
.IP \(bu 4
\&\f(CW\*(C`pack\*(C'\fR \f(CW\*(C`Z0\*(C'\fR used to destroy the preceding character.
.IP \(bu 4
\&\f(CW\*(C`P\*(C'\fR/\f(CW\*(C`p\*(C'\fR \f(CW\*(C`pack\*(C'\fR formats used to only recognise literal \f(CW\*(C`undef\*(C'\fR
.RE
.RS 4
.RE
.IP \(bu 4
Using closures with ithreads could cause perl to crash. This was due to
failure to correctly lock internal OP structures, and has been fixed.
.IP \(bu 4
The return value of \f(CW\*(C`close\*(C'\fR now correctly reflects any file errors that
occur while flushing the handle's data, instead of just giving failure if
the actual underlying file close operation failed.
.IP \(bu 4
\&\f(CW\*(C`not() || 1\*(C'\fR used to segfault. \f(CWnot()\fR now behaves like \f(CWnot(0)\fR, which was
the pre 5.6.0 behaviour.
.IP \(bu 4
\&\f(CW\*(C`h2ph\*(C'\fR has various enhancements to cope with constructs in header files that
used to result in incorrect or invalid output.
.SH "New or Changed Diagnostics"
.IX Header "New or Changed Diagnostics"
There is a new taint error, "%ENV is aliased to \f(CW%s\fR". This error is thrown
when taint checks are enabled and when \f(CW*ENV\fR has been aliased, so that
\&\f(CW%ENV\fR has no env-magic anymore and hence the environment cannot be verified
as taint-free.
.PP
The internals of \f(CW\*(C`pack\*(C'\fR and \f(CW\*(C`unpack\*(C'\fR have been updated. All legitimate
templates should work as before, but there may be some changes in the error
reported for complex failure cases. Any behaviour changes for non-error cases
are bugs, and should be reported.
.SH "Changed Internals"
.IX Header "Changed Internals"
There has been a fair amount of refactoring of the \f(CW\*(C`C\*(C'\fR source code, partly to
make it tidier and more maintainable. The resulting object code and the
\&\f(CW\*(C`perl\*(C'\fR binary may well be smaller than 5.8.6, and hopefully faster in some
cases, but apart from this there should be no user-detectable changes.
.PP
\&\f(CW\*(C`${^UTF8LOCALE}\*(C'\fR has been added to give perl space access to \f(CW\*(C`PL_utf8locale\*(C'\fR.
.PP
The size of the arenas used to allocate SV heads and most SV bodies can now
be changed at compile time. The old size was 1008 bytes, the new default size
is 4080 bytes.
.SH "Known Problems"
.IX Header "Known Problems"
Unicode strings returned from overloaded operators can be buggy. This is a
long standing bug reported since 5.8.6 was released, but we do not yet have
a suitable fix for it.
.SH "Platform Specific Problems"
.IX Header "Platform Specific Problems"
On UNICOS, lib/Math/BigInt/t/bigintc.t hangs burning CPU.
ext/B/t/bytecode.t and ext/Socket/t/socketpair.t both fail tests.
These are unlikely to be resolved, as our valiant UNICOS porter's last
Cray is being decommissioned.
.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://bugs.perl.org.  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.  You can browse and search
the Perl 5 bugs at http://bugs.perl.org/
.SH "SEE ALSO"
.IX Header "SEE ALSO"
The \fIChanges\fR file for exhaustive details on what changed.
.PP
The \fIINSTALL\fR file for how to build Perl.
.PP
The \fIREADME\fR file for general stuff.
.PP
The \fIArtistic\fR and \fICopying\fR files for copyright information.