| 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. |