Debian Codegraph @

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