.\" -*- 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 2023-11-28 "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 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.