Debian Codegraph @

upstream/fedora-44/man1/perl5320delta.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 "PERL5320DELTA 1"
61 .TH PERL5320DELTA 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 perl5320delta \- what is new for perl v5.32.0
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 This document describes differences between the 5.30.0 release and the 5.32.0
71 release.
72 .PP
73 If you are upgrading from an earlier release such as 5.28.0, first read
74 perl5300delta, which describes differences between 5.28.0 and 5.30.0.
75 .SH "Core Enhancements"
76 .IX Header "Core Enhancements"
77 .SS "The isa Operator"
78 .IX Subsection "The isa Operator"
79 A new experimental infix operator called \f(CW\*(C`isa\*(C'\fR tests whether a given object
80 is an instance of a given class or a class derived from it:
81 .PP
82 .Vb 1
83 \& if( $obj isa Package::Name ) { ... }
84 .Ve
85 .PP
86 For more detail see "Class Instance Operator" in perlop.
87 .SS "Unicode 13.0 is supported"
88 .IX Subsection "Unicode 13.0 is supported"
89 See <https://www.unicode.org/versions/Unicode13.0.0/> for details.
90 .SS "Chained comparisons capability"
91 .IX Subsection "Chained comparisons capability"
92 Some comparison operators, as their associativity, \fIchain\fR with some
93 operators of the same precedence (but never with operators of different
94 precedence).
95 .PP
96 .Vb 1
97 \& if ( $x < $y <= $z ) {...}
98 .Ve
99 .PP
100 behaves exactly like:
101 .PP
102 .Vb 1
103 \& if ( $x < $y && $y <= $z ) {...}
104 .Ve
105 .PP
106 (assuming that \f(CW"$y"\fR is as simple a scalar as it looks.)
107 .PP
108 You can read more about this in perlop under
109 "Operator Precedence and Associativity" in perlop.
110 .ie n .SS "New Unicode properties ""Identifier_Status"" and ""Identifier_Type"" supported"
111 .el .SS "New Unicode properties \f(CWIdentifier_Status\fP and \f(CWIdentifier_Type\fP supported"
112 .IX Subsection "New Unicode properties Identifier_Status and Identifier_Type supported"
113 Unicode has revised its regular expression requirements:
114 <https://www.unicode.org/reports/tr18/tr18\-21.html>.
115 As part of that they are wanting more properties to be exposed, ones
116 that aren\*(Aqt part of the strict UCD (Unicode character database). These
117 two are used for examining inputs for security purposes. Details on
118 their usage is at <https://www.unicode.org/reports/tr39/>.
119 .ie n .SS "It is now possible to write ""qr/\ep{Name=...}/"", or ""qr!\ep{na=/(SMILING|GRINNING) FACE/}!"""
120 .el .SS "It is now possible to write \f(CWqr/\ep{Name=...}/\fP, or \f(CWqr!\ep{na=/(SMILING|GRINNING) FACE/}!\fP"
121 .IX Subsection "It is now possible to write qr/p{Name=...}/, or qr!p{na=/(SMILING|GRINNING) FACE/}!"
122 The Unicode Name property is now accessible in regular expression
123 patterns, as an alternative to \f(CW\*(C`\eN{...}\*(C'\fR.
124 A comparison of the two methods is given in
125 "Comparison of \eN{...} and \ep{name=...}" in perlunicode.
126 .PP
127 The second example above shows that wildcard subpatterns are also usable
128 in this property. See "Wildcards in Property Values" in perlunicode.
129 .ie n .SS "Improvement of POSIX::mblen(), ""mbtowc"", and ""wctomb"""
130 .el .SS "Improvement of \f(CWPOSIX::mblen()\fP, \f(CWmbtowc\fP, and \f(CWwctomb\fP"
131 .IX Subsection "Improvement of POSIX::mblen(), mbtowc, and wctomb"
132 The \f(CWPOSIX::mblen()\fR, \f(CW\*(C`mbtowc\*(C'\fR, and \f(CW\*(C`wctomb\*(C'\fR functions now
133 work on shift state locales and are thread\-safe on C99 and above
134 compilers when executed on a platform that has locale thread\-safety; the
135 length parameters are now optional.
136 .PP
137 These functions are always executed under the current C language locale.
138 (See perllocale.) Most locales are stateless, but a few, notably the
139 very rarely encountered ISO 2022, maintain a state between calls to
140 these functions. Previously the state was cleared on every call, but
141 now the state is not reset unless the appropriate parameter is \f(CW\*(C`undef\*(C'\fR.
142 .PP
143 On threaded perls, the C99 functions \fBmbrlen\fR\|(3), \fBmbrtowc\fR\|(3), and
144 \&\fBwcrtomb\fR\|(3), when available, are substituted for the plain functions.
145 This makes these functions thread\-safe when executing on a locale
146 thread\-safe platform.
147 .PP
148 The string length parameters in \f(CW\*(C`mblen\*(C'\fR and \f(CW\*(C`mbtowc\*(C'\fR are now optional;
149 useful only if you wish to restrict the length parsed in the source
150 string to less than the actual length.
151 .SS "Alpha assertions are no longer experimental"
152 .IX Subsection "Alpha assertions are no longer experimental"
153 See "(*pla:pattern)" in perlre, "(*plb:pattern)" in perlre,
154 "(*nla:pattern)" in perlre>, and "(*nlb:pattern)" in perlre.
155 Use of these no longer generates a warning; existing code that disables
156 the warning category \f(CW\*(C`experimental::alpha_assertions\*(C'\fR will continue to work
157 without any changes needed. Enabling the category has no effect.
158 .SS "Script runs are no longer experimental"
159 .IX Subsection "Script runs are no longer experimental"
160 See "Script Runs" in perlre. Use of these no longer generates a warning;
161 existing code that disables the warning category
162 \&\f(CW\*(C`experimental::script_run\*(C'\fR will continue to work without any
163 changes needed. Enabling the category has no effect.
164 .SS "Feature checks are now faster"
165 .IX Subsection "Feature checks are now faster"
166 Previously feature checks in the parser required a hash lookup when
167 features were set outside of a feature bundle, this has been optimized
168 to a bit mask check. [GH #17229 <https://github.com/Perl/perl5/issues/17229>]
169 .SS "Perl is now developed on GitHub"
170 .IX Subsection "Perl is now developed on GitHub"
171 Perl is now developed on GitHub. You can find us at
172 <https://github.com/Perl/perl5>.
173 .PP
174 Non\-security bugs should now be reported via GitHub. Security issues should
175 continue to be reported as documented in perlsec.
176 .SS "Compiled patterns can now be dumped before optimization"
177 .IX Subsection "Compiled patterns can now be dumped before optimization"
178 This is primarily useful for tracking down bugs in the regular
179 expression compiler. This dump happens on \f(CW\*(C`\-DDEBUGGING\*(C'\fR perls, if you
180 specify \f(CW\*(C`\-Drv\*(C'\fR on the command line; or on any perl if the pattern is
181 compiled within the scope of \f(CW\*(C`use\ re\ qw(Debug\ DUMP_PRE_OPTIMIZE)\*(C'\fR or
182 \&\f(CW\*(C`use\ re\ qw(Debug\ COMPILE\ EXTRA)\*(C'\fR. (All but the second case display
183 other information as well.)
184 .SH Security
185 .IX Header "Security"
186 .SS "[CVE\-2020\-10543] Buffer overflow caused by a crafted regular expression"
187 .IX Subsection "[CVE-2020-10543] Buffer overflow caused by a crafted regular expression"
188 A signed \f(CW\*(C`size_t\*(C'\fR integer overflow in the storage space calculations for
189 nested regular expression quantifiers could cause a heap buffer overflow in
190 Perl\*(Aqs regular expression compiler that overwrites memory allocated after the
191 regular expression storage space with attacker supplied data.
192 .PP
193 The target system needs a sufficient amount of memory to allocate partial
194 expansions of the nested quantifiers prior to the overflow occurring. This
195 requirement is unlikely to be met on 64\-bit systems.
196 .PP
197 Discovered by: ManhND of The Tarantula Team, VinCSS (a member of Vingroup).
198 .SS "[CVE\-2020\-10878] Integer overflow via malformed bytecode produced by a crafted regular expression"
199 .IX Subsection "[CVE-2020-10878] Integer overflow via malformed bytecode produced by a crafted regular expression"
200 Integer overflows in the calculation of offsets between instructions for the
201 regular expression engine could cause corruption of the intermediate language
202 state of a compiled regular expression. An attacker could abuse this behaviour
203 to insert instructions into the compiled form of a Perl regular expression.
204 .PP
205 Discovered by: Hugo van der Sanden and Slaven Rezic.
206 .SS "[CVE\-2020\-12723] Buffer overflow caused by a crafted regular expression"
207 .IX Subsection "[CVE-2020-12723] Buffer overflow caused by a crafted regular expression"
208 Recursive calls to \f(CWS_study_chunk()\fR by Perl\*(Aqs regular expression compiler to
209 optimize the intermediate language representation of a regular expression could
210 cause corruption of the intermediate language state of a compiled regular
211 expression.
212 .PP
213 Discovered by: Sergey Aleynikov.
214 .SS "Additional Note"
215 .IX Subsection "Additional Note"
216 An application written in Perl would only be vulnerable to any of the above
217 flaws if it evaluates regular expressions supplied by the attacker. Evaluating
218 regular expressions in this fashion is known to be dangerous since the regular
219 expression engine does not protect against denial of service attacks in this
220 usage scenario.
221 .SH "Incompatible Changes"
222 .IX Header "Incompatible Changes"
223 .SS "Certain pattern matching features are now prohibited in compiling Unicode property value wildcard subpatterns"
224 .IX Subsection "Certain pattern matching features are now prohibited in compiling Unicode property value wildcard subpatterns"
225 These few features are either inappropriate or interfere with the
226 algorithm used to accomplish this task. The complete list is in
227 "Wildcards in Property Values" in perlunicode.
228 .ie n .SS "Unused functions ""POSIX::mbstowcs"" and ""POSIX::wcstombs"" are removed"
229 .el .SS "Unused functions \f(CWPOSIX::mbstowcs\fP and \f(CWPOSIX::wcstombs\fP are removed"
230 .IX Subsection "Unused functions POSIX::mbstowcs and POSIX::wcstombs are removed"
231 These functions could never have worked due to a defective interface
232 specification. There is clearly no demand for them, given that no one
233 has ever complained in the many years the functions were claimed to be
234 available, hence so\-called "support" for them is now dropped.
235 .ie n .SS "A bug fix for ""(?[...])"" may have caused some patterns to no longer compile"
236 .el .SS "A bug fix for \f(CW(?[...])\fP may have caused some patterns to no longer compile"
237 .IX Subsection "A bug fix for (?[...]) may have caused some patterns to no longer compile"
238 See "Selected Bug Fixes". The heuristics previously used may have let
239 some constructs compile (perhaps not with the programmer\*(Aqs intended
240 effect) that should have been errors. None are known, but it is
241 possible that some erroneous constructs no longer compile.
242 .ie n .SS """\ep{\fIuser\-defined\fP}"" properties now always override official Unicode ones"
243 .el .SS "\f(CW\ep{\fP\f(CIuser\-defined\fP\f(CW}\fP properties now always override official Unicode ones"
244 .IX Subsection "p{user-defined} properties now always override official Unicode ones"
245 Previously, if and only if a user\-defined property was declared prior to
246 the compilation of the regular expression pattern that contains it, its
247 definition was used instead of any official Unicode property with the
248 same name. Now, it always overrides the official property. This
249 change could break existing code that relied (likely unwittingly) on the
250 previous behavior. Without this fix, if Unicode released a new version
251 with a new property that happens to have the same name as the one you
252 had long been using, your program would break when you upgraded to a
253 perl that used that new Unicode version. See "User\-Defined
254 Character Properties" in perlunicode. [GH #17205 <https://github.com/Perl/perl5/issues/17205>]
255 .SS "Modifiable variables are no longer permitted in constants"
256 .IX Subsection "Modifiable variables are no longer permitted in constants"
257 Code like:
258 .PP
259 .Vb 2
260 \& my $var;
261 \& $sub = sub () { $var };
262 .Ve
263 .PP
264 where \f(CW$var\fR is referenced elsewhere in some sort of modifiable context now
265 produces an exception when the sub is defined.
266 .PP
267 This error can be avoided by adding a return to the sub definition:
268 .PP
269 .Vb 1
270 \& $sub = sub () { return $var };
271 .Ve
272 .PP
273 This has been deprecated since Perl 5.22.
274 [GH #17020] <https://github.com/Perl/perl5/issues/17020>
275 .ie n .SS "Use of ""vec"" on strings with code points above 0xFF is forbidden"
276 .el .SS "Use of \f(CWvec\fP on strings with code points above 0xFF is forbidden"
277 .IX Subsection "Use of vec on strings with code points above 0xFF is forbidden"
278 Such strings are represented internally in UTF\-8, and \f(CW\*(C`vec\*(C'\fR is a
279 bit\-oriented operation that will likely give unexpected results on those
280 strings. This was deprecated in perl 5.28.0.
281 .SS "Use of code points over 0xFF in string bitwise operators"
282 .IX Subsection "Use of code points over 0xFF in string bitwise operators"
283 Some uses of these were already illegal after a previous deprecation
284 cycle. The remaining uses are now prohibited, having been deprecated in perl
285 5.28.0. See perldeprecation.
286 .ie n .SS "Sys::Hostname::hostname() does not accept arguments"
287 .el .SS "\f(CWSys::Hostname::hostname()\fP does not accept arguments"
288 .IX Subsection "Sys::Hostname::hostname() does not accept arguments"
289 This usage was deprecated in perl 5.28.0 and is now fatal.
290 .SS "Plain ""0"" string now treated as a number for range operator"
291 .IX Subsection "Plain ""0"" string now treated as a number for range operator"
292 Previously a range \f(CW"0" .. "\-1"\fR would produce a range of numeric
293 strings from "0" through "99"; this now produces an empty list, just
294 as \f(CW\*(C`0 .. \-1\*(C'\fR does. This also means that \f(CW"0" .. "9"\fR now produces a
295 list of integers, where previously it would produce a list of strings.
296 .PP
297 This was due to a special case that treated strings starting with "0"
298 as strings so ranges like \f(CW"00" .. "03"\fR produced \f(CW"00", "01", "02", "03"\fR,
299 but didn\*(Aqt specially handle the string \f(CW"0"\fR.
300 [GH #16770] <https://github.com/Perl/perl5/issues/16770>
301 .ie n .SS """\eK"" now disallowed in look\-ahead and look\-behind assertions"
302 .el .SS "\f(CW\eK\fP now disallowed in look\-ahead and look\-behind assertions"
303 .IX Subsection "K now disallowed in look-ahead and look-behind assertions"
304 This was disallowed because it causes unexpected behaviour, and no\-one
305 could define what the desired behaviour should be.
306 [GH #14638] <https://github.com/Perl/perl5/issues/14638>
307 .SH "Performance Enhancements"
308 .IX Header "Performance Enhancements"
309 .IP \(bu 4
310 \&\f(CW\*(C`my_strnlen\*(C'\fR has been sped up for systems that don\*(Aqt have their own
311 \&\f(CW\*(C`strnlen\*(C'\fR implementation.
312 .IP \(bu 4
313 \&\f(CW\*(C`grok_bin_oct_hex\*(C'\fR (and so, \f(CW\*(C`grok_bin\*(C'\fR, \f(CW\*(C`grok_oct\*(C'\fR, and \f(CW\*(C`grok_hex\*(C'\fR)
314 have been sped up.
315 .IP \(bu 4
316 \&\f(CW\*(C`grok_number_flags\*(C'\fR has been sped up.
317 .IP \(bu 4
318 \&\f(CW\*(C`sort\*(C'\fR is now noticeably faster in cases such as \f(CW\*(C`sort {$a <=> $b}\*(C'\fR or
319 \&\f(CW\*(C`sort {$b <=> $a}\*(C'\fR. [GH #17608 <https://github.com/Perl/perl5/pull/17608>]
320 .SH "Modules and Pragmata"
321 .IX Header "Modules and Pragmata"
322 .SS "Updated Modules and Pragmata"
323 .IX Subsection "Updated Modules and Pragmata"
324 .IP \(bu 4
325 Archive::Tar has been upgraded from version 2.32 to 2.36.
326 .IP \(bu 4
327 autodie has been upgraded from version 2.29 to 2.32.
328 .IP \(bu 4
329 B has been upgraded from version 1.76 to 1.80.
330 .IP \(bu 4
331 B::Deparse has been upgraded from version 1.49 to 1.54.
332 .IP \(bu 4
333 Benchmark has been upgraded from version 1.22 to 1.23.
334 .IP \(bu 4
335 charnames has been upgraded from version 1.45 to 1.48.
336 .IP \(bu 4
337 Class::Struct has been upgraded from version 0.65 to 0.66.
338 .IP \(bu 4
339 Compress::Raw::Bzip2 has been upgraded from version 2.084 to 2.093.
340 .IP \(bu 4
341 Compress::Raw::Zlib has been upgraded from version 2.084 to 2.093.
342 .IP \(bu 4
343 CPAN has been upgraded from version 2.22 to 2.27.
344 .IP \(bu 4
345 DB_File has been upgraded from version 1.843 to 1.853.
346 .IP \(bu 4
347 Devel::PPPort has been upgraded from version 3.52 to 3.57.
348 .Sp
349 The test files generated on Win32 are now identical to when they are
350 generated on POSIX\-like systems.
351 .IP \(bu 4
352 diagnostics has been upgraded from version 1.36 to 1.37.
353 .IP \(bu 4
354 Digest::MD5 has been upgraded from version 2.55 to 2.55_01.
355 .IP \(bu 4
356 Dumpvalue has been upgraded from version 1.18 to 1.21.
357 .Sp
358 Previously, when dumping elements of an array and encountering an undefined
359 value, the string printed would have been \f(CW\*(C`empty array\*(C'\fR. This has been
360 changed to what was apparently originally intended: \f(CW\*(C`empty slot\*(C'\fR.
361 .IP \(bu 4
362 DynaLoader has been upgraded from version 1.45 to 1.47.
363 .IP \(bu 4
364 Encode has been upgraded from version 3.01 to 3.06.
365 .IP \(bu 4
366 encoding has been upgraded from version 2.22 to 3.00.
367 .IP \(bu 4
368 English has been upgraded from version 1.10 to 1.11.
369 .IP \(bu 4
370 Exporter has been upgraded from version 5.73 to 5.74.
371 .IP \(bu 4
372 ExtUtils::CBuilder has been upgraded from version 0.280231 to 0.280234.
373 .IP \(bu 4
374 ExtUtils::MakeMaker has been upgraded from version 7.34 to 7.44.
375 .IP \(bu 4
376 feature has been upgraded from version 1.54 to 1.58.
377 .Sp
378 A new \f(CW\*(C`indirect\*(C'\fR feature has been added, which is enabled by default
379 but allows turning off indirect object syntax.
380 .IP \(bu 4
381 File::Find has been upgraded from version 1.36 to 1.37.
382 .Sp
383 On Win32, the tests no longer require either a file in the drive root
384 directory, or a writable root directory.
385 .IP \(bu 4
386 File::Glob has been upgraded from version 1.32 to 1.33.
387 .IP \(bu 4
388 File::stat has been upgraded from version 1.08 to 1.09.
389 .IP \(bu 4
390 Filter::Simple has been upgraded from version 0.95 to 0.96.
391 .IP \(bu 4
392 Getopt::Long has been upgraded from version 2.5 to 2.51.
393 .IP \(bu 4
394 Hash::Util has been upgraded from version 0.22 to 0.23.
395 .Sp
396 The Synopsis has been updated as the example code stopped working with
397 newer perls.
398 [GH #17399 <https://github.com/Perl/perl5/issues/17399>]
399 .IP \(bu 4
400 I18N::Langinfo has been upgraded from version 0.18 to 0.19.
401 .IP \(bu 4
402 I18N::LangTags has been upgraded from version 0.43 to 0.44.
403 .Sp
404 Document the \f(CW\*(C`IGNORE_WIN32_LOCALE\*(C'\fR environment variable.
405 .IP \(bu 4
406 IO has been upgraded from version 1.40 to 1.43.
407 .Sp
408 IO::Socket no longer caches a zero protocol value, since this
409 indicates that the implementation will select a protocol. This means
410 that on platforms that don\*(Aqt implement \f(CW\*(C`SO_PROTOCOL\*(C'\fR for a given
411 socket type the protocol method may return \f(CW\*(C`undef\*(C'\fR.
412 .Sp
413 The supplied \fITO\fR is now always honoured on calls to the \f(CWsend()\fR
414 method. [GH #16891] <https://github.com/Perl/perl5/issues/16891>
415 .IP \(bu 4
416 IO\-Compress has been upgraded from version 2.084 to 2.093.
417 .IP \(bu 4
418 IPC::Cmd has been upgraded from version 1.02 to 1.04.
419 .IP \(bu 4
420 IPC::Open3 has been upgraded from version 1.20 to 1.21.
421 .IP \(bu 4
422 JSON::PP has been upgraded from version 4.02 to 4.04.
423 .IP \(bu 4
424 Math::BigInt has been upgraded from version 1.999816 to 1.999818.
425 .IP \(bu 4
426 Math::BigInt::FastCalc has been upgraded from version 0.5008 to 0.5009.
427 .IP \(bu 4
428 Module::CoreList has been upgraded from version 5.20190522 to 5.20200620.
429 .IP \(bu 4
430 Module::Load::Conditional has been upgraded from version 0.68 to 0.70.
431 .IP \(bu 4
432 Module::Metadata has been upgraded from version 1.000036 to 1.000037.
433 .IP \(bu 4
434 mro has been upgraded from version 1.22 to 1.23.
435 .IP \(bu 4
436 Net::Ping has been upgraded from version 2.71 to 2.72.
437 .IP \(bu 4
438 Opcode has been upgraded from version 1.43 to 1.47.
439 .IP \(bu 4
440 open has been upgraded from version 1.11 to 1.12.
441 .IP \(bu 4
442 overload has been upgraded from version 1.30 to 1.31.
443 .IP \(bu 4
444 parent has been upgraded from version 0.237 to 0.238.
445 .IP \(bu 4
446 perlfaq has been upgraded from version 5.20190126 to 5.20200523.
447 .IP \(bu 4
448 PerlIO has been upgraded from version 1.10 to 1.11.
449 .IP \(bu 4
450 PerlIO::encoding has been upgraded from version 0.27 to 0.28.
451 .IP \(bu 4
452 PerlIO::via has been upgraded from version 0.17 to 0.18.
453 .IP \(bu 4
454 Pod::Html has been upgraded from version 1.24 to 1.25.
455 .IP \(bu 4
456 Pod::Simple has been upgraded from version 3.35 to 3.40.
457 .IP \(bu 4
458 podlators has been upgraded from version 4.11 to 4.14.
459 .IP \(bu 4
460 POSIX has been upgraded from version 1.88 to 1.94.
461 .IP \(bu 4
462 re has been upgraded from version 0.37 to 0.40.
463 .IP \(bu 4
464 Safe has been upgraded from version 2.40 to 2.41.
465 .IP \(bu 4
466 Scalar::Util has been upgraded from version 1.50 to 1.55.
467 .IP \(bu 4
468 SelfLoader has been upgraded from version 1.25 to 1.26.
469 .IP \(bu 4
470 Socket has been upgraded from version 2.027 to 2.029.
471 .IP \(bu 4
472 Storable has been upgraded from version 3.15 to 3.21.
473 .Sp
474 Use of \f(CWnote()\fR from Test::More is now optional in tests. This works
475 around a circular dependency with Test::More when installing on very
476 old perls from CPAN.
477 .Sp
478 Vstring magic strings over 2GB are now disallowed.
479 .Sp
480 Regular expressions objects weren\*(Aqt properly counted for object id
481 purposes on retrieve. This would corrupt the resulting structure, or
482 cause a runtime error in some cases. [GH #17037] <https://github.com/Perl/perl5/issues/17037>
483 .IP \(bu 4
484 Sys::Hostname has been upgraded from version 1.22 to 1.23.
485 .IP \(bu 4
486 Sys::Syslog has been upgraded from version 0.35 to 0.36.
487 .IP \(bu 4
488 Term::ANSIColor has been upgraded from version 4.06 to 5.01.
489 .IP \(bu 4
490 Test::Simple has been upgraded from version 1.302162 to 1.302175.
491 .IP \(bu 4
492 Thread has been upgraded from version 3.04 to 3.05.
493 .IP \(bu 4
494 Thread::Queue has been upgraded from version 3.13 to 3.14.
495 .IP \(bu 4
496 threads has been upgraded from version 2.22 to 2.25.
497 .IP \(bu 4
498 threads::shared has been upgraded from version 1.60 to 1.61.
499 .IP \(bu 4
500 Tie::File has been upgraded from version 1.02 to 1.06.
501 .IP \(bu 4
502 Tie::Hash::NamedCapture has been upgraded from version 0.10 to 0.13.
503 .IP \(bu 4
504 Tie::Scalar has been upgraded from version 1.04 to 1.05.
505 .IP \(bu 4
506 Tie::StdHandle has been upgraded from version 4.5 to 4.6.
507 .IP \(bu 4
508 Time::HiRes has been upgraded from version 1.9760 to 1.9764.
509 .Sp
510 Removed obsolete code such as support for pre\-5.6 perl and classic
511 MacOS. [GH #17096] <https://github.com/Perl/perl5/issues/17096>
512 .IP \(bu 4
513 Time::Piece has been upgraded from version 1.33 to 1.3401.
514 .IP \(bu 4
515 Unicode::Normalize has been upgraded from version 1.26 to 1.27.
516 .IP \(bu 4
517 Unicode::UCD has been upgraded from version 0.72 to 0.75.
518 .IP \(bu 4
519 VMS::Stdio has been upgraded from version 2.44 to 2.45.
520 .IP \(bu 4
521 warnings has been upgraded from version 1.44 to 1.47.
522 .IP \(bu 4
523 Win32 has been upgraded from version 0.52 to 0.53.
524 .IP \(bu 4
525 Win32API::File has been upgraded from version 0.1203 to 0.1203_01.
526 .IP \(bu 4
527 XS::APItest has been upgraded from version 1.00 to 1.09.
528 .SS "Removed Modules and Pragmata"
529 .IX Subsection "Removed Modules and Pragmata"
530 .IP \(bu 4
531 Pod::Parser has been removed from the core distribution.
532 It still is available for download from CPAN. This resolves
533 [#13194 <https://github.com/Perl/perl5/issues/13194>].
534 .SH Documentation
535 .IX Header "Documentation"
536 .SS "Changes to Existing Documentation"
537 .IX Subsection "Changes to Existing Documentation"
538 We have attempted to update the documentation to reflect the changes
539 listed in this document. If you find any we have missed, open an issue
540 at <https://github.com/Perl/perl5/issues>.
541 .PP
542 Additionally, the following selected changes have been made:
543 .PP
544 \fIperldebguts\fR
545 .IX Subsection "perldebguts"
546 .IP \(bu 4
547 Simplify a few regnode definitions
548 .Sp
549 Update \f(CW\*(C`BOUND\*(C'\fR and \f(CW\*(C`NBOUND\*(C'\fR definitions.
550 .IP \(bu 4
551 Add ANYOFHs regnode
552 .Sp
553 This node is like \f(CW\*(C`ANYOFHb\*(C'\fR, but is used when more than one leading byte
554 is the same in all the matched code points.
555 .Sp
556 \&\f(CW\*(C`ANYOFHb\*(C'\fR is used to avoid having to convert from UTF\-8 to code point for
557 something that won\*(Aqt match. It checks that the first byte in the UTF\-8
558 encoded target is the desired one, thus ruling out most of the possible
559 code points.
560 .PP
561 \fIperlapi\fR
562 .IX Subsection "perlapi"
563 .IP \(bu 4
564 \&\f(CW\*(C`sv_2pvbyte\*(C'\fR updated to mention it will croak if the SV cannot be
565 downgraded.
566 .IP \(bu 4
567 \&\f(CW\*(C`sv_setpvn\*(C'\fR updated to mention that the UTF\-8 flag will not be changed by
568 this function, and a terminating NUL byte is guaranteed.
569 .IP \(bu 4
570 Documentation for \f(CW\*(C`PL_phase\*(C'\fR has been added.
571 .IP \(bu 4
572 The documentation for \f(CW\*(C`grok_bin\*(C'\fR, \f(CW\*(C`grok_oct\*(C'\fR, and \f(CW\*(C`grok_hex\*(C'\fR has been
573 updated and clarified.
574 .PP
575 \fIperldiag\fR
576 .IX Subsection "perldiag"
577 .IP \(bu 4
578 Add documentation for experimental \*(Aqisa\*(Aq operator
579 .Sp
580 (S experimental::isa) This warning is emitted if you use the (\f(CW\*(C`isa\*(C'\fR)
581 operator. This operator is currently experimental and its behaviour may
582 change in future releases of Perl.
583 .PP
584 \fIperlfunc\fR
585 .IX Subsection "perlfunc"
586 .ie n .IP """caller""" 4
587 .el .IP \f(CWcaller\fR 4
588 .IX Item "caller"
589 Like \f(CW\*(C`_\|_FILE_\|_\*(C'\fR and \f(CW\*(C`_\|_LINE_\|_\*(C'\fR, the filename and
590 line number returned here may be altered by the mechanism described at
591 "Plain Old Comments (Not!)" in perlsyn.
592 .ie n .IP """_\|_FILE_\|_""" 4
593 .el .IP \f(CW_\|_FILE_\|_\fR 4
594 .IX Item "__FILE__"
595 It can be altered by the mechanism described at
596 "Plain Old Comments (Not!)" in perlsyn.
597 .ie n .IP """_\|_LINE_\|_""" 4
598 .el .IP \f(CW_\|_LINE_\|_\fR 4
599 .IX Item "__LINE__"
600 It can be altered by the mechanism described at
601 "Plain Old Comments (Not!)" in perlsyn.
602 .ie n .IP """return""" 4
603 .el .IP \f(CWreturn\fR 4
604 .IX Item "return"
605 Now mentions that you cannot return from \f(CW\*(C`do BLOCK\*(C'\fR.
606 .ie n .IP """open""" 4
607 .el .IP \f(CWopen\fR 4
608 .IX Item "open"
609 The \f(CWopen()\fR section had been renovated significantly.
610 .PP
611 \fIperlguts\fR
612 .IX Subsection "perlguts"
613 .IP \(bu 4
614 No longer suggesting using perl\*(Aqs \f(CW\*(C`malloc\*(C'\fR. Modern system \f(CW\*(C`malloc\*(C'\fR is
615 assumed to be much better than perl\*(Aqs implementation now.
616 .IP \(bu 4
617 Documentation about \fIembed.fnc\fR flags has been removed. \fIembed.fnc\fR now has
618 sufficient comments within it. Anyone changing that file will see those
619 comments first, so entries here are now redundant.
620 .IP \(bu 4
621 Updated documentation for \f(CW\*(C`UTF8f\*(C'\fR
622 .IP \(bu 4
623 Added missing \f(CW\*(C`=for apidoc\*(C'\fR lines
624 .PP
625 \fIperlhacktips\fR
626 .IX Subsection "perlhacktips"
627 .IP \(bu 4
628 The differences between Perl strings and C strings are now detailed.
629 .PP
630 \fIperlintro\fR
631 .IX Subsection "perlintro"
632 .IP \(bu 4
633 The documentation for the repetition operator \f(CW\*(C`x\*(C'\fR have been clarified.
634 [GH #17335 <https://github.com/Perl/perl5/issues/17335>]
635 .PP
636 \fIperlipc\fR
637 .IX Subsection "perlipc"
638 .IP \(bu 4
639 The documentation surrounding \f(CW\*(C`open\*(C'\fR and handle usage has been modernized
640 to prefer 3\-arg open and lexical variables instead of barewords.
641 .IP \(bu 4
642 Various updates and fixes including making all examples strict\-safe and
643 replacing \f(CW\*(C`\-w\*(C'\fR with \f(CW\*(C`use warnings\*(C'\fR.
644 .PP
645 \fIperlop\fR
646 .IX Subsection "perlop"
647 .IP \(bu 4
648 \&\*(Aqisa\*(Aq operator is experimental
649 .Sp
650 This is an experimental feature and is available when enabled
651 by \f(CW\*(C`use feature \*(Aqisa\*(Aq\*(C'\fR. It emits a warning in the \f(CW\*(C`experimental::isa\*(C'\fR
652 category.
653 .PP
654 \fIperlpod\fR
655 .IX Subsection "perlpod"
656 .IP \(bu 4
657 Details of the various stacks within the perl interpreter are now explained
658 here.
659 .IP \(bu 4
660 Advice has been added regarding the usage of \f(CW\*(C`Z<>\*(C'\fR.
661 .PP
662 \fIperlport\fR
663 .IX Subsection "perlport"
664 .IP \(bu 4
665 Update \f(CW\*(C`timegm\*(C'\fR example to use the correct year format \fI1970\fR instead of \fI70\fR.
666 [GH #16431 <https://github.com/Perl/perl5/issues/16431>]
667 .PP
668 \fIperlreref\fR
669 .IX Subsection "perlreref"
670 .IP \(bu 4
671 Fix some typos.
672 .PP
673 \fIperlvar\fR
674 .IX Subsection "perlvar"
675 .IP \(bu 4
676 Now recommends stringifying \f(CW$]\fR and comparing it numerically.
677 .PP
678 \fIperlapi, perlintern\fR
679 .IX Subsection "perlapi, perlintern"
680 .IP \(bu 4
681 Documentation has been added for several functions that were
682 lacking it before.
683 .PP
684 \fIperlxs\fR
685 .IX Subsection "perlxs"
686 .IP \(bu 4
687 Suggest using \f(CW\*(C`libffi\*(C'\fR for simple library bindings via CPAN modules
688 like FFI::Platypus or FFI::Raw.
689 .PP
690 \fIPOSIX\fR
691 .IX Subsection "POSIX"
692 .IP \(bu 4
693 \&\f(CW\*(C`setlocale\*(C'\fR warning about threaded builds updated to note it does not
694 apply on Perl 5.28.X and later.
695 .IP \(bu 4
696 \&\f(CW\*(C`Posix::SigSet\->new(...)\*(C'\fR updated to state it throws an error if any of
697 the supplied signals cannot be added to the set.
698 .PP
699 Additionally, the following selected changes have been made:
700 .PP
701 \fIUpdating of links\fR
702 .IX Subsection "Updating of links"
703 .IP \(bu 4
704 Links to the now defunct <https://search.cpan.org> site now point at
705 the equivalent <https://metacpan.org> URL. [GH #17393 <https://github.com/Perl/perl5/issues/17393>]
706 .IP \(bu 4
707 The man page for ExtUtils::XSSymSet is now only installed on VMS,
708 which is the only platform the module is installed on. [GH #17424 <https://github.com/Perl/perl5/issues/17424>]
709 .IP \(bu 4
710 URLs have been changed to \f(CW\*(C`https://\*(C'\fR and stale links have been updated.
711 .Sp
712 Where applicable, the URLs in the documentation have been moved from using the
713 \&\f(CW\*(C`http://\*(C'\fR protocol to \f(CW\*(C`https://\*(C'\fR. This also affects the location of the bug
714 tracker at <https://rt.perl.org>.
715 .IP \(bu 4
716 Some links to OS/2 libraries, Address Sanitizer and other system tools had gone
717 stale. These have been updated with working links.
718 .IP \(bu 4
719 Some links to old email addresses on perl5\-porters had gone stale. These have been
720 updated with working links.
721 .SH Diagnostics
722 .IX Header "Diagnostics"
723 The following additions or changes have been made to diagnostic output,
724 including warnings and fatal error messages. For the complete list of
725 diagnostic messages, see perldiag.
726 .SS "New Diagnostics"
727 .IX Subsection "New Diagnostics"
728 \fINew Errors\fR
729 .IX Subsection "New Errors"
730 .IP \(bu 4
731 Expecting interpolated extended charclass in regex; marked by <\-\- HERE in m/%s/
732 .Sp
733 This is a replacement for several error messages listed under
734 "Changes to Existing Diagnostics".
735 .IP \(bu 4
736 \&\f(CW\*(C`No digits found for %s literal\*(C'\fR
737 .Sp
738 (F) No hexadecimal digits were found following \f(CW\*(C`0x\*(C'\fR or no binary digits were
739 found following \f(CW\*(C`0b\*(C'\fR.
740 .PP
741 \fINew Warnings\fR
742 .IX Subsection "New Warnings"
743 .IP \(bu 4
744 Code point 0x%X is not Unicode, and not portable
745 .Sp
746 This is actually not a new message, but it is now output when the
747 warnings category \f(CW\*(C`portable\*(C'\fR is enabled.
748 .Sp
749 When raised during regular expression pattern compilation, the warning
750 has extra text added at the end marking where precisely in the pattern
751 it occurred.
752 .IP \(bu 4
753 Non\-hex character \*(Aq%c\*(Aq terminates \ex early. Resolved as "%s"
754 .Sp
755 This replaces a warning that was much less specific, and which gave
756 false information. This new warning parallels the similar
757 already\-existing one raised for \f(CW\*(C`\eo{}\*(C'\fR.
758 .SS "Changes to Existing Diagnostics"
759 .IX Subsection "Changes to Existing Diagnostics"
760 .IP \(bu 4
761 Character following "\ec" must be printable ASCII
762 .Sp
763 \&...now has extra text added at the end, when raised during regular
764 expression pattern compilation, marking where precisely in the pattern
765 it occurred.
766 .IP \(bu 4
767 Use "%s" instead of "%s"
768 .Sp
769 \&...now has extra text added at the end, when raised during regular
770 expression pattern compilation, marking where precisely in the pattern
771 it occurred.
772 .IP \(bu 4
773 Sequence "\ec{" invalid
774 .Sp
775 \&...now has extra text added at the end, when raised during regular
776 expression pattern compilation, marking where precisely in the pattern
777 it occurred.
778 .IP \(bu 4
779 "\ec%c" is more clearly written simply as "%s"
780 .Sp
781 \&...now has extra text added at the end, when raised during regular
782 expression pattern compilation, marking where precisely in the pattern
783 it occurred.
784 .IP \(bu 4
785 Non\-octal character \*(Aq%c\*(Aq terminates \eo early. Resolved as "%s"
786 .Sp
787 \&...now includes the phrase "terminates \eo early", and has extra text added
788 at the end, when raised during regular expression pattern compilation,
789 marking where precisely in the pattern it occurred. In some instances
790 the text of the resolution has been clarified.
791 .IP \(bu 4
792 \&\*(Aq%s\*(Aq resolved to \*(Aq\eo{%s}%d\*(Aq
793 .Sp
794 As of Perl 5.32, this message is no longer generated. Instead,
795 "Non\-octal character \*(Aq%c\*(Aq terminates \eo early. Resolved as "%s"" in perldiag
796 is used instead.
797 .IP \(bu 4
798 Use of code point 0x%s is not allowed; the permissible max is 0x%X
799 .Sp
800 Some instances of this message previously output the hex digits \f(CW\*(C`A\*(C'\fR,
801 \&\f(CW\*(C`B\*(C'\fR, \f(CW\*(C`C\*(C'\fR, \f(CW\*(C`D\*(C'\fR, \f(CW\*(C`E\*(C'\fR, and \f(CW\*(C`F\*(C'\fR in lower case. Now they are all
802 consistently upper case.
803 .IP \(bu 4
804 The following three diagnostics have been removed, and replaced by
805 \&\f(CW\*(C`Expecting interpolated extended charclass in regex; marked by <\-\- HERE in m/%s/\*(C'\fR
806 :
807 \&\f(CW\*(C`Expecting close paren for nested extended charclass in regex; marked
808 by <\-\- HERE in m/%s/\*(C'\fR,
809 \&\f(CW\*(C`Expecting close paren for wrapper for nested extended charclass in
810 regex; marked by <\-\- HERE in m/%s/\*(C'\fR,
811 and
812 \&\f(CW\*(C`Expecting \*(Aq(?flags:(?[...\*(Aq in regex; marked by <\-\-\ HERE in m/%s/\*(C'\fR.
813 .IP \(bu 4
814 The \f(CW\*(C`Code point 0x%X is not Unicode, and not portable\*(C'\fR warning removed
815 the line \f(CW\*(C`Code points above 0xFFFF_FFFF require larger than a 32 bit word.\*(C'\fR
816 as code points that large are no longer legal on 32\-bit platforms.
817 .IP \(bu 4
818 Can\*(Aqt use global \f(CW%s\fR in \f(CW%s\fR
819 .Sp
820 This error message has been slightly reformatted from the original \f(CW\*(C`Can\*(Aqt use
821 global %s in "%s"\*(C'\fR, and in particular misleading error messages like \f(CW\*(C`Can\*(Aqt
822 use global $_ in "my"\*(C'\fR are now rendered as \f(CW\*(C`Can\*(Aqt use global $_ in subroutine
823 signature\*(C'\fR.
824 .IP \(bu 4
825 Constants from lexical variables potentially modified elsewhere are no longer permitted
826 .Sp
827 This error message replaces the former \f(CWConstants from lexical variables
828 potentially modified elsewhere are deprecated. This will not be allowed in Perl
829 5.32\fR to reflect the fact that this previously deprecated usage has now been
830 transformed into an exception. The message\*(Aqs classification has also been
831 updated from D (deprecated) to F (fatal).
832 .Sp
833 See also "Incompatible Changes".
834 .IP \(bu 4
835 \&\f(CW\*(C`\eN{} here is restricted to one character\*(C'\fR is now emitted in the same
836 circumstances where previously \f(CW\*(C`\eN{} in inverted character class or as a range
837 end\-point is restricted to one character\*(C'\fR was.
838 .Sp
839 This is due to new circumstances having been added in Perl 5.30 that weren\*(Aqt
840 covered by the earlier wording.
841 .SH "Utility Changes"
842 .IX Header "Utility Changes"
843 .SS perlbug
844 .IX Subsection "perlbug"
845 .IP \(bu 4
846 The bug tracker homepage URL now points to GitHub.
847 .SS streamzip
848 .IX Subsection "streamzip"
849 .IP \(bu 4
850 This is a new utility, included as part of an
851 IO::Compress::Base upgrade.
852 .Sp
853 streamzip creates a zip file from stdin. The program will read data
854 from stdin, compress it into a zip container and, by default, write a
855 streamed zip file to stdout.
856 .SH "Configuration and Compilation"
857 .IX Header "Configuration and Compilation"
858 .SS \fIConfigure\fP
859 .IX Subsection "Configure"
860 .IP \(bu 4
861 For clang++, add \f(CW\*(C`#include <stdlib.h>\*(C'\fR to Configure\*(Aqs probes for
862 \&\f(CW\*(C`futimes\*(C'\fR, \f(CW\*(C`strtoll\*(C'\fR, \f(CW\*(C`strtoul\*(C'\fR, \f(CW\*(C`strtoull\*(C'\fR, \f(CW\*(C`strtouq\*(C'\fR, otherwise the
863 probes would fail to compile.
864 .IP \(bu 4
865 Use a compile and run test for \f(CW\*(C`lchown\*(C'\fR to satisfy clang++ which should
866 more reliably detect it.
867 .IP \(bu 4
868 For C++ compilers, add \f(CW\*(C`#include <stdio.h>\*(C'\fR to Configure\*(Aqs probes for
869 \&\f(CW\*(C`getpgrp\*(C'\fR and \f(CW\*(C`setpgrp\*(C'\fR as they use printf and C++ compilers may fail
870 compilation instead of just warning.
871 .IP \(bu 4
872 Check if the compiler can handle inline attribute.
873 .IP \(bu 4
874 Check for character data alignment.
875 .IP \(bu 4
876 \&\fIConfigure\fR now correctly handles gcc\-10. Previously it was interpreting it
877 as gcc\-1 and turned on \f(CW\*(C`\-fpcc\-struct\-return\*(C'\fR.
878 .IP \(bu 4
879 Perl now no longer probes for \f(CW\*(C`d_u32align\*(C'\fR, defaulting to \f(CW\*(C`define\*(C'\fR on all
880 platforms. This check was error\-prone when it was done, which was on 32\-bit
881 platforms only.
882 [GH #16680] <https://github.com/Perl/perl5/issues/16680>
883 .IP \(bu 4
884 Documentation and hints for building perl on Z/OS (native EBCDIC) have been
885 updated. This is still a work in progress.
886 .IP \(bu 4
887 A new probe for \f(CW\*(C`malloc_usable_size\*(C'\fR has been added.
888 .IP \(bu 4
889 Improvements in \fIConfigure\fR to detection in C++ and clang++. Work ongoing by
890 Andy Dougherty. [GH #17033] <https://github.com/Perl/perl5/issues/17033>
891 .IP \(bu 4
892 \&\fIautodoc.pl\fR
893 .Sp
894 This tool that regenerates perlintern and perlapi has been overhauled
895 significantly, restoring consistency in flags used in \fIembed.fnc\fR and
896 Devel::PPPort and allowing removal of many redundant \f(CW\*(C`=for apidoc\*(C'\fR
897 entries in code.
898 .IP \(bu 4
899 The \f(CW\*(C`ECHO\*(C'\fR macro is now defined. This is used in a \f(CW\*(C`dtrace\*(C'\fR rule that was
900 originally changed for FreeBSD, and the FreeBSD make apparently predefines it.
901 The Solaris make does not predefine \f(CW\*(C`ECHO\*(C'\fR which broke this rule on Solaris.
902 [GH #17057] <https://github.com/Perl/perl5/issues/17057>
903 .IP \(bu 4
904 Bison versions 3.1 through 3.4 are now supported.
905 .SH Testing
906 .IX Header "Testing"
907 Tests were added and changed to reflect the other additions and
908 changes in this release. Furthermore, these significant changes were
909 made:
910 .IP \(bu 4
911 \&\fIt/run/switches.t\fR no longer uses (and re\-uses) the \fItmpinplace/\fR
912 directory under \fIt/\fR. This may prevent spurious failures. [GH #17424 <https://github.com/Perl/perl5/issues/17424>]
913 .IP \(bu 4
914 Various bugs in \f(CW\*(C`POSIX::mbtowc\*(C'\fR were fixed. Potential races with
915 other threads are now avoided, and previously the returned wide
916 character could well be garbage.
917 .IP \(bu 4
918 Various bugs in \f(CW\*(C`POSIX::wctomb\*(C'\fR were fixed. Potential races with other
919 threads are now avoided, and previously it would segfault if the string
920 parameter was shared or hadn\*(Aqt been pre\-allocated with a string of
921 sufficient length to hold the result.
922 .IP \(bu 4
923 Certain test output of scalars containing control characters and Unicode
924 has been fixed on EBCDIC.
925 .IP \(bu 4
926 \&\fIt/charset_tools.pl\fR: Avoid some work on ASCII platforms.
927 .IP \(bu 4
928 \&\fIt/re/regexp.t\fR: Speed up many regex tests on ASCII platform
929 .IP \(bu 4
930 \&\fIt/re/pat.t\fR: Skip tests that don\*(Aqt work on EBCDIC.
931 .SH "Platform Support"
932 .IX Header "Platform Support"
933 .SS "Discontinued Platforms"
934 .IX Subsection "Discontinued Platforms"
935 .IP "Windows CE" 4
936 .IX Item "Windows CE"
937 Support for building perl on Windows CE has now been removed.
938 .SS "Platform\-Specific Notes"
939 .IX Subsection "Platform-Specific Notes"
940 .IP Linux 4
941 .IX Item "Linux"
942 \&\f(CW\*(C`cc\*(C'\fR will be used to populate \f(CW\*(C`plibpth\*(C'\fR if \f(CW\*(C`cc\*(C'\fR is \f(CW\*(C`clang\*(C'\fR.
943 [GH #17043] <https://github.com/Perl/perl5/issues/17043>
944 .IP "NetBSD 8.0" 4
945 .IX Item "NetBSD 8.0"
946 Fix compilation of Perl on NetBSD 8.0 with g++.
947 [GH #17381 <https://github.com/Perl/perl5/issues/17381>]
948 .IP Windows 4
949 .IX Item "Windows"
950 .RS 4
951 .PD 0
952 .IP \(bu 4
953 .PD
954 The configuration for \f(CW\*(C`ccflags\*(C'\fR and \f(CW\*(C`optimize\*(C'\fR are now separate, as
955 with POSIX platforms. [GH #17156 <https://github.com/Perl/perl5/issues/17156>]
956 .IP \(bu 4
957 Support for building perl with Visual C++ 6.0 has now been removed.
958 .IP \(bu 4
959 The locale tests could crash on Win32 due to a Windows bug, and
960 separately due to the CRT throwing an exception if the locale name
961 wasn\*(Aqt validly encoded in the current code page.
962 .Sp
963 For the second we now decode the locale name ourselves, and always
964 decode it as UTF\-8. [GH #16922] <https://github.com/Perl/perl5/issues/16922>
965 .IP \(bu 4
966 \&\fIt/op/magic.t\fR could fail if environment variables starting with
967 \&\f(CW\*(C`FOO\*(C'\fR already existed.
968 .IP \(bu 4
969 MYMALLOC (PERL_MALLOC) build has been fixed.
970 .RE
971 .RS 4
972 .RE
973 .IP Solaris 4
974 .IX Item "Solaris"
975 .RS 4
976 .PD 0
977 .IP \(bu 4
978 .PD
979 \&\f(CW\*(C`Configure\*(C'\fR will now find recent versions of the Oracle Developer Studio
980 compiler, which are found under \f(CW\*(C`/opt/developerstudio*\*(C'\fR.
981 .IP \(bu 4
982 \&\f(CW\*(C`Configure\*(C'\fR now uses the detected types for \f(CW\*(C`gethostby*\*(C'\fR functions, allowing
983 Perl to once again compile on certain configurations of Solaris.
984 .RE
985 .RS 4
986 .RE
987 .IP VMS 4
988 .IX Item "VMS"
989 .RS 4
990 .PD 0
991 .IP \(bu 4
992 .PD
993 With the release of the patch kit C99 V2.0, VSI has provided support for a
994 number of previously\-missing C99 features. On systems with that patch kit
995 installed, Perl\*(Aqs configuration process will now detect the presence of the
996 header \f(CW\*(C`stdint.h\*(C'\fR and the following functions: \f(CW\*(C`fpclassify\*(C'\fR, \f(CW\*(C`isblank\*(C'\fR, \f(CW\*(C`isless\*(C'\fR,
997 \&\f(CW\*(C`llrint\*(C'\fR, \f(CW\*(C`llrintl\*(C'\fR, \f(CW\*(C`llround\*(C'\fR, \f(CW\*(C`llroundl\*(C'\fR, \f(CW\*(C`nearbyint\*(C'\fR, \f(CW\*(C`round\*(C'\fR, \f(CW\*(C`scalbn\*(C'\fR,
998 and \f(CW\*(C`scalbnl\*(C'\fR.
999 .IP \(bu 4
1000 \&\f(CW\*(C`\-Duse64bitint\*(C'\fR is now the default on VMS.
1001 .RE
1002 .RS 4
1003 .RE
1004 .IP z/OS 4
1005 .IX Item "z/OS"
1006 Perl 5.32 has been tested on z/OS 2.4, with the following caveats:
1007 .RS 4
1008 .IP \(bu 4
1009 Only static builds (the default) build reliably
1010 .IP \(bu 4
1011 When using locales, z/OS does not handle the \f(CW\*(C`LC_MESSAGES\*(C'\fR category
1012 properly, so when compiling perl, you should add the following to your
1013 \&\fIConfigure\fR options
1014 .Sp
1015 .Vb 1
1016 \& ./Configure <other options> \-Accflags=\-DNO_LOCALE_MESSAGES
1017 .Ve
1018 .IP \(bu 4
1019 z/OS does not support locales with threads, so when compiling a threaded
1020 perl, you should add the following to your \fIConfigure\fR options
1021 .Sp
1022 .Vb 1
1023 \& ./Configure <other Configure options> \-Accflags=\-DNO_LOCALE
1024 .Ve
1025 .IP \(bu 4
1026 Some CPAN modules that are shipped with perl fail at least one of their
1027 self\-tests. These are:
1028 Archive::Tar,
1029 Config::Perl::V,
1030 CPAN::Meta,
1031 CPAN::Meta::YAML,
1032 Digest::MD5,
1033 Digest::SHA,
1034 Encode,
1035 ExtUtils::MakeMaker,
1036 ExtUtils::Manifest,
1037 HTTP::Tiny,
1038 IO::Compress,
1039 IPC::Cmd,
1040 JSON::PP,
1041 libnet,
1042 MIME::Base64,
1043 Module::Metadata,
1044 PerlIO::via\-QuotedPrint,
1045 Pod::Checker,
1046 podlators,
1047 Pod::Simple,
1048 Socket,
1049 and Test::Harness.
1050 .Sp
1051 The causes of the failures range from the self\-test itself is flawed,
1052 and the module actually works fine, up to the module doesn\*(Aqt work at all
1053 on EBCDIC platforms.
1054 .RE
1055 .RS 4
1056 .RE
1057 .SH "Internal Changes"
1058 .IX Header "Internal Changes"
1059 .IP \(bu 4
1060 \&\f(CW\*(C`savepvn\*(C'\fR\*(Aqs len parameter is now a \f(CW\*(C`Size_t\*(C'\fR instead of an \f(CW\*(C`I32\*(C'\fR since we
1061 can handle longer strings than 31 bits.
1062 .IP \(bu 4
1063 The lexer (\f(CWPerl_yylex()\fR in \fItoke.c\fR) was previously a single 4100\-line
1064 function, relying heavily on \f(CW\*(C`goto\*(C'\fR and a lot of widely\-scoped local variables
1065 to do its work. It has now been pulled apart into a few dozen smaller static
1066 functions; the largest remaining chunk (\f(CWyyl_word_or_keyword()\fR) is a little
1067 over 900 lines, and consists of a single \f(CW\*(C`switch\*(C'\fR statement, all of whose
1068 \&\f(CW\*(C`case\*(C'\fR groups are independent. This should be much easier to understand and
1069 maintain.
1070 .IP \(bu 4
1071 The OS\-level signal handlers and type (Sighandler_t) used by the perl core
1072 were declared as having three parameters, but the OS was always told to
1073 call them with one argument. This has been fixed by declaring them to have
1074 one parameter. See the merge commit \f(CW\*(C`v5.31.5\-346\-g116e19abbf\*(C'\fR for full
1075 details.
1076 .IP \(bu 4
1077 The code that handles \f(CW\*(C`tr///\*(C'\fR has been extensively revised, fixing
1078 various bugs, especially when the source and/or replacement strings
1079 contain characters whose code points are above 255. Some of the bugs
1080 were undocumented, one being that under some circumstances (but not all)
1081 with \f(CW\*(C`/s\*(C'\fR, the squeezing was done based on the source, rather than the
1082 replacement. A documented bug that got fixed was
1083 [GH #14777] <https://github.com/Perl/perl5/issues/14777>.
1084 .IP \(bu 4
1085 A new macro for XS writers dealing with UTF\-8\-encoded Unicode strings
1086 has been created "\f(CW\*(C`UTF8_CHK_SKIP\*(C'\fR" in perlapi that is safer in the face
1087 of malformed UTF\-8 input than "\f(CW\*(C`UTF8_SKIP\*(C'\fR" in perlapi (but not as safe
1088 as "\f(CW\*(C`UTF8_SAFE_SKIP\*(C'\fR" in perlapi). It won\*(Aqt read past a NUL character.
1089 It has been backported in Devel::PPPort 3.55 and later.
1090 .IP \(bu 4
1091 Added the \f(CW\*(C`PL_curstackinfo\->si_cxsubix\*(C'\fR field. This records the stack index
1092 of the most recently pushed sub/format/eval context. It is set and restored
1093 automatically by \f(CWcx_pushsub()\fR, \f(CWcx_popsub()\fR etc., but would need to be
1094 manually managed if you do any unusual manipulation of the context stack.
1095 .IP \(bu 4
1096 Various macros dealing with character type classification and changing case
1097 where the input is encoded in UTF\-8 now require an extra parameter to prevent
1098 potential reads beyond the end of the buffer. Use of these has generated a
1099 deprecation warning since Perl 5.26. Details are in
1100 "In XS code, use of various macros dealing with UTF\-8." in perldeprecation
1101 .IP \(bu 4
1102 A new parser function \fBparse_subsignature()\fR
1103 allows a keyword plugin to parse a subroutine signature while \f(CWuse feature
1104 \&\*(Aqsignatures\*(Aq\fR is in effect. This allows custom keywords to implement
1105 semantics similar to regular \f(CW\*(C`sub\*(C'\fR declarations that include signatures.
1106 [GH #16261] <https://github.com/Perl/perl5/issues/16261>
1107 .IP \(bu 4
1108 Since on some platforms we need to hold a mutex when temporarily
1109 switching locales, new macros (\f(CW\*(C`STORE_LC_NUMERIC_SET_TO_NEEDED_IN\*(C'\fR,
1110 \&\f(CW\*(C`WITH_LC_NUMERIC_SET_TO_NEEDED\*(C'\fR and \f(CW\*(C`WITH_LC_NUMERIC_SET_TO_NEEDED_IN\*(C'\fR)
1111 have been added to make it easier to do this safely and efficiently
1112 as part of [GH #17034] <https://github.com/Perl/perl5/issues/17034>.
1113 .IP \(bu 4
1114 The memory bookkeeping overhead for allocating an OP structure has been
1115 reduced by 8 bytes per OP on 64\-bit systems.
1116 .IP \(bu 4
1117 \&\fBeval_pv()\fR no longer stringifies the exception when
1118 \&\f(CW\*(C`[GH #17035]|https://github.com/Perl/perl5/issues/17035\*(C'\fR]
1119 .IP \(bu 4
1120 The PERL_DESTRUCT_LEVEL environment variable was formerly only honoured on perl
1121 binaries built with DEBUGGING support. It is now checked on all perl builds.
1122 Its normal use is to force perl to individually free every block of memory
1123 which it has allocated before exiting, which is useful when using automated
1124 leak detection tools such as valgrind.
1125 .IP \(bu 4
1126 The API \fBeval_sv()\fR now accepts a \f(CW\*(C`G_RETHROW\*(C'\fR flag. If this flag is set and an
1127 exception is thrown while compiling or executing the supplied code, it will be
1128 rethrown, and \fBeval_sv()\fR will not return.
1129 [GH #17036] <https://github.com/Perl/perl5/issues/17036>
1130 .IP \(bu 4
1131 As part of the fix for
1132 [GH #1537] <https://github.com/Perl/perl5/issues/1537> \fBperl_parse()\fR
1133 now returns non\-zero if \fBexit\fR\|(0) is called in a \f(CW\*(C`BEGIN\*(C'\fR, \f(CW\*(C`UNITCHECK\*(C'\fR or
1134 \&\f(CW\*(C`CHECK\*(C'\fR block.
1135 .IP \(bu 4
1136 Most functions which recursively walked an op tree during compilation have been
1137 made non\-recursive. This avoids SEGVs from stack overflow when the op tree is
1138 deeply nested, such as \f(CW\*(C`$n == 1 ? "one" : $n == 2 ? "two" : ....\*(C'\fR (especially
1139 in code which is auto\-generated).
1140 .Sp
1141 This is particularly noticeable where the code is compiled within a separate
1142 thread, as threads tend to have small stacks by default.
1143 .SH "Selected Bug Fixes"
1144 .IX Header "Selected Bug Fixes"
1145 .IP \(bu 4
1146 Previously "require" in perlfunc would only treat the special built\-in
1147 SV \f(CW&PL_sv_undef\fR as a value in \f(CW%INC\fR as if a previous \f(CW\*(C`require\*(C'\fR
1148 has failed, treating other undefined SVs as if the previous \f(CW\*(C`require\*(C'\fR
1149 has succeeded. This could cause unexpected success from \f(CW\*(C`require\*(C'\fR
1150 e.g., on \f(CW\*(C`local %INC = %INC;\*(C'\fR. This has been fixed. [GH #17428 <https://github.com/Perl/perl5/issues/17428>]
1151 .IP \(bu 4
1152 \&\f(CW\*(C`(?{...})\*(C'\fR eval groups in regular expressions no longer unintentionally
1153 trigger "EVAL without pos change exceeded limit in regex" [GH #17490 <https://github.com/Perl/perl5/issues/17490>].
1154 .IP \(bu 4
1155 \&\f(CW\*(C`(?[...])\*(C'\fR extended bracketed character classes do not wrongly raise an
1156 error on some cases where a previously\-compiled such class is
1157 interpolated into another. The heuristics previously used have been
1158 replaced by a reliable method, and hence the diagnostics generated have
1159 changed. See "Diagnostics".
1160 .IP \(bu 4
1161 The debug display (say by specifying \f(CW\*(C`\-Dr\*(C'\fR or \f(CW\*(C`use\ re\*(C'\fR (with
1162 appropriate options) of compiled Unicode property wildcard subpatterns no
1163 longer has extraneous output.
1164 .IP \(bu 4
1165 Fix an assertion failure in the regular expression engine.
1166 [GH #17372 <https://github.com/Perl/perl5/issues/17372>]
1167 .IP \(bu 4
1168 Fix coredump in pp_hot.c after \f(CWB::UNOP_AUX::aux_list()\fR.
1169 [GH #17301 <https://github.com/Perl/perl5/issues/17301>]
1170 .IP \(bu 4
1171 Loading IO is now threadsafe.
1172 [GH #14816 <https://github.com/Perl/perl5/issues/14816>]
1173 .IP \(bu 4
1174 \&\f(CW\*(C`\ep{user\-defined}\*(C'\fR overrides official Unicode [GH #17025 <https://github.com/Perl/perl5/issues/17025>]
1175 .Sp
1176 Prior to this patch, the override was only sometimes in effect.
1177 .IP \(bu 4
1178 Properly handle filled \f(CW\*(C`/il\*(C'\fR regnodes and multi\-char folds
1179 .IP \(bu 4
1180 Compilation error during make minitest [GH #17293 <https://github.com/Perl/perl5/issues/17293>]
1181 .IP \(bu 4
1182 Move the implementation of \f(CW\*(C`%\-\*(C'\fR, \f(CW\*(C`%+\*(C'\fR into core.
1183 .IP \(bu 4
1184 Read beyond buffer in \f(CW\*(C`grok_inf_nan\*(C'\fR [GH #17370 <https://github.com/Perl/perl5/issues/17370>]
1185 .IP \(bu 4
1186 Workaround glibc bug with \f(CW\*(C`LC_MESSAGES\*(C'\fR [GH #17081 <https://github.com/Perl/perl5/issues/17081>]
1187 .IP \(bu 4
1188 \&\f(CWprintf()\fR or \f(CWsprintf()\fR with the \f(CW%n\fR format could cause a panic on
1189 debugging builds, or report an incorrectly cached length value when
1190 producing \f(CW\*(C`SVfUTF8\*(C'\fR flagged strings. [GH #17221 <https://github.com/Perl/perl5/issues/17221>]
1191 .IP \(bu 4
1192 The tokenizer has been extensively refactored.
1193 [GH #17241 <https://github.com/Perl/perl5/issues/17241>]
1194 [GH #17189 <https://github.com/Perl/perl5/issues/17189>]
1195 .IP \(bu 4
1196 \&\f(CW\*(C`use strict "subs"\*(C'\fR is now enforced for bareword constants optimized
1197 into a \f(CW\*(C`multiconcat\*(C'\fR operator. [GH #17254 <https://github.com/Perl/perl5/issues/17254>]
1198 .IP \(bu 4
1199 A memory leak in regular expression patterns has been fixed. [GH #17218 <https://github.com/Perl/perl5/issues/17218>]
1200 .IP \(bu 4
1201 Perl no longer treats strings starting with "0x" or "0b" as hex or
1202 binary numbers respectively when converting a string to a number.
1203 This reverts a change in behaviour inadvertently introduced in perl
1204 5.30.0 intended to improve precision when converting a string to a
1205 floating point number. [GH #17062] <https://github.com/Perl/perl5/issues/17062>
1206 .IP \(bu 4
1207 Matching a non\-\f(CW\*(C`SVf_UTF8\*(C'\fR string against a regular expression
1208 containing Unicode literals could leak a SV on each match attempt.
1209 [GH #17140] <https://github.com/Perl/perl5/issues/17140>
1210 .IP \(bu 4
1211 Overloads for octal and binary floating point literals were always
1212 passed a string with a \f(CW\*(C`0x\*(C'\fR prefix instead of the appropriate \f(CW0\fR or
1213 \&\f(CW\*(C`[GH #14791]|https://github.com/Perl/perl5/issues/14791\*(C'\fR]
1214 .IP \(bu 4
1215 \&\f(CW\*(C`$@ = 100; die;\*(C'\fR now correctly propagates the 100 as an exception
1216 instead of ignoring it. [GH #17098] <https://github.com/Perl/perl5/issues/17098>
1217 .IP \(bu 4
1218 \&\f(CW\*(C`[GH #17108]|https://github.com/Perl/perl5/issues/17108\*(C'\fR]
1219 .IP \(bu 4
1220 Exceptions thrown while \f(CW$@\fR is read\-only could result in infinite
1221 recursion as perl tried to update \f(CW$@\fR, which throws another
1222 exception, resulting in a stack overflow. Perl now replaces \f(CW$@\fR
1223 with a copy if it\*(Aqs not a simple writable SV. [GH #17083] <https://github.com/Perl/perl5/issues/17083>
1224 .IP \(bu 4
1225 Setting \f(CW$)\fR now properly sets supplementary group ids if you have
1226 the necessary privileges. [GH #17031] <https://github.com/Perl/perl5/issues/17031>
1227 .IP \(bu 4
1228 \&\fBclose()\fR on a pipe now preemptively clears the PerlIO object from the
1229 IO SV. This prevents a second attempt to close the already closed
1230 PerlIO object if a signal handler calls \fBdie()\fR or \fBexit()\fR while \fBclose()\fR
1231 is waiting for the child process to complete. [GH #13929] <https://github.com/Perl/perl5/issues/13929>
1232 .IP \(bu 4
1233 \&\f(CW\*(C`sprintf("%.*a", \-10000, $x)\*(C'\fR would cause a buffer overflow due
1234 to mishandling of the negative precision value. [GH #16942] <https://github.com/Perl/perl5/issues/16942>
1235 .IP \(bu 4
1236 \&\fBscalar()\fR on a reference could cause an erroneous assertion failure
1237 during compilation. [GH #16969] <https://github.com/Perl/perl5/issues/16969>
1238 .IP \(bu 4
1239 \&\f(CW\*(C`%{^CAPTURE_ALL}\*(C'\fR is now an alias to \f(CW\*(C`%\-\*(C'\fR as documented, rather than
1240 incorrectly an alias for \f(CW\*(C`[GH #16105]|https://github.com/Perl/perl5/issues/16105\*(C'\fR]
1241 .IP \(bu 4
1242 \&\f(CW\*(C`%{^CAPTURE}\*(C'\fR didn\*(Aqt work if \f(CW\*(C`@{^CAPTURE}\*(C'\fR was mentioned first.
1243 Similarly for \f(CW\*(C`%{^CAPTURE_ALL}\*(C'\fR and \f(CW\*(C`@{^CAPTURE_ALL}\*(C'\fR, though
1244 \&\f(CW\*(C`[GH #17045]|https://github.com/Perl/perl5/issues/17045\*(C'\fR]
1245 .IP \(bu 4
1246 Extraordinarily large (over 2GB) floating point format widths could
1247 cause an integer overflow in the underlying call to \fBsnprintf()\fR,
1248 resulting in an assertion. Formatted floating point widths are now
1249 limited to the range of int, the return value of \fBsnprintf()\fR.
1250 [#16881 <https://github.com/Perl/perl5/issues/16881>]
1251 .IP \(bu 4
1252 Parsing the following constructs within a sub\-parse (such as with
1253 \&\f(CW"${code here}"\fR or \f(CW\*(C`s/.../code here/e\*(C'\fR) has changed to match how
1254 they\*(Aqre parsed normally:
1255 .RS 4
1256 .IP \(bu 4
1257 \&\f(CW\*(C`print $fh ...\*(C'\fR no longer produces a syntax error.
1258 .IP \(bu 4
1259 Code like \f(CW\*(C`s/.../ ${time} /e\*(C'\fR now properly produces an "Ambiguous use
1260 of ${time} resolved to \f(CW$time\fR at ..." warning when warnings are enabled.
1261 .IP \(bu 4
1262 \&\f(CW\*(C`@x {"a"}\*(C'\fR (with the space) in a sub\-parse now properly produces a
1263 "better written as" warning when warnings are enabled.
1264 .IP \(bu 4
1265 Attributes can now be used in a sub\-parse.
1266 [GH #16847] <https://github.com/Perl/perl5/issues/16847>
1267 .RE
1268 .RS 4
1269 .RE
1270 .IP \(bu 4
1271 Incomplete hex and binary literals like \f(CW\*(C`0x\*(C'\fR and \f(CW\*(C`0b\*(C'\fR are now
1272 treated as if the \f(CW\*(C`x\*(C'\fR or \f(CW\*(C`b\*(C'\fR is part of the next token.
1273 [#17010 <https://github.com/Perl/perl5/issues/17010>]
1274 .IP \(bu 4
1275 A spurious \f(CW\*(C`)\*(C'\fR in a subparse, such as in \f(CW\*(C`s/.../code here/e\*(C'\fR or
1276 \&\f(CW"...${code here}"\fR, no longer confuses the parser.
1277 .Sp
1278 Previously a subparse was bracketed with generated \f(CW\*(C`(\*(C'\fR and \f(CW\*(C`)\*(C'\fR
1279 tokens, so a spurious \f(CW\*(C`)\*(C'\fR would close the construct without doing the
1280 normal subparse clean up, confusing the parser and possible causing an
1281 assertion failure.
1282 .Sp
1283 Such constructs are now surrounded by artificial tokens that can\*(Aqt be
1284 included in the source. [GH #15814] <https://github.com/Perl/perl5/issues/15814>
1285 .IP \(bu 4
1286 Reference assignment of a sub, such as \f(CW\*(C`\e&foo = \e&bar;\*(C'\fR, silently did
1287 nothing in the \f(CW\*(C`[GH #16987]|https://github.com/Perl/perl5/issues/16987\*(C'\fR]
1288 .IP \(bu 4
1289 \&\fBsv_gets()\fR now recovers better if the target SV is modified by a signal
1290 handler. [GH #16960] <https://github.com/Perl/perl5/issues/16960>
1291 .IP \(bu 4
1292 \&\f(CW\*(C`readline @foo\*(C'\fR now evaluates \f(CW@foo\fR in scalar context. Previously
1293 it would be evaluated in list context, and since \fBreadline()\fR pops only
1294 one argument from the stack, the stack could underflow, or be left
1295 with unexpected values on the stack. [GH #16929] <https://github.com/Perl/perl5/issues/16929>
1296 .IP \(bu 4
1297 Parsing incomplete hex or binary literals was changed in 5.31.1 to treat such a
1298 literal as just the 0, leaving the following \f(CW\*(C`x\*(C'\fR or \f(CW\*(C`b\*(C'\fR to be parsed as part
1299 of the next token. This could lead to some silent changes in behaviour, so now
1300 incomplete hex or binary literals produce a fatal error.
1301 [GH #17010] <https://github.com/Perl/perl5/issues/17010>
1302 .IP \(bu 4
1303 \&\fBeval_pv()\fR\*(Aqs \fIcroak_on_error\fR flag will now throw even if the exception is a
1304 false overloaded value.
1305 [GH #17036] <https://github.com/Perl/perl5/issues/17036>
1306 .IP \(bu 4
1307 \&\f(CW\*(C`INIT\*(C'\fR blocks and the program itself are no longer run if \fBexit\fR\|(0) is called
1308 within a \f(CW\*(C`BEGIN\*(C'\fR, \f(CW\*(C`UNITCHECK\*(C'\fR or \f(CW\*(C`CHECK\*(C'\fR block.
1309 [GH #1537] <https://github.com/Perl/perl5/issues/1537>
1310 .IP \(bu 4
1311 \&\f(CW\*(C`open my $fh, ">>+", undef\*(C'\fR now opens the temporary file in append mode:
1312 writes will seek to the end of file before writing.
1313 [GH #17058] <https://github.com/Perl/perl5/issues/17058>
1314 .IP \(bu 4
1315 Fixed a SEGV when searching for the source of an uninitialized value warning on
1316 an op whose subtree includes an OP_MULTIDEREF.
1317 [GH #17088] <https://github.com/Perl/perl5/issues/17088>
1318 .SH Obituary
1319 .IX Header "Obituary"
1320 Jeff Goff (JGOFF or DrForr), an integral part of the Perl and Raku
1321 communities and a dear friend to all of us, has passed away on March
1322 13th, 2020. DrForr was a prominent member of the communities, attending
1323 and speaking at countless events, contributing to numerous projects,
1324 and assisting and helping in any way he could.
1325 .PP
1326 His passing leaves a hole in our hearts and in our communities and he
1327 will be sorely missed.
1328 .SH Acknowledgements
1329 .IX Header "Acknowledgements"
1330 Perl 5.32.0 represents approximately 13 months of development since Perl
1331 5.30.0 and contains approximately 220,000 lines of changes across 1,800
1332 files from 89 authors.
1333 .PP
1334 Excluding auto\-generated files, documentation and release tools, there were
1335 approximately 140,000 lines of changes to 880 .pm, .t, .c and .h files.
1336 .PP
1337 Perl continues to flourish into its fourth decade thanks to a vibrant
1338 community of users and developers. The following people are known to have
1339 contributed the improvements that became Perl 5.32.0:
1340 .PP
1341 Aaron Crane, Alberto Simões, Alexandr Savca, Andreas König, Andrew Fresh,
1342 Andy Dougherty, Ask Bjørn Hansen, Atsushi Sugawara, Bernhard M. Wiedemann,
1343 brian d foy, Bryan Stenson, Chad Granum, Chase Whitener, Chris \*(AqBinGOs\*(Aq
1344 Williams, Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Book, Daniel
1345 Dragan, Dan Kogai, Dave Cross, Dave Rolsky, David Cantrell, David Mitchell,
1346 Dominic Hargreaves, E. Choroba, Felipe Gasper, Florian Weimer, Graham Knop,
1347 Håkon Hægland, Hauke D, H.Merijn Brand, Hugo van der Sanden, Ichinose
1348 Shogo, James E Keenan, Jason McIntosh, Jerome Duval, Johan Vromans, John
1349 Lightsey, John Paul Adrian Glaubitz, Kang\-min Liu, Karen Etheridge, Karl
1350 Williamson, Leon Timmermans, Manuel Mausz, Marc Green, Matthew Horsfall,
1351 Matt Turner, Max Maischein, Michael Haardt, Nicholas Clark, Nicolas R., Niko
1352 Tyni, Pali, Paul Evans, Paul Johnson, Paul Marquess, Peter Eisentraut, Peter
1353 John Acklam, Peter Oliver, Petr Písař, Renee Baecker, Ricardo Signes,
1354 Richard Leach, Russ Allbery, Samuel Smith, Santtu Ojanperä, Sawyer X,
1355 Sergey Aleynikov, Sergiy Borodych, Shirakata Kentaro, Shlomi Fish, Sisyphus,
1356 Slaven Rezic, Smylers, Stefan Seifert, Steve Hay, Steve Peters, Svyatoslav,
1357 Thibault Duponchelle, Todd Rinaldo, Tomasz Konojacki, Tom Hukins, Tony Cook,
1358 Unicode Consortium, VanL, Vickenty Fesunov, Vitali Peil, Yves Orton, Zefram.
1359 .PP
1360 The list above is almost certainly incomplete as it is automatically
1361 generated from version control history. In particular, it does not include
1362 the names of the (very much appreciated) contributors who reported issues to
1363 the Perl bug tracker.
1364 .PP
1365 Many of the changes included in this version originated in the CPAN modules
1366 included in Perl\*(Aqs core. We\*(Aqre grateful to the entire CPAN community for
1367 helping Perl to flourish.
1368 .PP
1369 For a more complete list of all of Perl\*(Aqs historical contributors, please
1370 see the \fIAUTHORS\fR file in the Perl source distribution.
1371 .SH "Reporting Bugs"
1372 .IX Header "Reporting Bugs"
1373 If you find what you think is a bug, you might check the perl bug database
1374 at <https://github.com/Perl/perl5/issues>. There may also be information at
1375 <http://www.perl.org/>, the Perl Home Page.
1376 .PP
1377 If you believe you have an unreported bug, please open an issue at
1378 <https://github.com/Perl/perl5/issues>. Be sure to trim your bug down to a
1379 tiny but sufficient test case.
1380 .PP
1381 If the bug you are reporting has security implications which make it
1382 inappropriate to send to a public issue tracker, then see
1383 "SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec
1384 for details of how to report the issue.
1385 .SH "Give Thanks"
1386 .IX Header "Give Thanks"
1387 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
1388 you can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program:
1389 .PP
1390 .Vb 1
1391 \& perlthanks
1392 .Ve
1393 .PP
1394 This will send an email to the Perl 5 Porters list with your show of thanks.
1395 .SH "SEE ALSO"
1396 .IX Header "SEE ALSO"
1397 The \fIChanges\fR file for an explanation of how to view exhaustive details on
1398 what changed.
1399 .PP
1400 The \fIINSTALL\fR file for how to build Perl.
1401 .PP
1402 The \fIREADME\fR file for general stuff.
1403 .PP
1404 The \fIArtistic\fR and \fICopying\fR files for copyright information.