| 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 "PERL5300DELTA 1" |
| 58 |
.TH PERL5300DELTA 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 |
perl5300delta \- what is new for perl v5.30.0 |
| 65 |
.SH DESCRIPTION |
| 66 |
.IX Header "DESCRIPTION" |
| 67 |
This document describes differences between the 5.28.0 release and the 5.30.0 |
| 68 |
release. |
| 69 |
.PP |
| 70 |
If you are upgrading from an earlier release such as 5.26.0, first read |
| 71 |
perl5280delta, which describes differences between 5.26.0 and 5.28.0. |
| 72 |
.SH Notice |
| 73 |
.IX Header "Notice" |
| 74 |
sv_utf8_(downgrade|decode) are no longer marked as experimental. |
| 75 |
[GH #16822] <https://github.com/Perl/perl5/issues/16822>. |
| 76 |
.SH "Core Enhancements" |
| 77 |
.IX Header "Core Enhancements" |
| 78 |
.SS "Limited variable length lookbehind in regular expression pattern matching is now experimentally supported" |
| 79 |
.IX Subsection "Limited variable length lookbehind in regular expression pattern matching is now experimentally supported" |
| 80 |
Using a lookbehind assertion (like \f(CW\*(C`(?<=foo?)\*(C'\fR or \f(CW\*(C`(?<!ba{1,9}r)\*(C'\fR previously |
| 81 |
would generate an error and refuse to compile. Now it compiles (if the |
| 82 |
maximum lookbehind is at most 255 characters), but raises a warning in |
| 83 |
the new \f(CW\*(C`experimental::vlb\*(C'\fR warnings category. This is to caution you |
| 84 |
that the precise behavior is subject to change based on feedback from |
| 85 |
use in the field. |
| 86 |
.PP |
| 87 |
See "(?<=pattern)" in perlre and "(?<!pattern)" in perlre. |
| 88 |
.ie n .SS "The upper limit ""n"" specifiable in a regular expression quantifier of the form ""{m,n}"" has been doubled to 65534" |
| 89 |
.el .SS "The upper limit \f(CW""n""\fP specifiable in a regular expression quantifier of the form \f(CW""{m,n}""\fP has been doubled to 65534" |
| 90 |
.IX Subsection "The upper limit ""n"" specifiable in a regular expression quantifier of the form ""{m,n}"" has been doubled to 65534" |
| 91 |
The meaning of an unbounded upper quantifier \f(CW"{m,}"\fR remains unchanged. |
| 92 |
It matches 2**31 \- 1 times on most platforms, and more on ones where a C |
| 93 |
language short variable is more than 4 bytes long. |
| 94 |
.SS "Unicode 12.1 is supported" |
| 95 |
.IX Subsection "Unicode 12.1 is supported" |
| 96 |
Because of a change in Unicode release cycles, Perl jumps from Unicode |
| 97 |
10.0 in Perl 5.28 to Unicode 12.1 in Perl 5.30. |
| 98 |
.PP |
| 99 |
For details on the Unicode changes, see |
| 100 |
<https://www.unicode.org/versions/Unicode11.0.0/> for 11.0; |
| 101 |
<https://www.unicode.org/versions/Unicode12.0.0/> for 12.0; |
| 102 |
and |
| 103 |
<https://www.unicode.org/versions/Unicode12.1.0/> for 12.1. |
| 104 |
(Unicode 12.1 differs from 12.0 only in the addition of a single |
| 105 |
character, that for the new Japanese era name.) |
| 106 |
.PP |
| 107 |
The Word_Break property, as in past Perl releases, remains tailored to |
| 108 |
behave more in line with expectations of Perl users. This means that |
| 109 |
sequential runs of horizontal white space characters are not broken |
| 110 |
apart, but kept as a single run. Unicode 11 changed from past versions |
| 111 |
to be more in line with Perl, but it left several white space characters |
| 112 |
as causing breaks: TAB, NO BREAK SPACE, and FIGURE SPACE (U+2007). We |
| 113 |
have decided to continue to use the previous Perl tailoring with regards |
| 114 |
to these. |
| 115 |
.SS "Wildcards in Unicode property value specifications are now partially supported" |
| 116 |
.IX Subsection "Wildcards in Unicode property value specifications are now partially supported" |
| 117 |
You can now do something like this in a regular expression pattern |
| 118 |
.PP |
| 119 |
.Vb 1 |
| 120 |
\& qr! \ep{nv= /(?x) \eA [0\-5] \ez / }! |
| 121 |
.Ve |
| 122 |
.PP |
| 123 |
which matches all Unicode code points whose numeric value is |
| 124 |
between 0 and 5 inclusive. So, it could match the Thai or Bengali |
| 125 |
digits whose numeric values are 0, 1, 2, 3, 4, or 5. |
| 126 |
.PP |
| 127 |
This marks another step in implementing the regular expression features |
| 128 |
the Unicode Consortium suggests. |
| 129 |
.PP |
| 130 |
Most properties are supported, with the remainder planned for 5.32. |
| 131 |
Details are in "Wildcards in Property Values" in perlunicode. |
| 132 |
.SS "qr'\eN{name}' is now supported" |
| 133 |
.IX Subsection "qr'N{name}' is now supported" |
| 134 |
Previously it was an error to evaluate a named character \f(CW\*(C`\eN{...}\*(C'\fR |
| 135 |
within a single quoted regular expression pattern (whose evaluation is |
| 136 |
deferred from the normal place). This restriction is now removed. |
| 137 |
.SS "Turkic UTF\-8 locales are now seamlessly supported" |
| 138 |
.IX Subsection "Turkic UTF-8 locales are now seamlessly supported" |
| 139 |
Turkic languages have different casing rules than other languages for |
| 140 |
the characters \f(CW"i"\fR and \f(CW"I"\fR. The uppercase of \f(CW"i"\fR is LATIN |
| 141 |
CAPITAL LETTER I WITH DOT ABOVE (U+0130); and the lowercase of \f(CW"I"\fR is LATIN |
| 142 |
SMALL LETTER DOTLESS I (U+0131). Unicode furnishes alternate casing |
| 143 |
rules for use with Turkic languages. Previously, Perl ignored these, |
| 144 |
but now, it uses them when it detects that it is operating under a |
| 145 |
Turkic UTF\-8 locale. |
| 146 |
.SS "It is now possible to compile perl to always use thread-safe locale operations" |
| 147 |
.IX Subsection "It is now possible to compile perl to always use thread-safe locale operations" |
| 148 |
Previously, these calls were only used when the perl was compiled to be |
| 149 |
multi-threaded. To always enable them, add |
| 150 |
.PP |
| 151 |
.Vb 1 |
| 152 |
\& \-Accflags=\*(Aq\-DUSE_THREAD_SAFE_LOCALE\*(Aq |
| 153 |
.Ve |
| 154 |
.PP |
| 155 |
to your \fIConfigure\fR flags. |
| 156 |
.SS "Eliminate opASSIGN macro usage from core" |
| 157 |
.IX Subsection "Eliminate opASSIGN macro usage from core" |
| 158 |
This macro is still defined but no longer used in core |
| 159 |
.ie n .SS """\-Drv"" now means something on ""\-DDEBUGGING"" builds" |
| 160 |
.el .SS "\f(CW\-Drv\fP now means something on \f(CW\-DDEBUGGING\fP builds" |
| 161 |
.IX Subsection "-Drv now means something on -DDEBUGGING builds" |
| 162 |
Now, adding the verbose flag (\f(CW\*(C`\-Dv\*(C'\fR) to the \f(CW\*(C`\-Dr\*(C'\fR flag turns on all |
| 163 |
possible regular expression debugging. |
| 164 |
.SH "Incompatible Changes" |
| 165 |
.IX Header "Incompatible Changes" |
| 166 |
.ie n .SS "Assigning non-zero to $[ is fatal" |
| 167 |
.el .SS "Assigning non-zero to \f(CW$[\fP is fatal" |
| 168 |
.IX Subsection "Assigning non-zero to $[ is fatal" |
| 169 |
Setting \f(CW$[\fR to a non-zero value has been deprecated since |
| 170 |
Perl 5.12 and now throws a fatal error. |
| 171 |
See "Assigning non-zero to \f(CW$[\fR is fatal" in perldeprecation. |
| 172 |
.SS "Delimiters must now be graphemes" |
| 173 |
.IX Subsection "Delimiters must now be graphemes" |
| 174 |
See "Use of unassigned code point or non-standalone grapheme |
| 175 |
for a delimiter." in perldeprecation |
| 176 |
.ie n .SS "Some formerly deprecated uses of an unescaped left brace ""{"" in regular expression patterns are now illegal" |
| 177 |
.el .SS "Some formerly deprecated uses of an unescaped left brace \f(CW""{""\fP in regular expression patterns are now illegal" |
| 178 |
.IX Subsection "Some formerly deprecated uses of an unescaped left brace ""{"" in regular expression patterns are now illegal" |
| 179 |
But to avoid breaking code unnecessarily, most instances that issued a |
| 180 |
deprecation warning, remain legal and now have a non-deprecation warning |
| 181 |
raised. See "Unescaped left braces in regular expressions" in perldeprecation. |
| 182 |
.SS "Previously deprecated \fBsysread()\fP/\fBsyswrite()\fP on :utf8 handles is now fatal" |
| 183 |
.IX Subsection "Previously deprecated sysread()/syswrite() on :utf8 handles is now fatal" |
| 184 |
Calling \fBsysread()\fR, \fBsyswrite()\fR, \fBsend()\fR or \fBrecv()\fR on a \f(CW\*(C`:utf8\*(C'\fR handle, |
| 185 |
whether applied explicitly or implicitly, is now fatal. This was |
| 186 |
deprecated in perl 5.24. |
| 187 |
.PP |
| 188 |
There were two problems with calling these functions on \f(CW\*(C`:utf8\*(C'\fR |
| 189 |
handles: |
| 190 |
.IP \(bu 4 |
| 191 |
All four functions only paid attention to the \f(CW\*(C`:utf8\*(C'\fR flag. Other |
| 192 |
layers were completely ignored, so a handle with |
| 193 |
\&\f(CW:encoding(UTF\-16LE)\fR layer would be treated as UTF\-8. Other layers, |
| 194 |
such as compression are completely ignored with or without the |
| 195 |
\&\f(CW\*(C`:utf8\*(C'\fR flag. |
| 196 |
.IP \(bu 4 |
| 197 |
\&\fBsysread()\fR and \fBrecv()\fR would read from the handle, skipping any |
| 198 |
validation by the layers, and do no validation of their own. This |
| 199 |
could lead to invalidly encoded perl scalars. |
| 200 |
.PP |
| 201 |
[GH #14839] <https://github.com/Perl/perl5/issues/14839>. |
| 202 |
.SS "\fBmy()\fP in false conditional prohibited" |
| 203 |
.IX Subsection "my() in false conditional prohibited" |
| 204 |
Declarations such as \f(CW\*(C`my $x if 0\*(C'\fR are no longer permitted. |
| 205 |
.PP |
| 206 |
[GH #16702] <https://github.com/Perl/perl5/issues/16702>. |
| 207 |
.SS "Fatalize $* and $#" |
| 208 |
.IX Subsection "Fatalize $* and $#" |
| 209 |
These special variables, long deprecated, now throw exceptions when used. |
| 210 |
.PP |
| 211 |
[GH #16718] <https://github.com/Perl/perl5/issues/16718>. |
| 212 |
.SS "Fatalize unqualified use of \fBdump()\fP" |
| 213 |
.IX Subsection "Fatalize unqualified use of dump()" |
| 214 |
The \f(CWdump()\fR function, long discouraged, may no longer be used unless it is |
| 215 |
fully qualified, \fIi.e.\fR, \f(CWCORE::dump()\fR. |
| 216 |
.PP |
| 217 |
[GH #16719] <https://github.com/Perl/perl5/issues/16719>. |
| 218 |
.SS "Remove \fBFile::Glob::glob()\fP" |
| 219 |
.IX Subsection "Remove File::Glob::glob()" |
| 220 |
The \f(CWFile::Glob::glob()\fR function, long deprecated, has been removed and now |
| 221 |
throws an exception which advises use of \f(CWFile::Glob::bsd_glob()\fR instead. |
| 222 |
.PP |
| 223 |
[GH #16721] <https://github.com/Perl/perl5/issues/16721>. |
| 224 |
.ie n .SS "pack() no longer can return malformed UTF\-8" |
| 225 |
.el .SS "\f(CWpack()\fP no longer can return malformed UTF\-8" |
| 226 |
.IX Subsection "pack() no longer can return malformed UTF-8" |
| 227 |
It croaks if it would otherwise return a UTF\-8 string that contains |
| 228 |
malformed UTF\-8. This protects against potential security threats. This |
| 229 |
is considered a bug fix as well. |
| 230 |
[GH #16035] <https://github.com/Perl/perl5/issues/16035>. |
| 231 |
.SS "Any set of digits in the Common script are legal in a script run of another script" |
| 232 |
.IX Subsection "Any set of digits in the Common script are legal in a script run of another script" |
| 233 |
There are several sets of digits in the Common script. \f(CW\*(C`[0\-9]\*(C'\fR is the |
| 234 |
most familiar. But there are also \f(CW\*(C`[\ex{FF10}\-\ex{FF19}]\*(C'\fR (FULLWIDTH |
| 235 |
DIGIT ZERO \- FULLWIDTH DIGIT NINE), and several sets for use in |
| 236 |
mathematical notation, such as the MATHEMATICAL DOUBLE-STRUCK DIGITs. |
| 237 |
Any of these sets should be able to appear in script runs of, say, |
| 238 |
Greek. But the design of 5.30 overlooked all but the ASCII digits |
| 239 |
\&\f(CW\*(C`[0\-9]\*(C'\fR, so the design was flawed. This has been fixed, so is both a |
| 240 |
bug fix and an incompatibility. |
| 241 |
[GH #16704] <https://github.com/Perl/perl5/issues/16704>. |
| 242 |
.PP |
| 243 |
All digits in a run still have to come from the same set of ten digits. |
| 244 |
.SS "JSON::PP enables allow_nonref by default" |
| 245 |
.IX Subsection "JSON::PP enables allow_nonref by default" |
| 246 |
As JSON::XS 4.0 changed its policy and enabled allow_nonref |
| 247 |
by default, JSON::PP also enabled allow_nonref by default. |
| 248 |
.SH Deprecations |
| 249 |
.IX Header "Deprecations" |
| 250 |
.SS "In XS code, use of various macros dealing with UTF\-8" |
| 251 |
.IX Subsection "In XS code, use of various macros dealing with UTF-8" |
| 252 |
This deprecation was scheduled to become fatal in 5.30, but has been |
| 253 |
delayed to 5.32 due to problems that showed up with some CPAN modules. |
| 254 |
For details of what's affected, see perldeprecation. |
| 255 |
.SH "Performance Enhancements" |
| 256 |
.IX Header "Performance Enhancements" |
| 257 |
.IP \(bu 4 |
| 258 |
Translating from UTF\-8 into the code point it represents now is done via a |
| 259 |
deterministic finite automaton, speeding it up. As a typical example, |
| 260 |
\&\f(CWord("\ex7fff")\fR now requires 12% fewer instructions than before. The |
| 261 |
performance of checking that a sequence of bytes is valid UTF\-8 is similarly |
| 262 |
improved, again by using a DFA. |
| 263 |
.IP \(bu 4 |
| 264 |
Eliminate recursion from \fBfinalize_op()\fR. |
| 265 |
[GH #11866] <https://github.com/Perl/perl5/issues/11866>. |
| 266 |
.IP \(bu 4 |
| 267 |
A handful of small optimizations related to character folding |
| 268 |
and character classes in regular expressions. |
| 269 |
.IP \(bu 4 |
| 270 |
Optimization of \f(CW\*(C`IV\*(C'\fR to \f(CW\*(C`UV\*(C'\fR conversions. |
| 271 |
[GH #16761] <https://github.com/Perl/perl5/issues/16761>. |
| 272 |
.IP \(bu 4 |
| 273 |
Speed up of the integer stringification algorithm by processing |
| 274 |
two digits at a time instead of one. |
| 275 |
[GH #16769] <https://github.com/Perl/perl5/issues/16769>. |
| 276 |
.IP \(bu 4 |
| 277 |
Improvements based on LGTM analysis and recommendation. |
| 278 |
(<https://lgtm.com/projects/g/Perl/perl5/alerts/?mode=tree>). |
| 279 |
[GH #16765] <https://github.com/Perl/perl5/issues/16765>. |
| 280 |
[GH #16773] <https://github.com/Perl/perl5/issues/16773>. |
| 281 |
.IP \(bu 4 |
| 282 |
Code optimizations in \fIregcomp.c\fR, \fIregcomp.h\fR, \fIregexec.c\fR. |
| 283 |
.IP \(bu 4 |
| 284 |
Regular expression pattern matching of things like \f(CW\*(C`qr/[^\fR\f(CIa\fR\f(CW]/\*(C'\fR is |
| 285 |
significantly sped up, where \fIa\fR is any ASCII character. Other classes |
| 286 |
can get this speed up, but which ones is complicated and depends on the |
| 287 |
underlying bit patterns of those characters, so differs between ASCII |
| 288 |
and EBCDIC platforms, but all case pairs, like \f(CW\*(C`qr/[Gg]/\*(C'\fR are included, |
| 289 |
as is \f(CW\*(C`[^01]\*(C'\fR. |
| 290 |
.SH "Modules and Pragmata" |
| 291 |
.IX Header "Modules and Pragmata" |
| 292 |
.SS "Updated Modules and Pragmata" |
| 293 |
.IX Subsection "Updated Modules and Pragmata" |
| 294 |
.IP \(bu 4 |
| 295 |
Archive::Tar has been upgraded from version 2.30 to 2.32. |
| 296 |
.IP \(bu 4 |
| 297 |
B has been upgraded from version 1.74 to 1.76. |
| 298 |
.IP \(bu 4 |
| 299 |
B::Concise has been upgraded from version 1.003 to 1.004. |
| 300 |
.IP \(bu 4 |
| 301 |
B::Deparse has been upgraded from version 1.48 to 1.49. |
| 302 |
.IP \(bu 4 |
| 303 |
bignum has been upgraded from version 0.49 to 0.51. |
| 304 |
.IP \(bu 4 |
| 305 |
bytes has been upgraded from version 1.06 to 1.07. |
| 306 |
.IP \(bu 4 |
| 307 |
Carp has been upgraded from version 1.38 to 1.50 |
| 308 |
.IP \(bu 4 |
| 309 |
Compress::Raw::Bzip2 has been upgraded from version 2.074 to 2.084. |
| 310 |
.IP \(bu 4 |
| 311 |
Compress::Raw::Zlib has been upgraded from version 2.076 to 2.084. |
| 312 |
.IP \(bu 4 |
| 313 |
Config::Extensions has been upgraded from version 0.02 to 0.03. |
| 314 |
.IP \(bu 4 |
| 315 |
Config::Perl::V. has been upgraded from version 0.29 to 0.32. This was due |
| 316 |
to a new configuration variable that has influence on binary compatibility: |
| 317 |
\&\f(CW\*(C`USE_THREAD_SAFE_LOCALE\*(C'\fR. |
| 318 |
.IP \(bu 4 |
| 319 |
CPAN has been upgraded from version 2.20 to 2.22. |
| 320 |
.IP \(bu 4 |
| 321 |
Data::Dumper has been upgraded from version 2.170 to 2.174 |
| 322 |
.Sp |
| 323 |
Data::Dumper now avoids leaking when \f(CW\*(C`croak\*(C'\fRing. |
| 324 |
.IP \(bu 4 |
| 325 |
DB_File has been upgraded from version 1.840 to 1.843. |
| 326 |
.IP \(bu 4 |
| 327 |
deprecate has been upgraded from version 0.03 to 0.04. |
| 328 |
.IP \(bu 4 |
| 329 |
Devel::Peek has been upgraded from version 1.27 to 1.28. |
| 330 |
.IP \(bu 4 |
| 331 |
Devel::PPPort has been upgraded from version 3.40 to 3.52. |
| 332 |
.IP \(bu 4 |
| 333 |
Digest::SHA has been upgraded from version 6.01 to 6.02. |
| 334 |
.IP \(bu 4 |
| 335 |
Encode has been upgraded from version 2.97 to 3.01. |
| 336 |
.IP \(bu 4 |
| 337 |
Errno has been upgraded from version 1.29 to 1.30. |
| 338 |
.IP \(bu 4 |
| 339 |
experimental has been upgraded from version 0.019 to 0.020. |
| 340 |
.IP \(bu 4 |
| 341 |
ExtUtils::CBuilder has been upgraded from version 0.280230 to 0.280231. |
| 342 |
.IP \(bu 4 |
| 343 |
ExtUtils::Manifest has been upgraded from version 1.70 to 1.72. |
| 344 |
.IP \(bu 4 |
| 345 |
ExtUtils::Miniperl has been upgraded from version 1.08 to 1.09. |
| 346 |
.IP \(bu 4 |
| 347 |
ExtUtils::ParseXS has been upgraded from version 3.39 to 3.40. |
| 348 |
\&\f(CW\*(C`OUTLIST\*(C'\fR parameters are no longer incorrectly included in the |
| 349 |
automatically generated function prototype. |
| 350 |
[GH #16746] <https://github.com/Perl/perl5/issues/16746>. |
| 351 |
.IP \(bu 4 |
| 352 |
feature has been upgraded from version 1.52 to 1.54. |
| 353 |
.IP \(bu 4 |
| 354 |
File::Copy has been upgraded from version 2.33 to 2.34. |
| 355 |
.IP \(bu 4 |
| 356 |
File::Find has been upgraded from version 1.34 to 1.36. |
| 357 |
.Sp |
| 358 |
\&\f(CW$File::Find::dont_use_nlink\fR now defaults to 1 on all |
| 359 |
platforms. |
| 360 |
[GH #16759] <https://github.com/Perl/perl5/issues/16759>. |
| 361 |
.Sp |
| 362 |
Variables \f(CW$Is_Win32\fR and \f(CW$Is_VMS\fR are being initialized. |
| 363 |
.IP \(bu 4 |
| 364 |
File::Glob has been upgraded from version 1.31 to 1.32. |
| 365 |
.IP \(bu 4 |
| 366 |
File::Path has been upgraded from version 2.15 to 2.16. |
| 367 |
.IP \(bu 4 |
| 368 |
File::Spec has been upgraded from version 3.74 to 3.78. |
| 369 |
.Sp |
| 370 |
Silence Cwd warning on Android builds if \f(CW\*(C`targetsh\*(C'\fR is not defined. |
| 371 |
.IP \(bu 4 |
| 372 |
File::Temp has been upgraded from version 0.2304 to 0.2309. |
| 373 |
.IP \(bu 4 |
| 374 |
Filter::Util::Call has been upgraded from version 1.58 to 1.59. |
| 375 |
.IP \(bu 4 |
| 376 |
GDBM_File has been upgraded from version 1.17 to 1.18. |
| 377 |
.IP \(bu 4 |
| 378 |
HTTP::Tiny has been upgraded from version 0.070 to 0.076. |
| 379 |
.IP \(bu 4 |
| 380 |
I18N::Langinfo has been upgraded from version 0.17 to 0.18. |
| 381 |
.IP \(bu 4 |
| 382 |
IO has been upgraded from version 1.39 to 1.40. |
| 383 |
.IP \(bu 4 |
| 384 |
IO-Compress has been upgraded from version 2.074 to 2.084. |
| 385 |
.Sp |
| 386 |
Adds support for \f(CW\*(C`IO::Uncompress::Zstd\*(C'\fR and |
| 387 |
\&\f(CW\*(C`IO::Uncompress::UnLzip\*(C'\fR. |
| 388 |
.Sp |
| 389 |
The \f(CW\*(C`BinModeIn\*(C'\fR and \f(CW\*(C`BinModeOut\*(C'\fR options are now no-ops. |
| 390 |
ALL files will be read/written in binmode. |
| 391 |
.IP \(bu 4 |
| 392 |
IPC::Cmd has been upgraded from version 1.00 to 1.02. |
| 393 |
.IP \(bu 4 |
| 394 |
JSON::PP has been upgraded from version 2.97001 to 4.02. |
| 395 |
.Sp |
| 396 |
JSON::PP as JSON::XS 4.0 enables \f(CW\*(C`allow_nonref\*(C'\fR by default. |
| 397 |
.IP \(bu 4 |
| 398 |
lib has been upgraded from version 0.64 to 0.65. |
| 399 |
.IP \(bu 4 |
| 400 |
Locale::Codes has been upgraded from version 3.56 to 3.57. |
| 401 |
.IP \(bu 4 |
| 402 |
Math::BigInt has been upgraded from version 1.999811 to 1.999816. |
| 403 |
.Sp |
| 404 |
\&\f(CWbnok()\fR now supports the full Kronenburg extension. |
| 405 |
[cpan #95628] <https://rt.cpan.org/Ticket/Display.html?id=95628>. |
| 406 |
.IP \(bu 4 |
| 407 |
Math::BigInt::FastCalc has been upgraded from version 0.5006 to 0.5008. |
| 408 |
.IP \(bu 4 |
| 409 |
Math::BigRat has been upgraded from version 0.2613 to 0.2614. |
| 410 |
.IP \(bu 4 |
| 411 |
Module::CoreList has been upgraded from version 5.20180622 to 5.20190520. |
| 412 |
.Sp |
| 413 |
Changes to B::Op_private and Config |
| 414 |
.IP \(bu 4 |
| 415 |
Module::Load has been upgraded from version 0.32 to 0.34. |
| 416 |
.IP \(bu 4 |
| 417 |
Module::Metadata has been upgraded from version 1.000033 to 1.000036. |
| 418 |
.Sp |
| 419 |
Properly clean up temporary directories after testing. |
| 420 |
.IP \(bu 4 |
| 421 |
NDBM_File has been upgraded from version 1.14 to 1.15. |
| 422 |
.IP \(bu 4 |
| 423 |
Net::Ping has been upgraded from version 2.62 to 2.71. |
| 424 |
.IP \(bu 4 |
| 425 |
ODBM_File has been upgraded from version 1.15 to 1.16. |
| 426 |
.IP \(bu 4 |
| 427 |
PathTools has been upgraded from version 3.74 to 3.78. |
| 428 |
.IP \(bu 4 |
| 429 |
parent has been upgraded from version 0.236 to 0.237. |
| 430 |
.IP \(bu 4 |
| 431 |
perl5db.pl has been upgraded from version 1.54 to 1.55. |
| 432 |
.Sp |
| 433 |
Debugging threaded code no longer deadlocks in \f(CW\*(C`DB::sub\*(C'\fR nor |
| 434 |
\&\f(CW\*(C`DB::lsub\*(C'\fR. |
| 435 |
.IP \(bu 4 |
| 436 |
perlfaq has been upgraded from version 5.021011 to 5.20190126. |
| 437 |
.IP \(bu 4 |
| 438 |
PerlIO::encoding has been upgraded from version 0.26 to 0.27. |
| 439 |
.Sp |
| 440 |
Warnings enabled by setting the \f(CW\*(C`WARN_ON_ERR\*(C'\fR flag in |
| 441 |
\&\f(CW$PerlIO::encoding::fallback\fR are now only produced if warnings are |
| 442 |
enabled with \f(CW\*(C`use warnings "utf8";\*(C'\fR or setting \f(CW$^W\fR. |
| 443 |
.IP \(bu 4 |
| 444 |
PerlIO::scalar has been upgraded from version 0.29 to 0.30. |
| 445 |
.IP \(bu 4 |
| 446 |
podlators has been upgraded from version 4.10 to 4.11. |
| 447 |
.IP \(bu 4 |
| 448 |
POSIX has been upgraded from version 1.84 to 1.88. |
| 449 |
.IP \(bu 4 |
| 450 |
re has been upgraded from version 0.36 to 0.37. |
| 451 |
.IP \(bu 4 |
| 452 |
SDBM_File has been upgraded from version 1.14 to 1.15. |
| 453 |
.IP \(bu 4 |
| 454 |
sigtrap has been upgraded from version 1.08 to 1.09. |
| 455 |
.IP \(bu 4 |
| 456 |
Storable has been upgraded from version 3.08 to 3.15. |
| 457 |
.Sp |
| 458 |
Storable no longer probes for recursion limits at build time. |
| 459 |
[GH #16780] <https://github.com/Perl/perl5/issues/16780> |
| 460 |
and others. |
| 461 |
.Sp |
| 462 |
Metasploit exploit code was included to test for CVE\-2015\-1592 |
| 463 |
detection, this caused anti-virus detections on at least one AV suite. |
| 464 |
The exploit code has been removed and replaced with a simple |
| 465 |
functional test. |
| 466 |
[GH #16778] <https://github.com/Perl/perl5/issues/16778> |
| 467 |
.IP \(bu 4 |
| 468 |
Test::Simple has been upgraded from version 1.302133 to 1.302162. |
| 469 |
.IP \(bu 4 |
| 470 |
Thread::Queue has been upgraded from version 3.12 to 3.13. |
| 471 |
.IP \(bu 4 |
| 472 |
threads::shared has been upgraded from version 1.58 to 1.60. |
| 473 |
.Sp |
| 474 |
Added support for extra tracing of locking, this requires a |
| 475 |
\&\f(CW\*(C`\-DDEBUGGING\*(C'\fR and extra compilation flags. |
| 476 |
.IP \(bu 4 |
| 477 |
Time::HiRes has been upgraded from version 1.9759 to 1.9760. |
| 478 |
.IP \(bu 4 |
| 479 |
Time::Local has been upgraded from version 1.25 to 1.28. |
| 480 |
.IP \(bu 4 |
| 481 |
Time::Piece has been upgraded from version 1.3204 to 1.33. |
| 482 |
.IP \(bu 4 |
| 483 |
Unicode::Collate has been upgraded from version 1.25 to 1.27. |
| 484 |
.IP \(bu 4 |
| 485 |
Unicode::UCD has been upgraded from version 0.70 to 0.72. |
| 486 |
.IP \(bu 4 |
| 487 |
User::grent has been upgraded from version 1.02 to 1.03. |
| 488 |
.IP \(bu 4 |
| 489 |
utf8 has been upgraded from version 1.21 to 1.22. |
| 490 |
.IP \(bu 4 |
| 491 |
vars has been upgraded from version 1.04 to 1.05. |
| 492 |
.Sp |
| 493 |
\&\f(CW\*(C`vars.pm\*(C'\fR no longer disables non-vars strict when checking if strict |
| 494 |
vars is enabled. |
| 495 |
[GH #15851] <https://github.com/Perl/perl5/issues/15851>. |
| 496 |
.IP \(bu 4 |
| 497 |
version has been upgraded from version 0.9923 to 0.9924. |
| 498 |
.IP \(bu 4 |
| 499 |
warnings has been upgraded from version 1.42 to 1.44. |
| 500 |
.IP \(bu 4 |
| 501 |
XS::APItest has been upgraded from version 0.98 to 1.00. |
| 502 |
.IP \(bu 4 |
| 503 |
XS::Typemap has been upgraded from version 0.16 to 0.17. |
| 504 |
.SS "Removed Modules and Pragmata" |
| 505 |
.IX Subsection "Removed Modules and Pragmata" |
| 506 |
The following modules will be removed from the core distribution in a |
| 507 |
future release, and will at that time need to be installed from CPAN. |
| 508 |
Distributions on CPAN which require these modules will need to list them as |
| 509 |
prerequisites. |
| 510 |
.PP |
| 511 |
The core versions of these modules will now issue \f(CW"deprecated"\fR\-category |
| 512 |
warnings to alert you to this fact. To silence these deprecation warnings, |
| 513 |
install the modules in question from CPAN. |
| 514 |
.PP |
| 515 |
Note that these are (with rare exceptions) fine modules that you are encouraged |
| 516 |
to continue to use. Their disinclusion from core primarily hinges on their |
| 517 |
necessity to bootstrapping a fully functional, CPAN-capable Perl installation, |
| 518 |
not usually on concerns over their design. |
| 519 |
.IP \(bu 4 |
| 520 |
arybase has been removed. It used to provide the implementation of the \f(CW$[\fR |
| 521 |
variable (also known as the \f(CW\*(C`array_base\*(C'\fR feature), letting array and string |
| 522 |
indices start at a non-zero value. As the feature has been removed (see |
| 523 |
"Assigning non-zero to \f(CW$[\fR is fatal"), this internal module is gone as |
| 524 |
well. |
| 525 |
.IP \(bu 4 |
| 526 |
B::Debug is no longer distributed with the core distribution. It |
| 527 |
continues to be available on CPAN as |
| 528 |
\&\f(CW\*(C`B::Debug <https://metacpan.org/pod/B::Debug>\*(C'\fR. |
| 529 |
.IP \(bu 4 |
| 530 |
Locale::Codes has been removed at the request of its author. It |
| 531 |
continues to be available on CPAN as |
| 532 |
\&\f(CW\*(C`Locale::Codes <https://metacpan.org/pod/Locale::Codes>\*(C'\fR |
| 533 |
[GH #16660] <https://github.com/Perl/perl5/issues/16660>. |
| 534 |
.SH Documentation |
| 535 |
.IX Header "Documentation" |
| 536 |
.SS "Changes to Existing Documentation" |
| 537 |
.IX Subsection "Changes to Existing Documentation" |
| 538 |
We have attempted to update the documentation to reflect the changes |
| 539 |
listed in this document. If you find any we have missed, send email |
| 540 |
to [email protected] <mailto:[email protected]>. |
| 541 |
.PP |
| 542 |
\fIperlapi\fR |
| 543 |
.IX Subsection "perlapi" |
| 544 |
.IP \(bu 4 |
| 545 |
\&\f(CWAvFILL()\fR was wrongly listed as deprecated. This has been corrected. |
| 546 |
[GH #16586] <https://github.com/Perl/perl5/issues/16586> |
| 547 |
.PP |
| 548 |
\fIperlop\fR |
| 549 |
.IX Subsection "perlop" |
| 550 |
.IP \(bu 4 |
| 551 |
We no longer have null (empty line) here doc terminators, so |
| 552 |
perlop should not refer to them. |
| 553 |
.IP \(bu 4 |
| 554 |
The behaviour of \f(CW\*(C`tr\*(C'\fR when the delimiter is an apostrophe has been clarified. |
| 555 |
In particular, hyphens aren't special, and \f(CW\*(C`\ex{}\*(C'\fR isn't interpolated. |
| 556 |
[GH #15853] <https://github.com/Perl/perl5/issues/15853> |
| 557 |
.PP |
| 558 |
\fIperlreapi, perlvar\fR |
| 559 |
.IX Subsection "perlreapi, perlvar" |
| 560 |
.IP \(bu 4 |
| 561 |
Improve docs for lastparen, lastcloseparen. |
| 562 |
.PP |
| 563 |
\fIperlfunc\fR |
| 564 |
.IX Subsection "perlfunc" |
| 565 |
.IP \(bu 4 |
| 566 |
The entry for "\-X" in perlfunc has been clarified to indicate that symbolic |
| 567 |
links are followed for most tests. |
| 568 |
.IP \(bu 4 |
| 569 |
Clarification of behaviour of \f(CW\*(C`reset EXPR\*(C'\fR. |
| 570 |
.IP \(bu 4 |
| 571 |
Try to clarify that \f(CWref(qr/xx/)\fR returns \f(CW\*(C`Regexp\*(C'\fR rather than |
| 572 |
\&\f(CW\*(C`REGEXP\*(C'\fR and why. |
| 573 |
[GH #16801] <https://github.com/Perl/perl5/issues/16801>. |
| 574 |
.PP |
| 575 |
\fIperlreref\fR |
| 576 |
.IX Subsection "perlreref" |
| 577 |
.IP \(bu 4 |
| 578 |
Clarification of the syntax of /(?(cond)yes)/. |
| 579 |
.PP |
| 580 |
\fIperllocale\fR |
| 581 |
.IX Subsection "perllocale" |
| 582 |
.IP \(bu 4 |
| 583 |
There are actually two slightly different types of UTF\-8 locales: one for Turkic |
| 584 |
languages and one for everything else. Starting in Perl v5.30, Perl seamlessly |
| 585 |
handles both types. |
| 586 |
.PP |
| 587 |
\fIperlrecharclass\fR |
| 588 |
.IX Subsection "perlrecharclass" |
| 589 |
.IP \(bu 4 |
| 590 |
Added a note for the ::xdigit:: character class. |
| 591 |
.PP |
| 592 |
\fIperlvar\fR |
| 593 |
.IX Subsection "perlvar" |
| 594 |
.IP \(bu 4 |
| 595 |
More specific documentation of paragraph mode. |
| 596 |
[GH #16787] <https://github.com/Perl/perl5/issues/16787>. |
| 597 |
.SH Diagnostics |
| 598 |
.IX Header "Diagnostics" |
| 599 |
The following additions or changes have been made to diagnostic output, |
| 600 |
including warnings and fatal error messages. For the complete list of |
| 601 |
diagnostic messages, see perldiag. |
| 602 |
.SS "Changes to Existing Diagnostics" |
| 603 |
.IX Subsection "Changes to Existing Diagnostics" |
| 604 |
.IP \(bu 4 |
| 605 |
As noted under "Incompatible Changes" above, the deprecation warning |
| 606 |
"Unescaped left brace in regex is deprecated here (and will be fatal in Perl |
| 607 |
5.30), passed through in regex; marked by <\-\-\ HERE in m/%s/" has been |
| 608 |
changed to the non-deprecation warning "Unescaped left brace in regex is passed |
| 609 |
through in regex; marked by <\-\-\ HERE in m/%s/". |
| 610 |
.IP \(bu 4 |
| 611 |
Specifying \f(CW\*(C`\eo{}\*(C'\fR without anything between the braces now yields the |
| 612 |
fatal error message "Empty \eo{}". Previously it was "Number with no |
| 613 |
digits". This means the same wording is used for this kind of error as |
| 614 |
with similar constructs such as \f(CW\*(C`\ep{}\*(C'\fR. |
| 615 |
.IP \(bu 4 |
| 616 |
Within the scope of the experimental feature \f(CW\*(C`use re \*(Aqstrict\*(Aq\*(C'\fR, |
| 617 |
specifying \f(CW\*(C`\ex{}\*(C'\fR without anything between the braces now yields the |
| 618 |
fatal error message "Empty \ex{}". Previously it was "Number with no |
| 619 |
digits". This means the same wording is used for this kind of error as |
| 620 |
with similar constructs such as \f(CW\*(C`\ep{}\*(C'\fR. It is legal, though not wise |
| 621 |
to have an empty \f(CW\*(C`\ex\*(C'\fR outside of \f(CW\*(C`re \*(Aqstrict\*(Aq\*(C'\fR; it silently generates |
| 622 |
a NUL character. |
| 623 |
.IP \(bu 4 |
| 624 |
Type of arg \f(CW%d\fR to \f(CW%s\fR must be \f(CW%s\fR (not \f(CW%s\fR) |
| 625 |
.Sp |
| 626 |
Attempts to push, pop, etc on a hash or glob now produce this message |
| 627 |
rather than complaining that they no longer work on scalars. |
| 628 |
[GH #15774] <https://github.com/Perl/perl5/issues/15774>. |
| 629 |
.IP \(bu 4 |
| 630 |
Prototype not terminated |
| 631 |
.Sp |
| 632 |
The file and line number is now reported for this error. |
| 633 |
[GH #16697] <https://github.com/Perl/perl5/issues/16697> |
| 634 |
.IP \(bu 4 |
| 635 |
Under \f(CW\*(C`\-Dr\*(C'\fR (or \f(CW\*(C`use re \*(AqDebug\*(Aq\*(C'\fR) the compiled regex engine |
| 636 |
program is displayed. It used to use two different spellings for \fIinfinity\fR, |
| 637 |
\&\f(CW\*(C`INFINITY\*(C'\fR, and \f(CW\*(C`INFTY\*(C'\fR. It now uses the latter exclusively, |
| 638 |
as that spelling has been around the longest. |
| 639 |
.SH "Utility Changes" |
| 640 |
.IX Header "Utility Changes" |
| 641 |
.SS xsubpp |
| 642 |
.IX Subsection "xsubpp" |
| 643 |
.IP \(bu 4 |
| 644 |
The generated prototype (with \f(CW\*(C`PROTOTYPES: ENABLE\*(C'\fR) would include |
| 645 |
\&\f(CW\*(C`OUTLIST\*(C'\fR parameters, but these aren't arguments to the perl function. |
| 646 |
This has been rectified. |
| 647 |
[GH #16746] <https://github.com/Perl/perl5/issues/16746>. |
| 648 |
.SH "Configuration and Compilation" |
| 649 |
.IX Header "Configuration and Compilation" |
| 650 |
.IP \(bu 4 |
| 651 |
Normally the thread-safe locale functions are used only on threaded |
| 652 |
builds. It is now possible to force their use on unthreaded builds on |
| 653 |
systems that have them available, by including the |
| 654 |
\&\f(CW\*(C`\-Accflags=\*(Aq\-DUSE_THREAD_SAFE_LOCALE\*(Aq\*(C'\fR option to \fIConfigure\fR. |
| 655 |
.IP \(bu 4 |
| 656 |
Improve detection of memrchr, strlcat, and strlcpy |
| 657 |
.IP \(bu 4 |
| 658 |
Improve Configure detection of \fBmemmem()\fR. |
| 659 |
[GH #16807] <https://github.com/Perl/perl5/issues/16807>. |
| 660 |
.IP \(bu 4 |
| 661 |
Multiple improvements and fixes for \-DPERL_GLOBAL_STRUCT build option. |
| 662 |
.IP \(bu 4 |
| 663 |
Fix \-DPERL_GLOBAL_STRUCT_PRIVATE build option. |
| 664 |
.SH Testing |
| 665 |
.IX Header "Testing" |
| 666 |
.IP \(bu 4 |
| 667 |
\&\fIt/lib/croak/op\fR |
| 668 |
[GH #15774] <https://github.com/Perl/perl5/issues/15774>. |
| 669 |
.Sp |
| 670 |
separate error for \f(CW\*(C`push\*(C'\fR, etc. on hash/glob. |
| 671 |
.IP \(bu 4 |
| 672 |
\&\fIt/op/svleak.t\fR |
| 673 |
[GH #16749] <https://github.com/Perl/perl5/issues/16749>. |
| 674 |
.Sp |
| 675 |
Add test for \f(CW\*(C`goto &sub\*(C'\fR in overload leaking. |
| 676 |
.IP \(bu 4 |
| 677 |
Split \fIt/re/fold_grind.t\fR into multiple test files. |
| 678 |
.IP \(bu 4 |
| 679 |
Fix intermittent tests which failed due to race conditions which |
| 680 |
surface during parallel testing. |
| 681 |
[GH #16795] <https://github.com/Perl/perl5/issues/16795>. |
| 682 |
.IP \(bu 4 |
| 683 |
Thoroughly test paragraph mode, using a new test file, |
| 684 |
\&\fIt/io/paragraph_mode.t\fR. |
| 685 |
[GH #16787] <https://github.com/Perl/perl5/issues/16787>. |
| 686 |
.IP \(bu 4 |
| 687 |
Some tests in \fIt/io/eintr.t\fR caused the process to hang on |
| 688 |
pre\-16 Darwin. These tests are skipped for those version of Darwin. |
| 689 |
.SH "Platform Support" |
| 690 |
.IX Header "Platform Support" |
| 691 |
.SS "Platform-Specific Notes" |
| 692 |
.IX Subsection "Platform-Specific Notes" |
| 693 |
.IP "HP-UX 11.11" 4 |
| 694 |
.IX Item "HP-UX 11.11" |
| 695 |
An obscure problem in \f(CWpack()\fR when compiling with HP C\-ANSI-C has been fixed |
| 696 |
by disabling optimizations in \fIpp_pack.c\fR. |
| 697 |
.IP "Mac OS X" 4 |
| 698 |
.IX Item "Mac OS X" |
| 699 |
Perl's build and testing process on Mac OS X for \f(CW\*(C`\-Duseshrplib\*(C'\fR |
| 700 |
builds is now compatible with Mac OS X System Integrity Protection |
| 701 |
(SIP). |
| 702 |
.Sp |
| 703 |
SIP prevents binaries in \fI/bin\fR (and a few other places) being passed |
| 704 |
the \f(CW\*(C`DYLD_LIBRARY_PATH\*(C'\fR environment variable. For our purposes this |
| 705 |
prevents \f(CW\*(C`DYLD_LIBRARY_PATH\*(C'\fR from being passed to the shell, which |
| 706 |
prevents that variable being passed to the testing or build process, |
| 707 |
so running \f(CW\*(C`perl\*(C'\fR couldn't find \fIlibperl.dylib\fR. |
| 708 |
.Sp |
| 709 |
To work around that, the initial build of the \fIperl\fR executable |
| 710 |
expects to find \fIlibperl.dylib\fR in the build directory, and the |
| 711 |
library path is then adjusted during installation to point to the |
| 712 |
installed library. |
| 713 |
.Sp |
| 714 |
[GH #15057] <https://github.com/Perl/perl5/issues/15057>. |
| 715 |
.IP Minix3 4 |
| 716 |
.IX Item "Minix3" |
| 717 |
Some support for Minix3 has been re-added. |
| 718 |
.IP Cygwin 4 |
| 719 |
.IX Item "Cygwin" |
| 720 |
Cygwin doesn't make \f(CW\*(C`cuserid\*(C'\fR visible. |
| 721 |
.IP "Win32 Mingw" 4 |
| 722 |
.IX Item "Win32 Mingw" |
| 723 |
C99 math functions are now available. |
| 724 |
.IP Windows 4 |
| 725 |
.IX Item "Windows" |
| 726 |
.RS 4 |
| 727 |
.PD 0 |
| 728 |
.IP \(bu 4 |
| 729 |
.PD |
| 730 |
The \f(CW\*(C`USE_CPLUSPLUS\*(C'\fR build option which has long been available in |
| 731 |
\&\fIwin32/Makefile\fR (for \fBnmake\fR) and \fIwin32/makefile.mk\fR (for \fBdmake\fR) is now |
| 732 |
also available in \fIwin32/GNUmakefile\fR (for \fBgmake\fR). |
| 733 |
.IP \(bu 4 |
| 734 |
The \fBnmake\fR makefile no longer defaults to Visual C++ 6.0 (a very old version |
| 735 |
which is unlikely to be widely used today). As a result, it is now a |
| 736 |
requirement to specify the \f(CW\*(C`CCTYPE\*(C'\fR since there is no obvious choice of which |
| 737 |
modern version to default to instead. Failure to specify \f(CW\*(C`CCTYPE\*(C'\fR will result |
| 738 |
in an error being output and the build will stop. |
| 739 |
.Sp |
| 740 |
(The \fBdmake\fR and \fBgmake\fR makefiles will automatically detect which compiler |
| 741 |
is being used, so do not require \f(CW\*(C`CCTYPE\*(C'\fR to be set. This feature has not yet |
| 742 |
been added to the \fBnmake\fR makefile.) |
| 743 |
.IP \(bu 4 |
| 744 |
\&\f(CWsleep()\fR with warnings enabled for a \f(CW\*(C`USE_IMP_SYS\*(C'\fR build no longer |
| 745 |
warns about the sleep timeout being too large. |
| 746 |
[GH #16631] <https://github.com/Perl/perl5/issues/16631>. |
| 747 |
.IP \(bu 4 |
| 748 |
Support for compiling perl on Windows using Microsoft Visual Studio 2019 |
| 749 |
(containing Visual C++ 14.2) has been added. |
| 750 |
.IP \(bu 4 |
| 751 |
\&\fBsocket()\fR now sets \f(CW$!\fR if the protocol, address family and socket |
| 752 |
type combination is not found. |
| 753 |
[GH #16849] <https://github.com/Perl/perl5/issues/16849>. |
| 754 |
.IP \(bu 4 |
| 755 |
The Windows Server 2003 SP1 Platform SDK build, with its early x64 compiler and |
| 756 |
tools, was accidentally broken in Perl 5.27.9. This has now been fixed. |
| 757 |
.RE |
| 758 |
.RS 4 |
| 759 |
.RE |
| 760 |
.SH "Internal Changes" |
| 761 |
.IX Header "Internal Changes" |
| 762 |
.IP \(bu 4 |
| 763 |
The sizing pass has been eliminated from the regular expression |
| 764 |
compiler. An extra pass may instead be needed in some cases to count |
| 765 |
the number of parenthetical capture groups. |
| 766 |
.IP \(bu 4 |
| 767 |
A new function "\f(CW\*(C`my_strtod\*(C'\fR" in perlapi or its synonym, \fBStrtod()\fR, is |
| 768 |
now available with the same signature as the libc \fBstrtod()\fR. It provides |
| 769 |
\&\fBstrotod()\fR equivalent behavior on all platforms, using the best available |
| 770 |
precision, depending on platform capabilities and \fIConfigure\fR options, |
| 771 |
while handling locale-related issues, such as if the radix character |
| 772 |
should be a dot or comma. |
| 773 |
.IP \(bu 4 |
| 774 |
Added \f(CWnewSVsv_nomg()\fR to copy a SV without processing get magic on |
| 775 |
the source. |
| 776 |
[GH #16461] <https://github.com/Perl/perl5/issues/16461>. |
| 777 |
.IP \(bu 4 |
| 778 |
It is now forbidden to malloc more than \f(CW\*(C`PTRDIFF_T_MAX\*(C'\fR bytes. Much |
| 779 |
code (including C optimizers) assumes that all data structures will not |
| 780 |
be larger than this, so this catches such attempts before overflow |
| 781 |
happens. |
| 782 |
.IP \(bu 4 |
| 783 |
Two new regnodes have been introduced \f(CW\*(C`EXACT_ONLY8\*(C'\fR, and |
| 784 |
\&\f(CW\*(C`EXACTFU_ONLY8\*(C'\fR. They're equivalent to \f(CW\*(C`EXACT\*(C'\fR and \f(CW\*(C`EXACTFU\*(C'\fR, |
| 785 |
except that they contain a code point which requires UTF\-8 to |
| 786 |
represent/match. Hence, if the target string isn't UTF\-8, we know |
| 787 |
it can't possibly match, without needing to try. |
| 788 |
.IP \(bu 4 |
| 789 |
\&\f(CWprint_bytes_for_locale()\fR is now defined if \f(CW\*(C`DEBUGGING\*(C'\fR, |
| 790 |
Prior, it didn't get defined unless \f(CW\*(C`LC_COLLATE\*(C'\fR was defined |
| 791 |
on the platform. |
| 792 |
.SH "Selected Bug Fixes" |
| 793 |
.IX Header "Selected Bug Fixes" |
| 794 |
.IP \(bu 4 |
| 795 |
Compilation under \f(CW\*(C`\-DPERL_MEM_LOG\*(C'\fR and \f(CW\*(C`\-DNO_LOCALE\*(C'\fR have been fixed. |
| 796 |
.IP \(bu 4 |
| 797 |
Perl 5.28 introduced an \f(CWindex()\fR optimization when comparing to \-1 (or |
| 798 |
indirectly, e.g. >= 0). When this optimization was triggered inside a \f(CW\*(C`when\*(C'\fR |
| 799 |
clause it caused a warning ("Argument \f(CW%s\fR isn't numeric in smart match"). This |
| 800 |
has now been fixed. |
| 801 |
[GH #16626] <https://github.com/Perl/perl5/issues/16626> |
| 802 |
.IP \(bu 4 |
| 803 |
The new in-place editing code no longer leaks directory handles. |
| 804 |
[GH #16602] <https://github.com/Perl/perl5/issues/16602>. |
| 805 |
.IP \(bu 4 |
| 806 |
Warnings produced from constant folding operations on overloaded |
| 807 |
values no longer produce spurious "Use of uninitialized value" |
| 808 |
warnings. |
| 809 |
[GH #16349] <https://github.com/Perl/perl5/issues/16349>. |
| 810 |
.IP \(bu 4 |
| 811 |
Fix for "mutator not seen in (lex = ...) .= ..." |
| 812 |
[GH #16655] <https://github.com/Perl/perl5/issues/16655>. |
| 813 |
.IP \(bu 4 |
| 814 |
\&\f(CW\*(C`pack "u", "invalid uuencoding"\*(C'\fR now properly NUL terminates the |
| 815 |
zero-length SV produced. |
| 816 |
[GH #16343] <https://github.com/Perl/perl5/issues/16343>. |
| 817 |
.IP \(bu 4 |
| 818 |
Improve the debugging output for \fBcalloc()\fR calls with \f(CW\*(C`\-Dm\*(C'\fR. |
| 819 |
[GH #16653] <https://github.com/Perl/perl5/issues/16653>. |
| 820 |
.IP \(bu 4 |
| 821 |
Regexp script runs were failing to permit ASCII digits in some cases. |
| 822 |
[GH #16704] <https://github.com/Perl/perl5/issues/16704>. |
| 823 |
.IP \(bu 4 |
| 824 |
On Unix-like systems supporting a platform-specific technique for |
| 825 |
determining \f(CW$^X\fR, Perl failed to fall back to the |
| 826 |
generic technique when the platform-specific one fails (for example, a Linux |
| 827 |
system with /proc not mounted). This was a regression in Perl 5.28.0. |
| 828 |
[GH #16715] <https://github.com/Perl/perl5/issues/16715>. |
| 829 |
.IP \(bu 4 |
| 830 |
SDBM_File is now more robust with corrupt database files. The |
| 831 |
improvements do not make SDBM files suitable as an interchange format. |
| 832 |
[GH #16164] <https://github.com/Perl/perl5/issues/16164>. |
| 833 |
.IP \(bu 4 |
| 834 |
\&\f(CW\*(C`binmode($fh);\*(C'\fR or \f(CW\*(C`binmode($fh, \*(Aq:raw\*(Aq);\*(C'\fR now properly removes the |
| 835 |
\&\f(CW\*(C`:utf8\*(C'\fR flag from the default \f(CW\*(C`:crlf\*(C'\fR I/O layer on Win32. |
| 836 |
[GH #16730] <https://github.com/Perl/perl5/issues/16730>. |
| 837 |
.IP \(bu 4 |
| 838 |
The experimental reference aliasing feature was misinterpreting array and |
| 839 |
hash slice assignment as being localised, e.g. |
| 840 |
.Sp |
| 841 |
.Vb 1 |
| 842 |
\& \e(@a[3,5,7]) = \e(....); |
| 843 |
.Ve |
| 844 |
.Sp |
| 845 |
was being interpreted as: |
| 846 |
.Sp |
| 847 |
.Vb 1 |
| 848 |
\& local \e(@a[3,5,7]) = \e(....); |
| 849 |
.Ve |
| 850 |
.Sp |
| 851 |
[GH #16701] <https://github.com/Perl/perl5/issues/16701>. |
| 852 |
.IP \(bu 4 |
| 853 |
\&\f(CW\*(C`sort SUBNAME\*(C'\fR within an \f(CW\*(C`eval EXPR\*(C'\fR when \f(CW\*(C`EXPR\*(C'\fR was UTF\-8 upgraded |
| 854 |
could panic if the \f(CW\*(C`SUBNAME\*(C'\fR was non-ASCII. |
| 855 |
[GH #16979] <https://github.com/Perl/perl5/issues/16979>. |
| 856 |
.IP \(bu 4 |
| 857 |
Correctly handle \fBrealloc()\fR modifying \f(CW\*(C`errno\*(C'\fR on success so that the |
| 858 |
modification isn't visible to the perl user, since \fBrealloc()\fR is called |
| 859 |
implicitly by the interpreter. This modification is permitted by the |
| 860 |
C standard, but has only been observed on FreeBSD 13.0\-CURRENT. |
| 861 |
[GH #16907] <https://github.com/Perl/perl5/issues/16907>. |
| 862 |
.IP \(bu 4 |
| 863 |
Perl now exposes POSIX \f(CW\*(C`getcwd\*(C'\fR as \f(CWInternals::getcwd()\fR if |
| 864 |
available. This is intended for use by \f(CW\*(C`Cwd.pm\*(C'\fR during bootstrapping |
| 865 |
and may be removed or changed without notice. This fixes some |
| 866 |
bootstrapping issues while building perl in a directory where some |
| 867 |
ancestor directory isn't readable. |
| 868 |
[GH #16903] <https://github.com/Perl/perl5/issues/16903>. |
| 869 |
.IP \(bu 4 |
| 870 |
\&\f(CWpack()\fR no longer can return malformed UTF\-8. It croaks if it would |
| 871 |
otherwise return a UTF\-8 string that contains malformed UTF\-8. This |
| 872 |
protects against potential security threats. |
| 873 |
[GH #16035] <https://github.com/Perl/perl5/issues/16035>. |
| 874 |
.IP \(bu 4 |
| 875 |
See "Any set of digits in the Common script are legal in a script run |
| 876 |
of another script". |
| 877 |
.IP \(bu 4 |
| 878 |
Regular expression matching no longer leaves stale UTF\-8 length magic |
| 879 |
when updating \f(CW$^R\fR. This could result in \f(CWlength($^R)\fR returning |
| 880 |
an incorrect value. |
| 881 |
.IP \(bu 4 |
| 882 |
Reduce recursion on ops |
| 883 |
[GH #11866] <https://github.com/Perl/perl5/issues/11866>. |
| 884 |
.Sp |
| 885 |
This can prevent stack overflow when processing extremely deep op |
| 886 |
trees. |
| 887 |
.IP \(bu 4 |
| 888 |
Avoid leak in multiconcat with overloading. |
| 889 |
[GH #16823] <https://github.com/Perl/perl5/issues/16823>. |
| 890 |
.IP \(bu 4 |
| 891 |
The handling of user-defined \f(CW\*(C`\ep{}\*(C'\fR properties (see |
| 892 |
"User-Defined Character Properties" in perlunicode) has been rewritten to |
| 893 |
be in C (instead of Perl). This speeds things up, but in the process |
| 894 |
several inconsistencies and bug fixes are made. |
| 895 |
.RS 4 |
| 896 |
.IP 1. 4 |
| 897 |
A few error messages have minor wording changes. This is essentially |
| 898 |
because the new way is integrated into the regex error handling |
| 899 |
mechanism that marks the position in the input at which the error |
| 900 |
occurred. That was not possible previously. The messages now also |
| 901 |
contain additional back-trace-like information in case the error occurs |
| 902 |
deep in nested calls. |
| 903 |
.IP 2. 4 |
| 904 |
A user-defined property is implemented as a perl subroutine with certain |
| 905 |
highly constrained naming conventions. It was documented previously |
| 906 |
that the sub would be in the current package if the package was |
| 907 |
unspecified. This turned out not to be true in all cases, but now it |
| 908 |
is. |
| 909 |
.IP 3. 4 |
| 910 |
All recursive calls are treated as infinite recursion. Previously they |
| 911 |
would cause the interpreter to panic. Now, they cause the regex pattern |
| 912 |
to fail to compile. |
| 913 |
.IP 4. 4 |
| 914 |
Similarly, any other error likely would lead to a panic; now to just the |
| 915 |
pattern failing to compile. |
| 916 |
.IP 5. 4 |
| 917 |
The old mechanism did not detect illegal ranges in the definition of the |
| 918 |
property. Now, the range max must not be smaller than the range min. |
| 919 |
Otherwise, the pattern fails to compile. |
| 920 |
.IP 6. 4 |
| 921 |
The intention was to have each sub called only once during the lifetime |
| 922 |
of the program, so that a property's definition is immutable. This was |
| 923 |
relaxed so that it could be called once for all /i compilations, and |
| 924 |
potentially a second time for non\-/i (the sub is passed a parameter |
| 925 |
indicating which). However, in practice there were instances when this |
| 926 |
was broken, and multiple calls were possible. Those have been fixed. |
| 927 |
Now (besides the /i,non\-/i cases) the only way a sub can be called |
| 928 |
multiple times is if some component of it has not been defined yet. For |
| 929 |
example, suppose we have sub \fBIsA()\fR whose definition is known at compile |
| 930 |
time, and it in turn calls \fBisB()\fR whose definition is not yet known. |
| 931 |
\&\fBisA()\fR will be called each time a pattern it appears in is compiled. If |
| 932 |
\&\fBisA()\fR also calls \fBisC()\fR and that definition is known, \fBisC()\fR will be |
| 933 |
called just once. |
| 934 |
.IP 7. 4 |
| 935 |
There were some races and very long hangs should one thread be compiling |
| 936 |
the same property as another simultaneously. These have now been fixed. |
| 937 |
.RE |
| 938 |
.RS 4 |
| 939 |
.RE |
| 940 |
.IP \(bu 4 |
| 941 |
Fixed a failure to match properly. |
| 942 |
.Sp |
| 943 |
An EXACTFish regnode has a finite length it can hold for the string |
| 944 |
being matched. If that length is exceeded, a second node is used for |
| 945 |
the next segment of the string, for as many regnodes as are needed. |
| 946 |
Care has to be taken where to break the string, in order to deal |
| 947 |
multi-character folds in Unicode correctly. If we want to break a |
| 948 |
string at a place which could potentially be in the middle of a |
| 949 |
multi-character fold, we back off one (or more) characters, leaving |
| 950 |
a shorter EXACTFish regnode. This backing off mechanism contained |
| 951 |
an off-by-one error. |
| 952 |
[GH #16806] <https://github.com/Perl/perl5/issues/16806>. |
| 953 |
.IP \(bu 4 |
| 954 |
A bare \f(CW\*(C`eof\*(C'\fR call with no previous file handle now returns true. |
| 955 |
[GH #16786] <https://github.com/Perl/perl5/issues/16786> |
| 956 |
.IP \(bu 4 |
| 957 |
Failing to compile a format now aborts compilation. Like other errors |
| 958 |
in sub-parses this could leave the parser in a strange state, possibly |
| 959 |
crashing perl if compilation continued. |
| 960 |
[GH #16169] <https://github.com/Perl/perl5/issues/16169> |
| 961 |
.IP \(bu 4 |
| 962 |
If an in-place edit is still in progress during global destruction and |
| 963 |
the process exit code (as stored in \f(CW$?\fR) is zero, perl will now |
| 964 |
treat the in-place edit as successful, replacing the input file with |
| 965 |
any output produced. |
| 966 |
.Sp |
| 967 |
This allows code like: |
| 968 |
.Sp |
| 969 |
.Vb 1 |
| 970 |
\& perl \-i \-ne \*(Aqprint "Foo"; last\*(Aq |
| 971 |
.Ve |
| 972 |
.Sp |
| 973 |
to replace the input file, while code like: |
| 974 |
.Sp |
| 975 |
.Vb 1 |
| 976 |
\& perl \-i \-ne \*(Aqprint "Foo"; die\*(Aq |
| 977 |
.Ve |
| 978 |
.Sp |
| 979 |
will not. Partly resolves |
| 980 |
[GH #16748] <https://github.com/Perl/perl5/issues/16748>. |
| 981 |
.IP \(bu 4 |
| 982 |
A regression in 5.28 caused the following code to fail |
| 983 |
.Sp |
| 984 |
.Vb 1 |
| 985 |
\& close(STDIN); open(CHILD, "|wc \-l")\*(Aq |
| 986 |
.Ve |
| 987 |
.Sp |
| 988 |
because the child's stdin would be closed on exec. This has now been fixed. |
| 989 |
.IP \(bu 4 |
| 990 |
Fixed an issue where compiling a regexp containing both compile-time |
| 991 |
and run-time code blocks could lead to trying to compile something |
| 992 |
which is invalid syntax. |
| 993 |
.IP \(bu 4 |
| 994 |
Fixed build failures with \f(CW\*(C`\-DNO_LOCALE_NUMERIC\*(C'\fR and |
| 995 |
\&\f(CW\*(C`\-DNO_LOCALE_COLLATE\*(C'\fR. |
| 996 |
[GH #16771] <https://github.com/Perl/perl5/issues/16771>. |
| 997 |
.IP \(bu 4 |
| 998 |
Prevent the tests in \fIext/B/t/strict.t\fR from being skipped. |
| 999 |
[GH #16783] <https://github.com/Perl/perl5/issues/16783>. |
| 1000 |
.IP \(bu 4 |
| 1001 |
\&\f(CW\*(C`/di\*(C'\fR nodes ending or beginning in \fIs\fR are now \f(CW\*(C`EXACTF\*(C'\fR. We do not |
| 1002 |
want two \f(CW\*(C`EXACTFU\*(C'\fR to be joined together during optimization, |
| 1003 |
and to form a \f(CW\*(C`ss\*(C'\fR, \f(CW\*(C`sS\*(C'\fR, \f(CW\*(C`Ss\*(C'\fR or \f(CW\*(C`SS\*(C'\fR sequence; |
| 1004 |
they are the only multi-character sequences which may match differently |
| 1005 |
under \f(CW\*(C`/ui\*(C'\fR and \f(CW\*(C`/di\*(C'\fR. |
| 1006 |
.SH Acknowledgements |
| 1007 |
.IX Header "Acknowledgements" |
| 1008 |
Perl 5.30.0 represents approximately 11 months of development since Perl |
| 1009 |
5.28.0 and contains approximately 620,000 lines of changes across 1,300 |
| 1010 |
files from 58 authors. |
| 1011 |
.PP |
| 1012 |
Excluding auto-generated files, documentation and release tools, there were |
| 1013 |
approximately 510,000 lines of changes to 750 .pm, .t, .c and .h files. |
| 1014 |
.PP |
| 1015 |
Perl continues to flourish into its fourth decade thanks to a vibrant |
| 1016 |
community of users and developers. The following people are known to have |
| 1017 |
contributed the improvements that became Perl 5.30.0: |
| 1018 |
.PP |
| 1019 |
Aaron Crane, Abigail, Alberto Simões, Alexandr Savca, Andreas König, Andy |
| 1020 |
Dougherty, Aristotle Pagaltzis, Brian Greenfield, Chad Granum, Chris |
| 1021 |
\&'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Book, Dan |
| 1022 |
Dedrick, Daniel Dragan, Dan Kogai, David Cantrell, David Mitchell, Dominic |
| 1023 |
Hargreaves, E. Choroba, Ed J, Eugen Konkov, François Perrad, Graham Knop, |
| 1024 |
Hauke D, H.Merijn Brand, Hugo van der Sanden, Jakub Wilk, James Clarke, |
| 1025 |
James E Keenan, Jerry D. Hedden, Jim Cromie, John SJ Anderson, Karen |
| 1026 |
Etheridge, Karl Williamson, Leon Timmermans, Matthias Bethke, Nicholas |
| 1027 |
Clark, Nicolas R., Niko Tyni, Pali, Petr Písař, Phil Pearl (Lobbes), |
| 1028 |
Richard Leach, Ryan Voots, Sawyer X, Shlomi Fish, Sisyphus, Slaven Rezic, |
| 1029 |
Steve Hay, Sullivan Beck, Tina Müller, Tomasz Konojacki, Tom Wyant, Tony |
| 1030 |
Cook, Unicode Consortium, Yves Orton, Zak B. Elep. |
| 1031 |
.PP |
| 1032 |
The list above is almost certainly incomplete as it is automatically |
| 1033 |
generated from version control history. In particular, it does not include |
| 1034 |
the names of most of the (very much appreciated) contributors who reported |
| 1035 |
issues to the Perl bug tracker. Noteworthy in this release were the large |
| 1036 |
number of bug fixes made possible by Sergey Aleynikov's high quality perlbug |
| 1037 |
reports for issues he discovered by fuzzing with AFL. |
| 1038 |
.PP |
| 1039 |
Many of the changes included in this version originated in the CPAN modules |
| 1040 |
included in Perl's core. We're grateful to the entire CPAN community for |
| 1041 |
helping Perl to flourish. |
| 1042 |
.PP |
| 1043 |
For a more complete list of all of Perl's historical contributors, please |
| 1044 |
see the \fIAUTHORS\fR file in the Perl source distribution. |
| 1045 |
.SH "Reporting Bugs" |
| 1046 |
.IX Header "Reporting Bugs" |
| 1047 |
If you find what you think is a bug, you might check the perl bug database |
| 1048 |
at <https://rt.perl.org/>. There may also be information at |
| 1049 |
<http://www.perl.org/>, the Perl Home Page. |
| 1050 |
.PP |
| 1051 |
If you believe you have an unreported bug, please run the perlbug program |
| 1052 |
included with your release. Be sure to trim your bug down to a tiny but |
| 1053 |
sufficient test case. Your bug report, along with the output of \f(CW\*(C`perl \-V\*(C'\fR, |
| 1054 |
will be sent off to [email protected] to be analysed by the Perl porting team. |
| 1055 |
.PP |
| 1056 |
If the bug you are reporting has security implications which make it |
| 1057 |
inappropriate to send to a publicly archived mailing list, then see |
| 1058 |
"SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec |
| 1059 |
for details of how to report the issue. |
| 1060 |
.SH "Give Thanks" |
| 1061 |
.IX Header "Give Thanks" |
| 1062 |
If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, |
| 1063 |
you can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program: |
| 1064 |
.PP |
| 1065 |
.Vb 1 |
| 1066 |
\& perlthanks |
| 1067 |
.Ve |
| 1068 |
.PP |
| 1069 |
This will send an email to the Perl 5 Porters list with your show of thanks. |
| 1070 |
.SH "SEE ALSO" |
| 1071 |
.IX Header "SEE ALSO" |
| 1072 |
The \fIChanges\fR file for an explanation of how to view exhaustive details on |
| 1073 |
what changed. |
| 1074 |
.PP |
| 1075 |
The \fIINSTALL\fR file for how to build Perl. |
| 1076 |
.PP |
| 1077 |
The \fIREADME\fR file for general stuff. |
| 1078 |
.PP |
| 1079 |
The \fIArtistic\fR and \fICopying\fR files for copyright information. |