Debian Codegraph @

upstream/debian-unstable/man1/perl582delta.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "PERL582DELTA 1"
58 .TH PERL582DELTA 1 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 perl582delta \- what is new for perl v5.8.2
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.8.1 release and
68 the 5.8.2 release.
69 .PP
70 If you are upgrading from an earlier release such as 5.6.1, first read
71 the perl58delta, which describes differences between 5.6.0 and
72 5.8.0, and the perl581delta, which describes differences between
73 5.8.0 and 5.8.1.
74 .SH "Incompatible Changes"
75 .IX Header "Incompatible Changes"
76 For threaded builds for modules calling certain re-entrant system calls,
77 binary compatibility was accidentally lost between 5.8.0 and 5.8.1.
78 Binary compatibility with 5.8.0 has been restored in 5.8.2, which
79 necessitates breaking compatibility with 5.8.1. We see this as the
80 lesser of two evils.
81 .PP
82 This will only affect people who have a threaded perl 5.8.1, and compiled
83 modules which use these calls, and now attempt to run the compiled modules
84 with 5.8.2. The fix is to re-compile and re-install the modules using 5.8.2.
85 .SH "Core Enhancements"
86 .IX Header "Core Enhancements"
87 .SS "Hash Randomisation"
88 .IX Subsection "Hash Randomisation"
89 The hash randomisation introduced with 5.8.1 has been amended. It
90 transpired that although the implementation introduced in 5.8.1 was source
91 compatible with 5.8.0, it was not binary compatible in certain cases. 5.8.2
92 contains an improved implementation which is both source and binary
93 compatible with both 5.8.0 and 5.8.1, and remains robust against the form of
94 attack which prompted the change for 5.8.1.
95 .PP
96 We are grateful to the Debian project for their input in this area.
97 See "Algorithmic Complexity Attacks" in perlsec for the original
98 rationale behind this change.
99 .SS Threading
100 .IX Subsection "Threading"
101 Several memory leaks associated with variables shared between threads
102 have been fixed.
103 .SH "Modules and Pragmata"
104 .IX Header "Modules and Pragmata"
105 .SS "Updated Modules And Pragmata"
106 .IX Subsection "Updated Modules And Pragmata"
107 The following modules and pragmata have been updated since Perl 5.8.1:
108 .IP Devel::PPPort 4
109 .IX Item "Devel::PPPort"
110 .PD 0
111 .IP Digest::MD5 4
112 .IX Item "Digest::MD5"
113 .IP I18N::LangTags 4
114 .IX Item "I18N::LangTags"
115 .IP libnet 4
116 .IX Item "libnet"
117 .IP MIME::Base64 4
118 .IX Item "MIME::Base64"
119 .IP Pod::Perldoc 4
120 .IX Item "Pod::Perldoc"
121 .IP strict 4
122 .IX Item "strict"
123 .PD
124 Documentation improved
125 .IP Tie::Hash 4
126 .IX Item "Tie::Hash"
127 Documentation improved
128 .IP Time::HiRes 4
129 .IX Item "Time::HiRes"
130 .PD 0
131 .IP Unicode::Collate 4
132 .IX Item "Unicode::Collate"
133 .IP Unicode::Normalize 4
134 .IX Item "Unicode::Normalize"
135 .IP UNIVERSAL 4
136 .IX Item "UNIVERSAL"
137 .PD
138 Documentation improved
139 .SH "Selected Bug Fixes"
140 .IX Header "Selected Bug Fixes"
141 Some syntax errors involving unrecognized filetest operators are now handled
142 correctly by the parser.
143 .SH "Changed Internals"
144 .IX Header "Changed Internals"
145 Interpreter initialization is more complete when \-DMULTIPLICITY is off.
146 This should resolve problems with initializing and destroying the Perl
147 interpreter more than once in a single process.
148 .SH "Platform Specific Problems"
149 .IX Header "Platform Specific Problems"
150 Dynamic linker flags have been tweaked for Solaris and OS X, which should
151 solve problems seen while building some XS modules.
152 .PP
153 Bugs in OS/2 sockets and tmpfile have been fixed.
154 .PP
155 In OS X \f(CW\*(C`setreuid\*(C'\fR and friends are troublesome \- perl will now work
156 around their problems as best possible.
157 .SH "Future Directions"
158 .IX Header "Future Directions"
159 Starting with 5.8.3 we intend to make more frequent maintenance releases,
160 with a smaller number of changes in each. The intent is to propagate
161 bug fixes out to stable releases more rapidly and make upgrading stable
162 releases less of an upheaval. This should give end users more
163 flexibility in their choice of upgrade timing, and allow them easier
164 assessment of the impact of upgrades. The current plan is for code freezes
165 as follows
166 .IP \(bu 4
167 5.8.3 23:59:59 GMT, Wednesday December 31st 2003
168 .IP \(bu 4
169 5.8.4 23:59:59 GMT, Wednesday March 31st 2004
170 .IP \(bu 4
171 5.8.5 23:59:59 GMT, Wednesday June 30th 2004
172 .PP
173 with the release following soon after, when testing is complete.
174 .PP
175 See "Future Directions" in perl581delta for more soothsaying.
176 .SH "Reporting Bugs"
177 .IX Header "Reporting Bugs"
178 If you find what you think is a bug, you might check the articles
179 recently posted to the comp.lang.perl.misc newsgroup and the perl
180 bug database at http://bugs.perl.org/. There may also be
181 information at http://www.perl.com/, the Perl Home Page.
182 .PP
183 If you believe you have an unreported bug, please run the \fBperlbug\fR
184 program included with your release. Be sure to trim your bug down
185 to a tiny but sufficient test case. Your bug report, along with the
186 output of \f(CW\*(C`perl \-V\*(C'\fR, will be sent off to [email protected] to be
187 analysed by the Perl porting team. You can browse and search
188 the Perl 5 bugs at http://bugs.perl.org/
189 .SH "SEE ALSO"
190 .IX Header "SEE ALSO"
191 The \fIChanges\fR file for exhaustive details on what changed.
192 .PP
193 The \fIINSTALL\fR file for how to build Perl.
194 .PP
195 The \fIREADME\fR file for general stuff.
196 .PP
197 The \fIArtistic\fR and \fICopying\fR files for copyright information.