Debian Codegraph @

upstream/opensuse-tumbleweed/man1/perl5202delta.1

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