summaryrefslogtreecommitdiffstats
path: root/upstream/debian-bookworm/man1/perl582delta.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-bookworm/man1/perl582delta.1')
-rw-r--r--upstream/debian-bookworm/man1/perl582delta.1213
1 files changed, 213 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/perl582delta.1 b/upstream/debian-bookworm/man1/perl582delta.1
new file mode 100644
index 00000000..e3a3fc5b
--- /dev/null
+++ b/upstream/debian-bookworm/man1/perl582delta.1
@@ -0,0 +1,213 @@
+.\" Automatically generated by Pod::Man 4.14 (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
+..
+.\" 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
+..
+.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 "2023-11-25" "perl v5.36.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 \*(L"Algorithmic Complexity Attacks\*(R" 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 "\s-1UNIVERSAL\s0" 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 \s-1OS X,\s0 which should
+solve problems seen while building some \s-1XS\s0 modules.
+.PP
+Bugs in \s-1OS/2\s0 sockets and tmpfile have been fixed.
+.PP
+In \s-1OS X\s0 \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 \s-1GMT,\s0 Wednesday December 31st 2003
+.IP "\(bu" 4
+5.8.4 23:59:59 \s-1GMT,\s0 Wednesday March 31st 2004
+.IP "\(bu" 4
+5.8.5 23:59:59 \s-1GMT,\s0 Wednesday June 30th 2004
+.PP
+with the release following soon after, when testing is complete.
+.PP
+See \*(L"Future Directions\*(R" 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 \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.