Debian Codegraph @

upstream/mageia-cauldron/man1/perl5300delta.1

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