Debian Codegraph @

upstream/debian-unstable/man1/perl5202delta.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 "PERL5202DELTA 1"
58 .TH PERL5202DELTA 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 perl5202delta \- what is new for perl v5.20.2
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.20.1 release and the 5.20.2
68 release.
69 .PP
70 If you are upgrading from an earlier release such as 5.20.0, first read
71 perl5201delta, which describes differences between 5.20.0 and 5.20.1.
72 .SH "Incompatible Changes"
73 .IX Header "Incompatible Changes"
74 There are no changes intentionally incompatible with 5.20.1. If any exist,
75 they are bugs, and we request that you submit a report. See "Reporting Bugs"
76 below.
77 .SH "Modules and Pragmata"
78 .IX Header "Modules and Pragmata"
79 .SS "Updated Modules and Pragmata"
80 .IX Subsection "Updated Modules and Pragmata"
81 .IP \(bu 4
82 attributes has been upgraded from version 0.22 to 0.23.
83 .Sp
84 The usage of \f(CW\*(C`memEQs\*(C'\fR in the XS has been corrected.
85 [GH #14072] <https://github.com/Perl/perl5/issues/14072>
86 .IP \(bu 4
87 Data::Dumper has been upgraded from version 2.151 to 2.151_01.
88 .Sp
89 Fixes CVE\-2014\-4330 by adding a configuration variable/option to limit
90 recursion when dumping deep data structures.
91 .IP \(bu 4
92 Errno has been upgraded from version 1.20_03 to 1.20_05.
93 .Sp
94 Warnings when building the XS on Windows with the Visual C++ compiler are now
95 avoided.
96 .IP \(bu 4
97 feature has been upgraded from version 1.36 to 1.36_01.
98 .Sp
99 The \f(CW\*(C`postderef\*(C'\fR feature has now been documented. This feature was actually
100 added in Perl 5.20.0 but was accidentally omitted from the feature
101 documentation until now.
102 .IP \(bu 4
103 IO::Socket has been upgraded from version 1.37 to 1.38.
104 .Sp
105 Document the limitations of the \fBconnected()\fR method.
106 [GH #14199] <https://github.com/Perl/perl5/issues/14199>
107 .IP \(bu 4
108 Module::CoreList has been upgraded from version 5.020001 to 5.20150214.
109 .Sp
110 The list of Perl versions covered has been updated.
111 .IP \(bu 4
112 PathTools has been upgraded from version 3.48 to 3.48_01.
113 .Sp
114 A warning from the \fBgcc\fR compiler is now avoided when building the XS.
115 .IP \(bu 4
116 PerlIO::scalar has been upgraded from version 0.18 to 0.18_01.
117 .Sp
118 Reading from a position well past the end of the scalar now correctly returns
119 end of file.
120 [GH #14342] <https://github.com/Perl/perl5/issues/14342>
121 .Sp
122 Seeking to a negative position still fails, but no longer leaves the file
123 position set to a negation location.
124 .Sp
125 \&\f(CWeof()\fR on a \f(CW\*(C`PerlIO::scalar\*(C'\fR handle now properly returns true when the file
126 position is past the 2GB mark on 32\-bit systems.
127 .IP \(bu 4
128 Storable has been upgraded from version 2.49 to 2.49_01.
129 .Sp
130 Minor grammatical change to the documentation only.
131 .IP \(bu 4
132 VMS::DCLsym has been upgraded from version 1.05 to 1.05_01.
133 .Sp
134 Minor formatting change to the documentation only.
135 .IP \(bu 4
136 VMS::Stdio has been upgraded from version 2.4 to 2.41.
137 .Sp
138 Minor formatting change to the documentation only.
139 .SH Documentation
140 .IX Header "Documentation"
141 .SS "New Documentation"
142 .IX Subsection "New Documentation"
143 \fIperlunicook\fR
144 .IX Subsection "perlunicook"
145 .PP
146 This document, by Tom Christiansen, provides examples of handling Unicode in
147 Perl.
148 .SS "Changes to Existing Documentation"
149 .IX Subsection "Changes to Existing Documentation"
150 \fIperlexperiment\fR
151 .IX Subsection "perlexperiment"
152 .IP \(bu 4
153 Added reference to subroutine signatures. This feature was actually added in
154 Perl 5.20.0 but was accidentally omitted from the experimental feature
155 documentation until now.
156 .PP
157 \fIperlpolicy\fR
158 .IX Subsection "perlpolicy"
159 .IP \(bu 4
160 The process whereby features may graduate from experimental status has now been
161 formally documented.
162 .PP
163 \fIperlsyn\fR
164 .IX Subsection "perlsyn"
165 .IP \(bu 4
166 An ambiguity in the documentation of the ellipsis statement has been corrected.
167 [GH #14054] <https://github.com/Perl/perl5/issues/14054>
168 .SH Diagnostics
169 .IX Header "Diagnostics"
170 The following additions or changes have been made to diagnostic output,
171 including warnings and fatal error messages. For the complete list of
172 diagnostic messages, see perldiag.
173 .SS "Changes to Existing Diagnostics"
174 .IX Subsection "Changes to Existing Diagnostics"
175 .IP \(bu 4
176 Bad symbol for scalar is now documented.
177 This error is not new, but was not previously documented here.
178 .IP \(bu 4
179 Missing right brace on \eN{} is now
180 documented. This error is not new, but was not previously documented here.
181 .SH Testing
182 .IX Header "Testing"
183 .IP \(bu 4
184 The test script \fIre/rt122747.t\fR has been added to verify that
185 [GH #14081] <https://github.com/Perl/perl5/issues/14081> remains
186 fixed.
187 .SH "Platform Support"
188 .IX Header "Platform Support"
189 .SS "Regained Platforms"
190 .IX Subsection "Regained Platforms"
191 IRIX and Tru64 platforms are working again. (Some \f(CW\*(C`make test\*(C'\fR failures
192 remain.)
193 .SH "Selected Bug Fixes"
194 .IX Header "Selected Bug Fixes"
195 .IP \(bu 4
196 AIX now sets the length in \f(CW\*(C`getsockopt\*(C'\fR correctly.
197 [GH #13484] <https://github.com/Perl/perl5/issues/13484>,
198 [cpan #91183] <https://rt.cpan.org/Ticket/Display.html?id=91183>,
199 [cpan #85570] <https://rt.cpan.org/Ticket/Display.html?id=85570>
200 .IP \(bu 4
201 In Perl 5.20.0, \f(CW$^N\fR accidentally had the internal UTF8 flag turned off if
202 accessed from a code block within a regular expression, effectively
203 UTF8\-encoding the value. This has been fixed.
204 [GH #14211] <https://github.com/Perl/perl5/issues/14211>
205 .IP \(bu 4
206 Various cases where the name of a sub is used (autoload, overloading, error
207 messages) used to crash for lexical subs, but have been fixed.
208 .IP \(bu 4
209 An assertion failure when parsing \f(CW\*(C`sort\*(C'\fR with debugging enabled has been
210 fixed.
211 [GH #14087] <https://github.com/Perl/perl5/issues/14087>
212 .IP \(bu 4
213 Loading UTF8 tables during a regular expression match could cause assertion
214 failures under debugging builds if the previous match used the very same
215 regular expression.
216 [GH #14081] <https://github.com/Perl/perl5/issues/14081>
217 .IP \(bu 4
218 Due to a mistake in the string-copying logic, copying the value of a state
219 variable could instead steal the value and undefine the variable. This bug,
220 introduced in Perl 5.20, would happen mostly for long strings (1250 chars or
221 more), but could happen for any strings under builds with copy-on-write
222 disabled.
223 [GH #14175] <https://github.com/Perl/perl5/issues/14175>
224 .IP \(bu 4
225 Fixed a bug that could cause perl to execute an infinite loop during
226 compilation.
227 [GH #14165] <https://github.com/Perl/perl5/issues/14165>
228 .IP \(bu 4
229 On Win32, restoring in a child pseudo-process a variable that was \f(CWlocal()\fRed
230 in a parent pseudo-process before the \f(CW\*(C`fork\*(C'\fR happened caused memory corruption
231 and a crash in the child pseudo-process (and therefore OS process).
232 [GH #8641] <https://github.com/Perl/perl5/issues/8641>
233 .IP \(bu 4
234 Tainted constants evaluated at compile time no longer cause unrelated
235 statements to become tainted.
236 [GH #14059] <https://github.com/Perl/perl5/issues/14059>
237 .IP \(bu 4
238 Calling \f(CW\*(C`write\*(C'\fR on a format with a \f(CW\*(C`^**\*(C'\fR field could produce a panic in
239 \&\fBsv_chop()\fR if there were insufficient arguments or if the variable used to fill
240 the field was empty.
241 [GH #14255] <https://github.com/Perl/perl5/issues/14255>
242 .IP \(bu 4
243 In Perl 5.20.0, \f(CW\*(C`sort CORE::fake\*(C'\fR where 'fake' is anything other than a
244 keyword started chopping of the last 6 characters and treating the result as a
245 sort sub name. The previous behaviour of treating "CORE::fake" as a sort sub
246 name has been restored.
247 [GH #14323] <https://github.com/Perl/perl5/issues/14323>
248 .IP \(bu 4
249 A bug in regular expression patterns that could lead to segfaults and other
250 crashes has been fixed. This occurred only in patterns compiled with \f(CW"/i"\fR,
251 while taking into account the current POSIX locale (this usually means they
252 have to be compiled within the scope of \f(CW"use\ locale"\fR), and there must be
253 a string of at least 128 consecutive bytes to match.
254 [GH #14389] <https://github.com/Perl/perl5/issues/14389>
255 .IP \(bu 4
256 \&\f(CW\*(C`qr/@array(?{block})/\*(C'\fR no longer dies with "Bizarre copy of ARRAY".
257 [GH #14292] <https://github.com/Perl/perl5/issues/14292>
258 .IP \(bu 4
259 \&\f(CW\*(C`gmtime\*(C'\fR no longer crashes with not-a-number values.
260 [GH #14365] <https://github.com/Perl/perl5/issues/14365>
261 .IP \(bu 4
262 Certain syntax errors in substitutions, such as \f(CW\*(C`s/${<>{})//\*(C'\fR, would
263 crash, and had done so since Perl 5.10. (In some cases the crash did not start
264 happening until Perl 5.16.) The crash has, of course, been fixed.
265 [GH #14391] <https://github.com/Perl/perl5/issues/14391>
266 .IP \(bu 4
267 A memory leak in some regular expressions, introduced in Perl 5.20.1, has been
268 fixed.
269 [GH #14236] <https://github.com/Perl/perl5/issues/14236>
270 .IP \(bu 4
271 \&\f(CW\*(C`formline("@...", "a");\*(C'\fR would crash. The \f(CW\*(C`FF_CHECKNL\*(C'\fR case in
272 \&\fBpp_formline()\fR didn't set the pointer used to mark the chop position, which led
273 to the \f(CW\*(C`FF_MORE\*(C'\fR case crashing with a segmentation fault. This has been
274 fixed.
275 [GH #14388] <https://github.com/Perl/perl5/issues/14388>
276 [GH #14425] <https://github.com/Perl/perl5/issues/14425>
277 .IP \(bu 4
278 A possible buffer overrun and crash when parsing a literal pattern during
279 regular expression compilation has been fixed.
280 [GH #14416] <https://github.com/Perl/perl5/issues/14416>
281 .SH "Known Problems"
282 .IX Header "Known Problems"
283 .IP \(bu 4
284 It is a known bug that lexical subroutines cannot be used as the \f(CW\*(C`SUBNAME\*(C'\fR
285 argument to \f(CW\*(C`sort\*(C'\fR. This will be fixed in a future version of Perl.
286 .SH "Errata From Previous Releases"
287 .IX Header "Errata From Previous Releases"
288 .IP \(bu 4
289 A regression has been fixed that was introduced in Perl 5.20.0 (fixed in Perl
290 5.20.1 as well as here) in which a UTF\-8 encoded regular expression pattern
291 that contains a single ASCII lowercase letter does not match its uppercase
292 counterpart.
293 [GH #14051] <https://github.com/Perl/perl5/issues/14051>
294 .SH Acknowledgements
295 .IX Header "Acknowledgements"
296 Perl 5.20.2 represents approximately 5 months of development since Perl 5.20.1
297 and contains approximately 6,300 lines of changes across 170 files from 34
298 authors.
299 .PP
300 Excluding auto-generated files, documentation and release tools, there were
301 approximately 1,900 lines of changes to 80 .pm, .t, .c and .h files.
302 .PP
303 Perl continues to flourish into its third decade thanks to a vibrant community
304 of users and developers. The following people are known to have contributed
305 the improvements that became Perl 5.20.2:
306 .PP
307 Aaron Crane, Abigail, Andreas Voegele, Andy Dougherty, Anthony Heading,
308 Aristotle Pagaltzis, Chris 'BinGOs' Williams, Craig A. Berry, Daniel Dragan,
309 Doug Bell, Ed J, Father Chrysostomos, Glenn D. Golden, H.Merijn Brand, Hugo van
310 der Sanden, James E Keenan, Jarkko Hietaniemi, Jim Cromie, Karen Etheridge,
311 Karl Williamson, kmx, Matthew Horsfall, Max Maischein, Peter Martini, Rafael
312 Garcia-Suarez, Ricardo Signes, Shlomi Fish, Slaven Rezic, Steffen Müller,
313 Steve Hay, Tadeusz Sośnierz, Tony Cook, Yves Orton, Ævar Arnfjörð
314 Bjarmason.
315 .PP
316 The list above is almost certainly incomplete as it is automatically generated
317 from version control history. In particular, it does not include the names of
318 the (very much appreciated) contributors who reported issues to the Perl bug
319 tracker.
320 .PP
321 Many of the changes included in this version originated in the CPAN modules
322 included in Perl's core. We're grateful to the entire CPAN community for
323 helping Perl to flourish.
324 .PP
325 For a more complete list of all of Perl's historical contributors, please see
326 the \fIAUTHORS\fR file in the Perl source distribution.
327 .SH "Reporting Bugs"
328 .IX Header "Reporting Bugs"
329 If you find what you think is a bug, you might check the articles recently
330 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
331 https://rt.perl.org/ . There may also be information at http://www.perl.org/ ,
332 the Perl Home Page.
333 .PP
334 If you believe you have an unreported bug, please run the perlbug program
335 included with your release. Be sure to trim your bug down to a tiny but
336 sufficient test case. Your bug report, along with the output of \f(CW\*(C`perl \-V\*(C'\fR,
337 will be sent off to [email protected] to be analysed by the Perl porting team.
338 .PP
339 If the bug you are reporting has security implications, which make it
340 inappropriate to send to a publicly archived mailing list, then please send it
341 to perl5\-security\[email protected]. This points to a closed subscription
342 unarchived mailing list, which includes all the core committers, who will be
343 able to help assess the impact of issues, figure out a resolution, and help
344 co-ordinate the release of patches to mitigate or fix the problem across all
345 platforms on which Perl is supported. Please only use this address for
346 security issues in the Perl core, not for modules independently distributed on
347 CPAN.
348 .SH "SEE ALSO"
349 .IX Header "SEE ALSO"
350 The \fIChanges\fR file for an explanation of how to view exhaustive details on
351 what changed.
352 .PP
353 The \fIINSTALL\fR file for how to build Perl.
354 .PP
355 The \fIREADME\fR file for general stuff.
356 .PP
357 The \fIArtistic\fR and \fICopying\fR files for copyright information.