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