.\" -*- 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 "PERL582DELTA 1p"
.TH PERL582DELTA 1p 2023-09-25 "perl v5.38.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
perl582delta \- what is new for perl v5.8.2
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This document describes differences between the 5.8.1 release and
the 5.8.2 release.
.PP
If you are upgrading from an earlier release such as 5.6.1, first read
the perl58delta, which describes differences between 5.6.0 and
5.8.0, and the perl581delta, which describes differences between
5.8.0 and 5.8.1.
.SH "Incompatible Changes"
.IX Header "Incompatible Changes"
For threaded builds for modules calling certain re-entrant system calls,
binary compatibility was accidentally lost between 5.8.0 and 5.8.1.
Binary compatibility with 5.8.0 has been restored in 5.8.2, which
necessitates breaking compatibility with 5.8.1. We see this as the
lesser of two evils.
.PP
This will only affect people who have a threaded perl 5.8.1, and compiled
modules which use these calls, and now attempt to run the compiled modules
with 5.8.2. The fix is to re-compile and re-install the modules using 5.8.2.
.SH "Core Enhancements"
.IX Header "Core Enhancements"
.SS "Hash Randomisation"
.IX Subsection "Hash Randomisation"
The hash randomisation introduced with 5.8.1 has been amended. It
transpired that although the implementation introduced in 5.8.1 was source
compatible with 5.8.0, it was not binary compatible in certain cases. 5.8.2
contains an improved implementation which is both source and binary
compatible with both 5.8.0 and 5.8.1, and remains robust against the form of
attack which prompted the change for 5.8.1.
.PP
We are grateful to the Debian project for their input in this area.
See "Algorithmic Complexity Attacks" in perlsec for the original
rationale behind this change.
.SS Threading
.IX Subsection "Threading"
Several memory leaks associated with variables shared between threads
have been fixed.
.SH "Modules and Pragmata"
.IX Header "Modules and Pragmata"
.SS "Updated Modules And Pragmata"
.IX Subsection "Updated Modules And Pragmata"
The following modules and pragmata have been updated since Perl 5.8.1:
.IP Devel::PPPort 4
.IX Item "Devel::PPPort"
.PD 0
.IP Digest::MD5 4
.IX Item "Digest::MD5"
.IP I18N::LangTags 4
.IX Item "I18N::LangTags"
.IP libnet 4
.IX Item "libnet"
.IP MIME::Base64 4
.IX Item "MIME::Base64"
.IP Pod::Perldoc 4
.IX Item "Pod::Perldoc"
.IP strict 4
.IX Item "strict"
.PD
Documentation improved
.IP Tie::Hash 4
.IX Item "Tie::Hash"
Documentation improved
.IP Time::HiRes 4
.IX Item "Time::HiRes"
.PD 0
.IP Unicode::Collate 4
.IX Item "Unicode::Collate"
.IP Unicode::Normalize 4
.IX Item "Unicode::Normalize"
.IP UNIVERSAL 4
.IX Item "UNIVERSAL"
.PD
Documentation improved
.SH "Selected Bug Fixes"
.IX Header "Selected Bug Fixes"
Some syntax errors involving unrecognized filetest operators are now handled
correctly by the parser.
.SH "Changed Internals"
.IX Header "Changed Internals"
Interpreter initialization is more complete when \-DMULTIPLICITY is off.
This should resolve problems with initializing and destroying the Perl
interpreter more than once in a single process.
.SH "Platform Specific Problems"
.IX Header "Platform Specific Problems"
Dynamic linker flags have been tweaked for Solaris and OS X, which should
solve problems seen while building some XS modules.
.PP
Bugs in OS/2 sockets and tmpfile have been fixed.
.PP
In OS X \f(CW\*(C`setreuid\*(C'\fR and friends are troublesome \- perl will now work
around their problems as best possible.
.SH "Future Directions"
.IX Header "Future Directions"
Starting with 5.8.3 we intend to make more frequent maintenance releases,
with a smaller number of changes in each. The intent is to propagate
bug fixes out to stable releases more rapidly and make upgrading stable
releases less of an upheaval. This should give end users more
flexibility in their choice of upgrade timing, and allow them easier
assessment of the impact of upgrades. The current plan is for code freezes
as follows
.IP \(bu 4
5.8.3 23:59:59 GMT, Wednesday December 31st 2003
.IP \(bu 4
5.8.4 23:59:59 GMT, Wednesday March 31st 2004
.IP \(bu 4
5.8.5 23:59:59 GMT, Wednesday June 30th 2004
.PP
with the release following soon after, when testing is complete.
.PP
See "Future Directions" in perl581delta for more soothsaying.
.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.com/, 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.
