Debian Codegraph @

upstream/debian-unstable/man1/perl5340delta.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 "PERL5340DELTA 1"
58 .TH PERL5340DELTA 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 perl5340delta \- what is new for perl v5.34.0
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.32.0 release and the 5.34.0
68 release.
69 .PP
70 If you are upgrading from an earlier release such as 5.30.0, first read
71 perl5320delta, which describes differences between 5.30.0 and 5.32.0.
72 .SH "Core Enhancements"
73 .IX Header "Core Enhancements"
74 .SS "Experimental Try/Catch Syntax"
75 .IX Subsection "Experimental Try/Catch Syntax"
76 An initial experimental attempt at providing \f(CW\*(C`try\*(C'\fR/\f(CW\*(C`catch\*(C'\fR notation has
77 been added.
78 .PP
79 .Vb 1
80 \& use feature \*(Aqtry\*(Aq;
81 \&
82 \& try {
83 \& a_function();
84 \& }
85 \& catch ($e) {
86 \& warn "An error occurred: $e";
87 \& }
88 .Ve
89 .PP
90 For more information, see "Try Catch Exception Handling" in perlsyn.
91 .ie n .SS """qr/{,n}/"" is now accepted"
92 .el .SS "\f(CWqr/{,n}/\fP is now accepted"
93 .IX Subsection "qr/{,n}/ is now accepted"
94 An empty lower bound is now accepted for regular expression quantifiers,
95 like \f(CW\*(C`m/x{,3}/\*(C'\fR meaning \f(CW\*(C`m/x{0,3}/\*(C'\fR
96 .SS "Blanks freely allowed within but adjacent to curly braces"
97 .IX Subsection "Blanks freely allowed within but adjacent to curly braces"
98 (in double-quotish contexts and regular expression patterns)
99 .PP
100 This means you can write things like \f(CW\*(C`\ex{\ FFFC\ }\*(C'\fR if you like. This
101 applies to all such constructs, namely \f(CW\*(C`\eb{}\*(C'\fR, \f(CW\*(C`\eg{}\*(C'\fR, \f(CW\*(C`\ek{}\*(C'\fR,
102 \&\f(CW\*(C`\eN{}\*(C'\fR, \f(CW\*(C`\eo{}\*(C'\fR, and \f(CW\*(C`\ex{}\*(C'\fR; as well as the regular expression
103 quantifier \f(CW\*(C`{\fR\f(CIm\fR\f(CW,\fR\f(CIn\fR\f(CW}\*(C'\fR. \f(CW\*(C`\ep{}\*(C'\fR and \f(CW\*(C`\eP{}\*(C'\fR retain their
104 already-existing, even looser, rules mandated by the Unicode standard
105 (see "Properties accessible through \ep{} and \eP{}" in perluniprops).
106 .PP
107 This ability is in effect regardless of the presence of the \f(CW\*(C`/x\*(C'\fR
108 regular expression pattern modifier.
109 .PP
110 Additionally, the comma in a regular expression braced quantifier may
111 have blanks (tabs or spaces) before and/or after the comma, like
112 \&\f(CW\*(C`qr/a{\ 5,\ 7\ }/\*(C'\fR.
113 .ie n .SS "New octal syntax ""0o\fIddddd\fP"""
114 .el .SS "New octal syntax \f(CW0o\fP\f(CIddddd\fP\f(CW\fP"
115 .IX Subsection "New octal syntax 0oddddd"
116 It is now possible to specify octal literals with \f(CW\*(C`0o\*(C'\fR prefixes,
117 as in \f(CW\*(C`0o123_456\*(C'\fR, parallel to the existing construct to specify
118 hexadecimal literal \f(CW\*(C`0x\fR\f(CIddddd\fR\f(CW\*(C'\fR and binary literal \f(CW\*(C`0b\fR\f(CIddddd\fR\f(CW\*(C'\fR.
119 Also, the builtin \f(CWoct()\fR function now accepts this new syntax.
120 .PP
121 See "Scalar value constructors" in perldata and "oct EXPR" in perlfunc.
122 .SH "Performance Enhancements"
123 .IX Header "Performance Enhancements"
124 .IP \(bu 4
125 Fix a memory leak in RegEx
126 [GH #18604 <https://github.com/Perl/perl5/issues/18604>]
127 .SH "Modules and Pragmata"
128 .IX Header "Modules and Pragmata"
129 .SS "New Modules and Pragmata"
130 .IX Subsection "New Modules and Pragmata"
131 .IP \(bu 4
132 ExtUtils::PL2Bat 0.004 has been added to the Perl core.
133 .Sp
134 This module is a generalization of the \f(CW\*(C`pl2bat\*(C'\fR script. It being a script has
135 led to at least two forks of this code; this module will unify them under one
136 implementation with tests.
137 .SS "Updated Modules and Pragmata"
138 .IX Subsection "Updated Modules and Pragmata"
139 .IP \(bu 4
140 Archive::Tar has been upgraded from version 2.36 to 2.38.
141 .IP \(bu 4
142 autodie has been upgraded from version 2.32 to 2.34.
143 .IP \(bu 4
144 B has been upgraded from version 1.80 to 1.82.
145 .IP \(bu 4
146 B::Deparse has been upgraded from version 1.54 to 1.56.
147 .IP \(bu 4
148 bytes has been upgraded from version 1.07 to 1.08.
149 .IP \(bu 4
150 Carp has been upgraded from version 1.50 to 1.52.
151 .IP \(bu 4
152 Compress::Raw::Bzip2 has been upgraded from version 2.093 to 2.101.
153 .IP \(bu 4
154 Compress::Raw::Zlib has been upgraded from version 2.093 to 2.101.
155 .IP \(bu 4
156 Config::Perl::V has been upgraded from version 0.32 to 0.33.
157 .IP \(bu 4
158 CPAN has been upgraded from version 2.27 to 2.28.
159 .IP \(bu 4
160 Data::Dumper has been upgraded from version 2.174 to 2.179.
161 .IP \(bu 4
162 DB has been upgraded from version 1.58 to 1.59.
163 .IP \(bu 4
164 DB_File has been upgraded from version 1.853 to 1.855.
165 .IP \(bu 4
166 Devel::Peek has been upgraded from version 1.28 to 1.30.
167 .IP \(bu 4
168 Devel::PPPort has been upgraded from version 3.57 to 3.62.
169 .Sp
170 New \f(CW\*(C`PERL_VERSION_*\*(C'\fR comparison macros are now available.
171 .Sp
172 \&\f(CW\*(C`ppport.h \-\-api\-info\*(C'\fR no longer includes non-API info unless that is the only
173 match
174 .IP \(bu 4
175 Digest has been upgraded from version 1.17_01 to 1.19.
176 .IP \(bu 4
177 Digest::MD5 has been upgraded from version 2.55_01 to 2.58.
178 .IP \(bu 4
179 DynaLoader has been upgraded from version 1.47 to 1.50.
180 .IP \(bu 4
181 Encode has been upgraded from version 3.06 to 3.08.
182 .IP \(bu 4
183 Env has been upgraded from version 1.04 to 1.05.
184 .IP \(bu 4
185 Errno has been upgraded from version 1.30 to 1.33.
186 .IP \(bu 4
187 experimental has been upgraded from version 0.020 to 0.024.
188 .IP \(bu 4
189 Exporter has been upgraded from version 5.74 to 5.76.
190 .IP \(bu 4
191 ExtUtils::CBuilder has been upgraded from version 0.280234 to 0.280236.
192 .IP \(bu 4
193 ExtUtils::Install has been upgraded from version 2.14 to 2.20.
194 .IP \(bu 4
195 ExtUtils::MakeMaker has been upgraded from version 7.44 to 7.62.
196 .IP \(bu 4
197 ExtUtils::Manifest has been upgraded from version 1.72 to 1.73.
198 .IP \(bu 4
199 ExtUtils::Miniperl has been upgraded from version 1.09 to 1.10.
200 .IP \(bu 4
201 ExtUtils::ParseXS has been upgraded from version 3.40 to 3.43.
202 .IP \(bu 4
203 ExtUtils::Typemaps has been upgraded from version 3.38 to 3.43.
204 .IP \(bu 4
205 Fcntl has been upgraded from version 1.13 to 1.14.
206 .IP \(bu 4
207 feature has been upgraded from version 1.58 to 1.64.
208 .Sp
209 Added the default enabled \f(CW\*(C`bareword_filehandles\*(C'\fR feature.
210 .Sp
211 A new multidimensional
212 feature has been added, which is enabled by
213 default but allows turning off multi-dimensional array
214 emulation.
215 .IP \(bu 4
216 File::Copy has been upgraded from version 2.34 to 2.35.
217 .IP \(bu 4
218 File::Fetch has been upgraded from version 0.56 to 1.00.
219 .IP \(bu 4
220 File::Find has been upgraded from version 1.37 to 1.39.
221 .IP \(bu 4
222 File::Path has been upgraded from version 2.16 to 2.18.
223 .IP \(bu 4
224 File::Spec has been upgraded from version 3.78 to 3.80.
225 .IP \(bu 4
226 File::Temp has been upgraded from version 0.2309 to 0.2311.
227 .IP \(bu 4
228 Filter::Util::Call has been upgraded from version 1.59 to 1.60.
229 .IP \(bu 4
230 FindBin has been upgraded from version 1.51 to 1.52.
231 .IP \(bu 4
232 GDBM_File has been upgraded from version 1.18 to 1.19.
233 .Sp
234 New functions and compatibility for newer versions of GDBM.
235 [GH #18435 <https://github.com/Perl/perl5/pull/18435>]
236 .IP \(bu 4
237 Getopt::Long has been upgraded from version 2.51 to 2.52.
238 .IP \(bu 4
239 Getopt::Std has been upgraded from version 1.12 to 1.13.
240 .IP \(bu 4
241 Hash::Util has been upgraded from version 0.23 to 0.25.
242 .IP \(bu 4
243 Hash::Util::FieldHash has been upgraded from version 1.20 to 1.21.
244 .IP \(bu 4
245 I18N::LangTags has been upgraded from version 0.44 to 0.45.
246 .IP \(bu 4
247 if has been upgraded from version 0.0608 to 0.0609.
248 .IP \(bu 4
249 IO has been upgraded from version 1.43 to 1.46.
250 .Sp
251 IO::Socket now stores error messages in \f(CW$IO::Socket::errstr\fR, in
252 addition to in \f(CW$@\fR.
253 .Sp
254 The \f(CW\*(C`error\*(C'\fR method now reports the error state for both the input and
255 output streams for sockets and character devices. Similarly
256 \&\f(CW\*(C`clearerr\*(C'\fR now clears the error state for both streams.
257 .Sp
258 A spurious error reported for regular file handles has been
259 fixed in IO::Handle.
260 [GH #18019 <https://github.com/Perl/perl5/issues/18019>]
261 .IP \(bu 4
262 IO-Compress has been upgraded from version 2.093 to 2.102.
263 .Sp
264 bin/zipdetails version 2.02
265 .IP \(bu 4
266 IO::Socket::IP has been upgraded from version 0.39 to 0.41.
267 .IP \(bu 4
268 IO::Zlib has been upgraded from version 1.10 to 1.11.
269 .IP \(bu 4
270 IPC::SysV has been upgraded from version 2.07 to 2.09.
271 .IP \(bu 4
272 JSON::PP has been upgraded from version 4.04 to 4.06.
273 .IP \(bu 4
274 The libnet distribution has been upgraded from version 3.11 to 3.13.
275 .IP \(bu 4
276 locale has been upgraded from version 1.09 to 1.10.
277 .IP \(bu 4
278 Math::Complex has been upgraded from version 1.5901 to 1.5902.
279 .IP \(bu 4
280 MIME::Base64 has been upgraded from version 3.15 to 3.16.
281 .IP \(bu 4
282 Module::CoreList has been upgraded from version 5.20200620 to 5.20210520.
283 .IP \(bu 4
284 Module::Load has been upgraded from version 0.34 to 0.36.
285 .IP \(bu 4
286 Module::Load::Conditional has been upgraded from version 0.70 to 0.74.
287 .IP \(bu 4
288 mro has been upgraded from version 1.23 to 1.25_001.
289 .IP \(bu 4
290 Net::Ping has been upgraded from version 2.72 to 2.74.
291 .IP \(bu 4
292 NEXT has been upgraded from version 0.67_01 to 0.68.
293 .IP \(bu 4
294 ODBM_File has been upgraded from version 1.16 to 1.17.
295 .IP \(bu 4
296 Opcode has been upgraded from version 1.47 to 1.50.
297 .IP \(bu 4
298 overload has been upgraded from version 1.31 to 1.33.
299 .IP \(bu 4
300 perlfaq has been upgraded from version 5.20200523 to 5.20210411.
301 .IP \(bu 4
302 PerlIO::encoding has been upgraded from version 0.28 to 0.30.
303 .IP \(bu 4
304 PerlIO::mmap has been upgraded from version 0.016 to 0.017.
305 .IP \(bu 4
306 PerlIO::scalar has been upgraded from version 0.30 to 0.31.
307 .IP \(bu 4
308 PerlIO::via::QuotedPrint has been upgraded from version 0.08 to 0.09.
309 .IP \(bu 4
310 Pod::Checker has been upgraded from version 1.73 to 1.74.
311 .IP \(bu 4
312 Pod::Html has been upgraded from version 1.25 to 1.27.
313 .IP \(bu 4
314 Pod::Simple has been upgraded from version 3.40 to 3.42.
315 .IP \(bu 4
316 Pod::Usage has been upgraded from version 1.69 to 2.01.
317 .IP \(bu 4
318 POSIX has been upgraded from version 1.94 to 1.97.
319 .Sp
320 \&\fBPOSIX::signbit()\fR behaviour has been improved.
321 [GH #18441 <https://github.com/Perl/perl5/pull/18441>]
322 .Sp
323 Documentation for \f(CW\*(C`asctime\*(C'\fR clarifies that the result is always in English.
324 (Use \f(CW\*(C`strftime\*(C'\fR for a localized result.)
325 .IP \(bu 4
326 re has been upgraded from version 0.40 to 0.41.
327 .Sp
328 (See under "Internal Changes" for more information.)
329 .IP \(bu 4
330 Safe has been upgraded from version 2.41 to 2.43.
331 .IP \(bu 4
332 Socket has been upgraded from version 2.029 to 2.031.
333 .IP \(bu 4
334 Storable has been upgraded from version 3.21 to 3.23.
335 .IP \(bu 4
336 strict has been upgraded from version 1.11 to 1.12.
337 .IP \(bu 4
338 subs has been upgraded from version 1.03 to 1.04.
339 .IP \(bu 4
340 Symbol has been upgraded from version 1.08 to 1.09.
341 .IP \(bu 4
342 Test::Harness has been upgraded from version 3.42 to 3.43.
343 .IP \(bu 4
344 Test::Simple has been upgraded from version 1.302175 to 1.302183.
345 .IP \(bu 4
346 Text::Balanced has been upgraded from version 2.03 to 2.04.
347 .IP \(bu 4
348 threads has been upgraded from version 2.25 to 2.26.
349 .IP \(bu 4
350 threads::shared has been upgraded from version 1.61 to 1.62.
351 .IP \(bu 4
352 Tie::RefHash has been upgraded from version 1.39 to 1.40.
353 .IP \(bu 4
354 Time::HiRes has been upgraded from version 1.9764 to 1.9767.
355 .IP \(bu 4
356 Time::Local has been upgraded from version 1.28 to 1.30.
357 .IP \(bu 4
358 Unicode::Collate has been upgraded from version 1.27 to 1.29.
359 .IP \(bu 4
360 Unicode::Normalize has been upgraded from version 1.27 to 1.28.
361 .IP \(bu 4
362 utf8 has been upgraded from version 1.22 to 1.24.
363 .IP \(bu 4
364 version has been upgraded from version 0.9924 to 0.9928.
365 .IP \(bu 4
366 warnings has been upgraded from version 1.47 to 1.51.
367 .IP \(bu 4
368 Win32 has been upgraded from version 0.53 to 0.57.
369 .Sp
370 Fix calling convention for \f(CW\*(C`PFNRegGetValueA\*(C'\fR.
371 .Sp
372 Added \f(CWWin32::IsSymlinkCreationAllowed()\fR,
373 \&\f(CWWin32::IsDeveloperModeEnabled()\fR, and \f(CWWin32::GetProcessPrivileges()\fR.
374 .Sp
375 Removed old code for versions before Windows 2000.
376 .IP \(bu 4
377 XS::APItest has been upgraded from version 1.09 to 1.16.
378 .IP \(bu 4
379 XS::Typemap has been upgraded from version 0.17 to 0.18.
380 .SH Documentation
381 .IX Header "Documentation"
382 .SS "New Documentation"
383 .IX Subsection "New Documentation"
384 \fIperldocstyle\fR
385 .IX Subsection "perldocstyle"
386 .PP
387 This document is a guide for the authorship and maintenance of the
388 documentation that ships with Perl.
389 .PP
390 \fIperlgov\fR
391 .IX Subsection "perlgov"
392 .PP
393 This document describes the goals, scope, system, and rules for Perl's new
394 governance model.
395 .PP
396 Other pod files, most notably perlpolicy, were amended to reflect
397 its adoption.
398 .SS "Changes to Existing Documentation"
399 .IX Subsection "Changes to Existing Documentation"
400 We have attempted to update the documentation to reflect the changes
401 listed in this document. If you find any we have missed, open an issue
402 at <https://github.com/Perl/perl5/issues>.
403 .PP
404 Additionally, the following selected changes have been made:
405 .IP \(bu 4
406 perlapi, perlguts, perlxs, and perlxstut now prefer \f(CW\*(C`SvPVbyte\*(C'\fR
407 over \f(CW\*(C`SvPV\*(C'\fR.
408 .IP \(bu 4
409 References to \fBPumpking\fR have been replaced with a more accurate term or
410 \&\fBSteering Council\fR where appropriate.
411 .IP \(bu 4
412 \&\fBThe Perl Steering Council\fR is now the fallback contact for security issues.
413 .PP
414 \fIperlapi\fR
415 .IX Subsection "perlapi"
416 .IP \(bu 4
417 Efforts continue in improving the presentation of this document, and to
418 document more API elements.
419 .PP
420 \fIperlcommunity\fR
421 .IX Subsection "perlcommunity"
422 .IP \(bu 4
423 The freenode IRC URL has been updated.
424 .PP
425 \fIperldebguts\fR
426 .IX Subsection "perldebguts"
427 .IP \(bu 4
428 Corrected the description of the scalar \f(CW\*(C`${"_<$filename"}\*(C'\fR
429 variables.
430 .PP
431 \fIperldiag\fR
432 .IX Subsection "perldiag"
433 .IP \(bu 4
434 Now documents additional examples of "not imported" warnings.
435 .PP
436 \fIperlfaq\fR
437 .IX Subsection "perlfaq"
438 .IP \(bu 4
439 The Perl FAQ was updated to CPAN version 5.20201107 with minor
440 improvements.
441 .PP
442 \fIperlfunc\fR
443 .IX Subsection "perlfunc"
444 .IP \(bu 4
445 \&\fBmy()\fR and \fBstate()\fR now explicitly warn
446 the reader that lexical variables should typically not be redeclared
447 within the same scope or statement.
448 [GH #18389 <https://github.com/Perl/perl5/issues/18389>]
449 .IP \(bu 4
450 The localtime entry has been improved and now
451 also states that the result of the function is always in English.
452 .IP \(bu 4
453 \&\fBmsgsnd()\fR documented a length field included in the
454 packed \f(CW\*(C`MSG\*(C'\fR parameter to \f(CWmsgsnd()\fR, but there was no such field.
455 \&\f(CW\*(C`MSG\*(C'\fR contains only the type and the message content.
456 .IP \(bu 4
457 Better explanation of what happens when \f(CW\*(C`sleep\*(C'\fR is called with a zero or
458 negative value.
459 .IP \(bu 4
460 Simplify the \f(CWsplit()\fR documentation by removing the \f(CWjoin()\fRs from the
461 examples
462 [GH #18676 <https://github.com/Perl/perl5/issues/18676>]
463 .PP
464 \fIperlgit\fR
465 .IX Subsection "perlgit"
466 .IP \(bu 4
467 document how to create a remote-tracking branch for every PR
468 .IP \(bu 4
469 document how to get a PR as a local branch
470 .PP
471 \fIperlguts\fR
472 .IX Subsection "perlguts"
473 .IP \(bu 4
474 perlguts now explains in greater detail the need to consult \f(CW\*(C`SvUTF8\*(C'\fR
475 when calling \f(CW\*(C`SvPV\*(C'\fR (or variants). A new "How do I pass a Perl string to a C
476 library?" section in the same document discusses when to use which style of
477 macro to read an SV's string value.
478 .IP \(bu 4
479 Corrected \f(CW\*(C`my_rpeep\*(C'\fR example in perlguts.
480 .IP \(bu 4
481 A section has been added on the formatted printing of special sizes.
482 .PP
483 \fIperlop\fR
484 .IX Subsection "perlop"
485 .IP \(bu 4
486 The \f(CW\*(C`<>\*(C'\fR and \f(CW\*(C`<<>>\*(C'\fR operators are commonly referred to as
487 the diamond and double diamond operators respectively, but that wasn't
488 mentioned previously in their documentation.
489 .IP \(bu 4
490 Document range op behavior change.
491 .PP
492 \fIperlpacktut\fR
493 .IX Subsection "perlpacktut"
494 .IP \(bu 4
495 Incorrect variables used in an example have been fixed.
496 .PP
497 \fIperlsyn\fR
498 .IX Subsection "perlsyn"
499 .IP \(bu 4
500 Document that \fBcaller()\fR does not see try{} blocks
501 .IP \(bu 4
502 A new example shows how a lexical \f(CW\*(C`my\*(C'\fR variable can be declared
503 during the initialization of a \f(CW\*(C`for\*(C'\fR loop.
504 .PP
505 \fIperlunifaq\fR
506 .IX Subsection "perlunifaq"
507 .IP \(bu 4
508 Fix description of what Perl does with unencoded strings
509 .SH Diagnostics
510 .IX Header "Diagnostics"
511 The following additions or changes have been made to diagnostic output,
512 including warnings and fatal error messages. For the complete list of
513 diagnostic messages, see perldiag.
514 .SS "New Diagnostics"
515 .IX Subsection "New Diagnostics"
516 \fINew Errors\fR
517 .IX Subsection "New Errors"
518 .IP \(bu 4
519 Bareword filehandle "%s" not allowed under 'no feature "bareword_filehandles"'
520 .Sp
521 This accompanies the new
522 bareword_filehandles feature.
523 .IP \(bu 4
524 Multidimensional hash lookup is disabled
525 .Sp
526 This accompanies the new
527 multidimensional feature.
528 .PP
529 \fINew Warnings\fR
530 .IX Subsection "New Warnings"
531 .IP \(bu 4
532 Wide character in setenv key (encoding to utf8)
533 .Sp
534 Attempts to put wide characters into environment variable keys via \f(CW%ENV\fR now
535 provoke this warning.
536 .SS "Changes to Existing Diagnostics"
537 .IX Subsection "Changes to Existing Diagnostics"
538 .IP \(bu 4
539 Error \f(CW%s\fR in expansion of \f(CW%s\fR
540 .Sp
541 An error was encountered in handling a user-defined property
542 ("User-Defined Character Properties" in perlunicode). These are
543 programmer written subroutines, hence subject to errors that may
544 prevent them from compiling or running.
545 .IP \(bu 4
546 Infinite recursion in user-defined property
547 .Sp
548 A user-defined property ("User-Defined Character Properties" in perlunicode)
549 can depend on the definitions of other user-defined
550 properties. If the chain of dependencies leads back to this property,
551 infinite recursion would occur, were it not for the check that raised
552 this error.
553 .IP \(bu 4
554 Timeout waiting for another thread to define \ep{%s}
555 .Sp
556 The first time a user-defined property
557 ("User-Defined Character Properties" in perlunicode) is used, its
558 definition is looked up and converted into an internal form for more
559 efficient handling in subsequent uses. There could be a race if two or
560 more threads tried to do this processing nearly simultaneously.
561 .IP \(bu 4
562 Unknown user-defined property name \ep{%s}
563 .Sp
564 You specified to use a property within the \f(CW\*(C`\ep{...}\*(C'\fR which was a
565 syntactically valid user-defined property, but no definition was found
566 for it
567 .IP \(bu 4
568 Too few arguments for subroutine '%s' (got \f(CW%d\fR; expected \f(CW%d\fR)
569 .Sp
570 Subroutine argument-count mismatch errors now include the number of
571 given and expected arguments.
572 .IP \(bu 4
573 Too many arguments for subroutine '%s' (got \f(CW%d\fR; expected \f(CW%d\fR)
574 .Sp
575 Subroutine argument-count mismatch errors now include the number of
576 given and expected arguments.
577 .IP \(bu 4
578 Lost precision when \f(CW%s\fR \f(CW%f\fR by 1
579 .Sp
580 This warning was only issued for positive too-large values when
581 incrementing, and only for negative ones when decrementing.
582 It is now issued for both positive or negative too-large values.
583 [GH #18333 <https://github.com/Perl/perl5/issues/18333>]
584 .IP \(bu 4
585 \&\eK not permitted in lookahead/lookbehind in regex; marked by <\-\- HERE in m/%s/
586 .Sp
587 This error was incorrectly produced in some cases involving nested
588 lookarounds. This has been fixed.
589 [GH #18123 <https://github.com/Perl/perl5/issues/18123>]
590 .IP \(bu 4
591 Use of uninitialized value%s
592 .Sp
593 This warning may now include the array or hash index when the
594 uninitialized value is the result of an element not found. This will
595 only happen if the index is a simple non-magical variable.
596 .SH "Utility Changes"
597 .IX Header "Utility Changes"
598 .SS "perl5db.pl (the debugger)"
599 .IX Subsection "perl5db.pl (the debugger)"
600 .IP \(bu 4
601 New option: \f(CW\*(C`HistItemMinLength\*(C'\fR
602 .Sp
603 This option controls the minimum length a command must be to get stored in
604 history. Traditionally, this has been fixed at 2. Changes to the debugger
605 are often perilous, and new bugs should be reported so the debugger can be
606 debugged.
607 .IP \(bu 4
608 Fix to \f(CW\*(C`i\*(C'\fR and \f(CW\*(C`l\*(C'\fR commands
609 .Sp
610 The \f(CW\*(C`i $var\*(C'\fR and \f(CW\*(C`l $var\*(C'\fR commands work again with lexical variables.
611 .SH "Configuration and Compilation"
612 .IX Header "Configuration and Compilation"
613 .IP \(bu 4
614 Prevented incpath to spill into libpth
615 .IP \(bu 4
616 Use realpath if available. (This might catch more duplicate paths.)
617 .IP \(bu 4
618 Only include real existing paths.
619 .IP \(bu 4
620 Filter inc paths out of libpth.
621 .IP \(bu 4
622 stadtx hash support has been removed
623 .Sp
624 stadtx support has been entirely removed. Previously, it could be requested
625 with \f(CW\*(C`PERL_HASH_FUNC_STADTX\*(C'\fR, and was default in 64\-bit builds. It has been
626 replaced with SipHash. SipHash has been more rigorously reviewed than stadtx.
627 .IP \(bu 4
628 Configure
629 .Sp
630 A new probe checks for buggy libc implementations of the \f(CW\*(C`gcvt\*(C'\fR/\f(CW\*(C`qgcvt\*(C'\fR
631 functions.
632 [GH #18170 <https://github.com/Perl/perl5/issues/18170>]
633 .IP \(bu 4
634 \&\f(CW\*(C`\-Dusedefaultstrict\*(C'\fR
635 .Sp
636 Perl can now be built with strict on by default (using the configuration
637 option \f(CW\*(C`\-Dusedefaultstrict\*(C'\fR.
638 .Sp
639 These strict defaults do not apply when \f(CW\*(C`perl\*(C'\fR is run via \f(CW\*(C`\-e\*(C'\fR or \f(CW\*(C`\-E\*(C'\fR.
640 .Sp
641 This setting provides a diagnostic mechanism intended for development
642 purposes only and is thus undefined by default.
643 .IP \(bu 4
644 The minimum supported Bison version is now 2.4, and the maximum is 3.7.
645 .IP \(bu 4
646 Newer 64\-bit versions of the Intel C/C++ compiler are now recognised
647 and have the correct flags set.
648 .IP \(bu 4
649 We now trap SIGBUS when \fIConfigure\fR checks for \f(CW\*(C`va_copy\*(C'\fR.
650 .Sp
651 On several systems the attempt to determine if we need \f(CW\*(C`va_copy\*(C'\fR or similar
652 results in a SIGBUS instead of the expected SIGSEGV, which previously caused a
653 core dump.
654 .Sp
655 [GH #18148 <https://github.com/Perl/perl5/issues/18148>]
656 .SH Testing
657 .IX Header "Testing"
658 Tests were added and changed to reflect the other additions and
659 changes in this release. Furthermore, these significant changes were
660 made:
661 .IP \(bu 4
662 Split Config-dependent tests in \fIt/opbasic/arith.t\fR to \fIt/op/arith2.t\fR
663 .IP \(bu 4
664 \&\fIt/re/opt.t\fR was added, providing a test harness for regexp optimization.
665 [GH #18213 <https://github.com/Perl/perl5/pull/18213>]
666 .IP \(bu 4
667 A workaround for CPAN distributions needing dot in \f(CW@INC\fR has been removed
668 [GH #18394 <https://github.com/Perl/perl5/pull/18394>].
669 All distributions that previously required the workaround have now been
670 adapted.
671 .IP \(bu 4
672 When testing in parallel on many-core platforms, you can now cause the
673 test suite to finish somewhat earlier, but with less logical ordering of
674 the tests, by setting
675 .Sp
676 .Vb 1
677 \& PERL_TEST_HARNESS_ASAP=1
678 .Ve
679 .Sp
680 while running the test suite.
681 .SH "Platform Support"
682 .IX Header "Platform Support"
683 .SS "New Platforms"
684 .IX Subsection "New Platforms"
685 .IP 9front 4
686 .IX Item "9front"
687 Allow building Perl on i386 9front systems (a fork of plan9).
688 .SS "Updated Platforms"
689 .IX Subsection "Updated Platforms"
690 .IP Plan9 4
691 .IX Item "Plan9"
692 Improve support for Plan9 on i386 platforms.
693 .IP "MacOS (Darwin)" 4
694 .IX Item "MacOS (Darwin)"
695 The hints file for darwin has been updated to handle future MacOS versions
696 beyond 10. [GH #17946 <https://github.com/Perl/perl5/issues/17946>]
697 .SS "Discontinued Platforms"
698 .IX Subsection "Discontinued Platforms"
699 .IP Symbian 4
700 .IX Item "Symbian"
701 Support code relating to Symbian has been removed. Symbian was an
702 operating system for mobile devices. The port was last updated in July
703 2009, and the platform itself in October 2012.
704 .SS "Platform-Specific Notes"
705 .IX Subsection "Platform-Specific Notes"
706 .IP DragonFlyBSD 4
707 .IX Item "DragonFlyBSD"
708 Tests were updated to workaround DragonFlyBSD bugs in tc*()
709 functions <https://bugs.dragonflybsd.org/issues/3252> and ctime
710 updates <https://bugs.dragonflybsd.org/issues/3251>.
711 .IP "Mac OS X" 4
712 .IX Item "Mac OS X"
713 A number of system libraries no longer exist as actual files on Big Sur,
714 even though \f(CW\*(C`dlopen\*(C'\fR will pretend they do, so now we fall back to \f(CW\*(C`dlopen\*(C'\fR
715 if a library file can not be found.
716 [GH #18407 <https://github.com/Perl/perl5/issues/18407>]
717 .IP Windows 4
718 .IX Item "Windows"
719 Reading non-ASCII characters from the console when its codepage was set to
720 65001 (UTF\-8) was broken due to a bug in Windows. A workaround for this
721 problem has been implemented.
722 [GH #18701 <https://github.com/Perl/perl5/issues/18701>]
723 .Sp
724 Building with mingw.org compilers (version 3.4.5 or later) using mingw runtime
725 versions < 3.22 now works again. This was broken in Perl 5.31.4.
726 .Sp
727 Building with mingw.org compilers (version 3.4.5 or later) using mingw runtime
728 versions >= 3.21 now works (for compilers up to version 5.3.0).
729 .Sp
730 \&\fIMakefile.mk\fR, and thus support for dmake, has been removed. It is still
731 possible to build Perl on Windows using nmake (Makefile) and GNU make
732 (GNUmakefile).
733 [GH #18511 <https://github.com/Perl/perl5/pull/18511>]
734 .Sp
735 perl can now be built with \f(CW\*(C`USE_QUADMATH\*(C'\fR on MS Windows using
736 (32\-bit and 64\-bit) mingw\-w64 ports of gcc.
737 [GH #18465 <https://github.com/Perl/perl5/pull/18465>]
738 .Sp
739 The \fIpl2bat.pl\fR utility now needs to \f(CW\*(C`use ExtUtils::PL2Bat\*(C'\fR. This could
740 cause failures in parallel builds.
741 .Sp
742 Windows now supports \fBsymlink()\fR and
743 \&\fBreadlink()\fR, and \fBlstat()\fR is no
744 longer an alias for \fBstat()\fR.
745 [GH #18005 <https://github.com/Perl/perl5/issues/18005>].
746 .Sp
747 Unlike POSIX systems, creating a symbolic link on Windows requires
748 either elevated privileges or Windows 10 1703 or later with Developer
749 Mode enabled.
750 .Sp
751 \&\fBstat()\fR, including \f(CW\*(C`stat FILEHANDLE\*(C'\fR, and \fBlstat()\fR now uses our own
752 implementation that populates the device \f(CW\*(C`dev\*(C'\fR and inode numbers
753 \&\f(CW\*(C`ino\*(C'\fR returned rather than always returning zero. The number of
754 links \f(CW\*(C`nlink\*(C'\fR field is now always populated.
755 .Sp
756 \&\f(CW\*(C`${^WIN32_SLOPPY_STAT}\*(C'\fR previously
757 controlled whether the \f(CW\*(C`nlink\*(C'\fR field was populated requiring a
758 separate Windows API call to fetch, since \f(CW\*(C`nlink\*(C'\fR and the other
759 information required for \f(CWstat()\fR is now retrieved in a single API call.
760 .Sp
761 The \f(CW\*(C`\-r\*(C'\fR and \f(CW\*(C`\-w\*(C'\fR operators now return true for the \f(CW\*(C`STDIN\*(C'\fR,
762 \&\f(CW\*(C`STDOUT\*(C'\fR and \f(CW\*(C`STDERR\*(C'\fR handles. Unfortunately it still won't return
763 true for duplicates of those handles.
764 [GH #8502 <https://github.com/Perl/perl5/issues/8502>].
765 .Sp
766 The times returned by \fBstat()\fR and \fBlstat()\fR are no longer incorrect
767 across Daylight Savings Time adjustments.
768 [GH #6080 <https://github.com/Perl/perl5/issues/6080>].
769 .Sp
770 \&\f(CW\*(C`\-x\*(C'\fR on a filehandle should now match \f(CW\*(C`\-x\*(C'\fR on the corresponding
771 filename on Vista or later.
772 [GH #4145 <https://github.com/Perl/perl5/issues/4145>].
773 .Sp
774 \&\f(CW\*(C`\-e \*(Aq"\*(Aq\*(C'\fR no longer incorrectly returns true.
775 [GH #12431 <https://github.com/Perl/perl5/issues/12431>].
776 .Sp
777 The same manifest is now used for Visual C++ and gcc builds.
778 .Sp
779 Previously, MSVC builds were using the \fB/manifestdependency\fR flag instead of
780 embedding \fIperlexe.manifest\fR, which caused issues such as \f(CWGetVersionEx()\fR
781 returning the wrong version number on Windows 10.
782 .IP z/OS 4
783 .IX Item "z/OS"
784 The locale categories \f(CW\*(C`LC_SYNTAX\*(C'\fR and \f(CW\*(C`LC_TOD\*(C'\fR are now recognized.
785 Perl doesn't do anything with these, except it now allows you to specify
786 them. They are included in \f(CW\*(C`LC_ALL\*(C'\fR.
787 .SH "Internal Changes"
788 .IX Header "Internal Changes"
789 .IP \(bu 4
790 Corrected handling of double and long double parameters for perl's
791 implementation of formatted output for \f(CW\*(C`\-Dusequadmath\*(C'\fR builds.
792 .Sp
793 This applies to \f(CWPerlIO_printf()\fR, \f(CWcroak()\fR, \f(CWwarn()\fR, \f(CWsv_catpvf()\fR and
794 their variants.
795 .Sp
796 Previously in \f(CW\*(C`quadmath\*(C'\fR builds, code like:
797 .Sp
798 .Vb 1
799 \& PerlIO_printf(PerlIO_stderr(), "%g", somedouble);
800 .Ve
801 .Sp
802 or
803 .Sp
804 .Vb 1
805 \& PerlIO_printf(PerlIO_stderr(), "%Lg", somelongdouble);
806 .Ve
807 .Sp
808 would erroneously throw an exception "panic: quadmath invalid format
809 \&...", since the code added for quadmath builds assumed \f(CW\*(C`NV\*(C'\fRs were the
810 only floating point format passed into these functions.
811 .Sp
812 This code would also process the standard C long double specifier \f(CW\*(C`L\*(C'\fR
813 as if it expected an \f(CW\*(C`NV\*(C'\fR (\f(CW\*(C`_\|_float128\*(C'\fR for quadmath builds),
814 resulting in undefined behaviour.
815 .Sp
816 These functions now correctly accept doubles, long doubles and NVs.
817 .IP \(bu 4
818 Previously the right operand of bitwise shift operators (shift amount)
819 was implicitly cast from IV to int, but it might lead wrong results
820 if IV does not fit in int.
821 .Sp
822 And also, shifting INT_MIN bits used to yield the shiftee unchanged
823 (treated as 0\-bit shift instead of negative shift).
824 .IP \(bu 4
825 A set of \f(CW\*(C`cop_hints_exists_{pv,pvn,pvs,sv}\*(C'\fR functions was added,
826 to support checking for the existence of keys in the hints hash of a
827 specific cop without needing to create a mortal copy of said value.
828 .IP \(bu 4
829 An aid has been added for using the \f(CW\*(C`DEBUG\*(C'\fR macros when debugging XS or
830 C code. The comments in \fIperl.h\fR describe \f(CW\*(C`DEBUG_PRE_STMTS\*(C'\fR and
831 \&\f(CW\*(C`DEBUG_POST_STMTS\*(C'\fR. which you can \f(CW\*(C`#define\*(C'\fR to do things like save and
832 restore \f(CW\*(C`errno\*(C'\fR, in case the \f(CW\*(C`DEBUG\*(C'\fR calls are interfering with that,
833 or to display timestamps, or which thread it's coming from, or the
834 location of the call, or whatever. You can make a quick hack to help
835 you track something down without having to edit individual \f(CW\*(C`DEBUG\*(C'\fR
836 calls.
837 .IP \(bu 4
838 Make \f(CW\*(C`REFCOUNTED_HE_EXISTS\*(C'\fR available outside of core
839 .IP \(bu 4
840 All \f(CW\*(C`SvTRUE\*(C'\fR\-ish functions now evaluate their arguments exactly once.
841 In 5.32, plain "\f(CW\*(C`SvTRUE\*(C'\fR" in perlapi was changed to do that; now the rest
842 do as well.
843 .IP \(bu 4
844 Unicode is now a first class citizen when considering the pattern /A*B/ where
845 A and B are arbitrary. The pattern matching code tries to make a tight loop
846 to match the span of A's. The logic of this was now really updated with
847 support for UTF\-8.
848 .IP \(bu 4
849 The re module has a new function \f(CW\*(C`optimization\*(C'\fR, which can return a
850 hashref of optimization data discovered about a compiled regexp.
851 .IP \(bu 4
852 The \f(CW\*(C`PERL_GLOBAL_STRUCT\*(C'\fR compilation option has been removed, and
853 with it the need or the \f(CW\*(C`dVAR\*(C'\fR macro. \f(CW\*(C`dVAR\*(C'\fR remains defined as a
854 no-op outside \f(CW\*(C`PERL_CORE\*(C'\fR for backwards compatiblity with XS modules.
855 .IP \(bu 4
856 A new savestack type \f(CW\*(C`SAVEt_HINTS_HH\*(C'\fR has been added, which neatens the
857 previous behaviour of \f(CW\*(C`SAVEt_HINTS\*(C'\fR. On previous versions the types and
858 values pushed to the save stack would depend on whether the hints included the
859 \&\f(CW\*(C`HINT_LOCALIZE_HH\*(C'\fR bit, which complicates external code that inspects the
860 save stack. The new version uses a different savestack type to indicate the
861 difference.
862 .IP \(bu 4
863 A new API function "av_count" in perlapi has been added which gives a
864 clearly named way to find how many elements are in an array.
865 .SH "Selected Bug Fixes"
866 .IX Header "Selected Bug Fixes"
867 .IP \(bu 4
868 Setting \f(CW%ENV\fR now properly handles upgraded strings in the key. Previously
869 Perl sent the SV's internal PV directly to the OS; now it will handle keys
870 as it has handled values since 5.18: attempt to downgrade the string first;
871 if that fails then warn and use the utf8 form.
872 .IP \(bu 4
873 Fix a memory leak in regcomp.c
874 [GH #18604 <https://github.com/Perl/perl5/issues/18604>]
875 .IP \(bu 4
876 pack/unpack format 'D' now works on all systems that could support it
877 .Sp
878 Previously if \f(CW\*(C`NV == long double\*(C'\fR, now it is supported on all platforms that
879 have long doubles. In particular that means it is now also supported on
880 quadmath platforms.
881 .IP \(bu 4
882 Skip trying to constant fold an incomplete op tree
883 [GH #18380 <https://github.com/Perl/perl5/issues/18380>]
884 .Sp
885 Constant folding of chained comparison op trees could fail under certain
886 conditions, causing perl to crash. As a quick fix, constant folding is
887 now skipped for such op trees. This also addresses
888 [GH #17917 <https://github.com/Perl/perl5/issues/17917>].
889 .IP \(bu 4
890 \&\f(CW%g\fR formatting broken on Ubuntu\-18.04, \f(CW\*(C`NVSIZE == 8\*(C'\fR
891 [GH #18170 <https://github.com/Perl/perl5/issues/18170>]
892 .Sp
893 Buggy libc implementations of the \f(CW\*(C`gcvt\*(C'\fR and \f(CW\*(C`qgcvt\*(C'\fR functions
894 caused \f(CW\*(C`(s)printf\*(C'\fR to incorrectly truncate \f(CW%g\fR formatted numbers.
895 A new Configure probe now checks for this, with the result that the libc
896 \&\f(CW\*(C`sprintf\*(C'\fR will be used in place of \f(CW\*(C`gcvt\*(C'\fR and \f(CW\*(C`qgcvt\*(C'\fR.
897 .Sp
898 Tests added as part of this fix also revealed related problems in
899 some Windows builds. The makefiles for MINGW builds on Windows have
900 thus been adjusted to use \f(CW\*(C`USE_MINGW_ANSI_STDIO\*(C'\fR by default, ensuring
901 that they also provide correct \f(CW\*(C`(s)printf\*(C'\fR formatting of numbers.
902 .IP \(bu 4
903 \&\fIop.c\fR: croak on \f(CW\*(C`my $_\*(C'\fR when \f(CW\*(C`use utf8\*(C'\fR is in effect
904 [GH #18449 <https://github.com/Perl/perl5/issues/18449>]
905 .Sp
906 The lexical topic feature experiment was removed in Perl v5.24 and
907 declaring \f(CW\*(C`my $_\*(C'\fR became a compile time error. However, it was previously
908 still possible to make this declaration if \f(CW\*(C`use utf8\*(C'\fR was in effect.
909 .IP \(bu 4
910 \&\fIregexec.c\fR: Fix assertion failure
911 [GH #18451 <https://github.com/Perl/perl5/issues/18451>]
912 .Sp
913 Fuzzing triggered an assertion failure in the regexp engine when too many
914 characters were copied into a buffer.
915 .IP \(bu 4
916 \&\fBsemctl()\fR, \fBmsgctl()\fR, and
917 \&\fBshmctl()\fR now properly reset the UTF\-8 flag on the
918 \&\f(CW\*(C`ARG\*(C'\fR parameter if it's modified for \f(CW\*(C`IPC_STAT\*(C'\fR or \f(CW\*(C`GETALL\*(C'\fR
919 operations.
920 .IP \(bu 4
921 \&\f(CWsemctl()\fR, \f(CWmsgctl()\fR, and \f(CWshmctl()\fR now attempt to downgrade the \f(CW\*(C`ARG\*(C'\fR
922 parameter if its value is being used as input to \f(CW\*(C`IPC_SET\*(C'\fR or
923 \&\f(CW\*(C`SETALL\*(C'\fR calls. A failed downgrade will thrown an exception.
924 .IP \(bu 4
925 In cases where \f(CWsemctl()\fR, \f(CWmsgctl()\fR or \f(CWshmctl()\fR would treat the \f(CW\*(C`ARG\*(C'\fR
926 parameter as a pointer, an undefined value no longer generates a
927 warning. In most such calls the pointer isn't used anyway and this
928 allows you to supply \f(CW\*(C`undef\*(C'\fR for a value not used by the underlying
929 function.
930 .IP \(bu 4
931 \&\fBsemop()\fR now downgrades the \f(CW\*(C`OPSTRING\*(C'\fR parameter,
932 \&\fBmsgsnd()\fR now downgrades the \f(CW\*(C`MSG\*(C'\fR parameter and
933 shmwrite now downgrades the \f(CW\*(C`STRING\*(C'\fR parameter
934 to treat them as bytes. Previously they would be left upgraded,
935 providing a corrupted structure to the underlying function call.
936 .IP \(bu 4
937 \&\fBmsgrcv()\fR now properly resets the UTF\-8 flag the
938 \&\f(CW\*(C`VAR\*(C'\fR parameter when it is modified. Previously the UTF\-8 flag could
939 be left on, resulting in a possibly corrupt result in \f(CW\*(C`VAR\*(C'\fR.
940 .IP \(bu 4
941 Magic is now called correctly for stacked file test operators.
942 [GH #18293 <https://github.com/Perl/perl5/issues/18293>]
943 .IP \(bu 4
944 The \f(CW\*(C`@ary = split(...)\*(C'\fR optimization no longer switches in the target
945 array as the value stack.
946 [GH #18232 <https://github.com/Perl/perl5/issues/18232>]
947 Also see discussion at
948 <https://github.com/Perl/perl5/pull/18014#issuecomment\-671299506>.
949 .IP \(bu 4
950 Fixed a bug in which some regexps with recursive subpatterns matched
951 incorrectly.
952 .Sp
953 [GH #18096 <https://github.com/Perl/perl5/issues/18096>]
954 .IP \(bu 4
955 On Win32, \f(CW\*(C`waitpid(\-1, WNOHANG)\*(C'\fR could sometimes have a very large
956 timeout. [GH #16529 <https://github.com/Perl/perl5/issues/16529>]
957 .IP \(bu 4
958 \&\f(CW\*(C`MARK\*(C'\fR and hence \f(CW\*(C`items\*(C'\fR are now correctly initialized in \f(CW\*(C`BOOT\*(C'\fR XSUBs.
959 .IP \(bu 4
960 Some list assignments involving \f(CW\*(C`undef\*(C'\fR on the left-hand side were
961 over-optimized and produced incorrect results.
962 [GH #16685 <https://github.com/Perl/perl5/issues/16685>],
963 [GH #17816 <https://github.com/Perl/perl5/issues/17816>]
964 .SH "Known Problems"
965 .IX Header "Known Problems"
966 None
967 .SH "Errata From Previous Releases"
968 .IX Header "Errata From Previous Releases"
969 None
970 .SH Obituary
971 .IX Header "Obituary"
972 Kent Fredric (KENTNL) passed away in February 2021. A native of New Zealand
973 and a self-described "huge geek," Kent was the author or maintainer of 178
974 CPAN distributions, the Perl maintainer for the Gentoo Linux distribution and
975 a contributor to the Perl core distribution. He is mourned by his family,
976 friends and open source software communities worldwide.
977 .SH Acknowledgements
978 .IX Header "Acknowledgements"
979 Perl 5.34.0 represents approximately 11 months of development since Perl
980 5.32.0 and contains approximately 280,000 lines of changes across 2,100
981 files from 78 authors.
982 .PP
983 Excluding auto-generated files, documentation and release tools, there were
984 approximately 150,000 lines of changes to 1,300 .pm, .t, .c and .h files.
985 .PP
986 Perl continues to flourish into its fourth decade thanks to a vibrant
987 community of users and developers. The following people are known to have
988 contributed the improvements that became Perl 5.34.0:
989 .PP
990 Aaron Crane, Adam Hartley, Andy Dougherty, Ben Cornett, Branislav
991 Zahradník, brian d foy, Chris 'BinGOs' Williams, Christian Walde
992 (Mithaldu), Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Book, Daniel
993 Böhmer, Daniel Laügt, Dan Kogai, David Cantrell, David Mitchell, Dominic
994 Hamon, E. Choroba, Ed J, Eric Herman, Eugene Alvin Villar,
995 Felipe Gasper, Giovanni Tataranni, Graham Knop, Graham Ollis, Hauke D,
996 H.Merijn Brand, Hugo van der Sanden, Ichinose Shogo, Ivan Baidakou, Jae
997 Bradley, James E Keenan, Jason McIntosh, jkahrman, John Karr, John Lightsey,
998 Kang-min Liu, Karen Etheridge, Karl Williamson, Keith Thompson, Leon
999 Timmermans, Marc Reisner, Marcus Holland-Moritz, Max Maischein, Michael G
1000 Schwern, Nicholas Clark, Nicolas R., Paul Evans, Petr Písař, raiph, Renee
1001 Baecker, Ricardo Signes, Richard Leach, Romano, Ryan Voots, Samanta Navarro,
1002 Samuel Thibault, Sawyer X, Scott Baker, Sergey Poznyakoff, Sevan Janiyan,
1003 Shirakata Kentaro, Shlomi Fish, Sisyphus, Sizhe Zhao, Steve Hay, TAKAI
1004 Kousuke, Thibault Duponchelle, Todd Rinaldo, Tomasz Konojacki, Tom Hukins,
1005 Tom Stellard, Tony Cook, vividsnow, Yves Orton, Zakariyya Mughal,
1006 Михаил Козачков.
1007 .PP
1008 The list above is almost certainly incomplete as it is automatically
1009 generated from version control history. In particular, it does not include
1010 the names of the (very much appreciated) contributors who reported issues to
1011 the Perl bug tracker.
1012 .PP
1013 Many of the changes included in this version originated in the CPAN modules
1014 included in Perl's core. We're grateful to the entire CPAN community for
1015 helping Perl to flourish.
1016 .PP
1017 For a more complete list of all of Perl's historical contributors, please
1018 see the \fIAUTHORS\fR file in the Perl source distribution.
1019 .SH "Reporting Bugs"
1020 .IX Header "Reporting Bugs"
1021 If you find what you think is a bug, you might check the perl bug database
1022 at <https://github.com/Perl/perl5/issues>. There may also be information at
1023 <http://www.perl.org/>, the Perl Home Page.
1024 .PP
1025 If you believe you have an unreported bug, please open an issue at
1026 <https://github.com/Perl/perl5/issues>. Be sure to trim your bug down to a
1027 tiny but sufficient test case.
1028 .PP
1029 If the bug you are reporting has security implications which make it
1030 inappropriate to send to a public issue tracker, then see
1031 "SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec
1032 for details of how to report the issue.
1033 .SH "Give Thanks"
1034 .IX Header "Give Thanks"
1035 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
1036 you can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program:
1037 .PP
1038 .Vb 1
1039 \& perlthanks
1040 .Ve
1041 .PP
1042 This will send an email to the Perl 5 Porters list with your show of thanks.
1043 .SH "SEE ALSO"
1044 .IX Header "SEE ALSO"
1045 The \fIChanges\fR file for an explanation of how to view exhaustive details on
1046 what changed.
1047 .PP
1048 The \fIINSTALL\fR file for how to build Perl.
1049 .PP
1050 The \fIREADME\fR file for general stuff.
1051 .PP
1052 The \fIArtistic\fR and \fICopying\fR files for copyright information.