summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man1/perl582delta.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-unstable/man1/perl582delta.1')
-rw-r--r--upstream/debian-unstable/man1/perl582delta.1197
1 files changed, 197 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/perl582delta.1 b/upstream/debian-unstable/man1/perl582delta.1
new file mode 100644
index 00000000..1ccd8bc5
--- /dev/null
+++ b/upstream/debian-unstable/man1/perl582delta.1
@@ -0,0 +1,197 @@
+.\" -*- 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 1"
+.TH PERL582DELTA 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
+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.