Debian Codegraph @

upstream/opensuse-tumbleweed/man1/perl5280delta.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 "PERL5280DELTA 1"
61 .TH PERL5280DELTA 1 2026-03-09 "perl v5.42.1" "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 perl5280delta \- what is new for perl v5.28.0
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 This document describes differences between the 5.26.0 release and the 5.28.0
71 release.
72 .PP
73 If you are upgrading from an earlier release such as 5.24.0, first read
74 perl5260delta, which describes differences between 5.24.0 and 5.26.0.
75 .SH "Core Enhancements"
76 .IX Header "Core Enhancements"
77 .SS "Unicode 10.0 is supported"
78 .IX Subsection "Unicode 10.0 is supported"
79 A list of changes is at
80 <http://www.unicode.org/versions/Unicode10.0.0>.
81 .ie n .SS """delete"" on key/value hash slices"
82 .el .SS "\f(CWdelete\fP on key/value hash slices"
83 .IX Subsection "delete on key/value hash slices"
84 \&\f(CW\*(C`delete\*(C'\fR can now be used on
85 key/value hash slices,
86 returning the keys along with the deleted values.
87 [GH #15982] <https://github.com/Perl/perl5/issues/15982>
88 .SS "Experimentally, there are now alphabetic synonyms for some regular expression assertions"
89 .IX Subsection "Experimentally, there are now alphabetic synonyms for some regular expression assertions"
90 If you find it difficult to remember how to write certain of the pattern
91 assertions, there are now alphabetic synonyms.
92 .PP
93 .Vb 7
94 \& CURRENT NEW SYNONYMS
95 \& \-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
96 \& (?=...) (*pla:...) or (*positive_lookahead:...)
97 \& (?!...) (*nla:...) or (*negative_lookahead:...)
98 \& (?<=...) (*plb:...) or (*positive_lookbehind:...)
99 \& (?<!...) (*nlb:...) or (*negative_lookbehind:...)
100 \& (?>...) (*atomic:...)
101 .Ve
102 .PP
103 These are considered experimental, so using any of these will raise
104 (unless turned off) a warning in the \f(CW\*(C`experimental::alpha_assertions\*(C'\fR
105 category.
106 .SS "Mixed Unicode scripts are now detectable"
107 .IX Subsection "Mixed Unicode scripts are now detectable"
108 A mixture of scripts, such as Cyrillic and Latin, in a string is often
109 the sign of a spoofing attack. A new regular expression construct
110 now allows for easy detection of these. For example, you can say
111 .PP
112 .Vb 1
113 \& qr/(*script_run: \ed+ \eb )/x
114 .Ve
115 .PP
116 And the digits matched will all be from the same set of 10. You won\*(Aqt
117 get a look\-alike digit from a different script that has a different
118 value than what it appears to be.
119 .PP
120 Or:
121 .PP
122 .Vb 1
123 \& qr/(*sr: \eb \ew+ \eb )/x
124 .Ve
125 .PP
126 makes sure that all the characters come from the same script.
127 .PP
128 You can also combine script runs with \f(CW\*(C`(?>...)\*(C'\fR (or
129 \&\f(CW\*(C`*atomic:...)\*(C'\fR).
130 .PP
131 Instead of writing:
132 .PP
133 .Vb 1
134 \& (*sr:(?<...))
135 .Ve
136 .PP
137 you can now run:
138 .PP
139 .Vb 3
140 \& (*asr:...)
141 \& # or
142 \& (*atomic_script_run:...)
143 .Ve
144 .PP
145 This is considered experimental, so using it will raise (unless turned
146 off) a warning in the \f(CW\*(C`experimental::script_run\*(C'\fR category.
147 .PP
148 See "Script Runs" in perlre.
149 .ie n .SS "In\-place editing with ""perl \-i"" is now safer"
150 .el .SS "In\-place editing with \f(CWperl \-i\fP is now safer"
151 .IX Subsection "In-place editing with perl -i is now safer"
152 Previously in\-place editing (\f(CW\*(C`perl \-i\*(C'\fR) would delete or rename the
153 input file as soon as you started working on a new file.
154 .PP
155 Without backups this would result in loss of data if there was an
156 error, such as a full disk, when writing to the output file.
157 .PP
158 This has changed so that the input file isn\*(Aqt replaced until the
159 output file has been completely written and successfully closed.
160 .PP
161 This works by creating a work file in the same directory, which is
162 renamed over the input file once the output file is complete.
163 .PP
164 Incompatibilities:
165 .IP \(bu 4
166 Since this renaming needs to only happen once, if you create a thread
167 or child process, that renaming will only happen in the original
168 thread or process.
169 .IP \(bu 4
170 If you change directories while processing a file, and your operating
171 system doesn\*(Aqt provide the \f(CWunlinkat()\fR, \f(CWrenameat()\fR and \f(CWfchmodat()\fR
172 functions, the final rename step may fail.
173 .PP
174 [GH #15216] <https://github.com/Perl/perl5/issues/15216>
175 .SS "Initialisation of aggregate state variables"
176 .IX Subsection "Initialisation of aggregate state variables"
177 A persistent lexical array or hash variable can now be initialized,
178 by an expression such as \f(CW\*(C`state @a = qw(x y z)\*(C'\fR. Initialization of a
179 list of persistent lexical variables is still not possible.
180 .SS "Full\-size inode numbers"
181 .IX Subsection "Full-size inode numbers"
182 On platforms where inode numbers are of a type larger than perl\*(Aqs native
183 integer numerical types, stat will preserve the full
184 content of large inode numbers by returning them in the form of strings of
185 decimal digits. Exact comparison of inode numbers can thus be achieved by
186 comparing with \f(CW\*(C`eq\*(C'\fR rather than \f(CW\*(C`==\*(C'\fR. Comparison with \f(CW\*(C`==\*(C'\fR, and other
187 numerical operations (which are usually meaningless on inode numbers),
188 work as well as they did before, which is to say they fall back to
189 floating point, and ultimately operate on a fairly useless rounded inode
190 number if the real inode number is too big for the floating point format.
191 .ie n .SS "The ""sprintf"" %j format size modifier is now available with pre\-C99 compilers"
192 .el .SS "The \f(CWsprintf\fP \f(CW%j\fP format size modifier is now available with pre\-C99 compilers"
193 .IX Subsection "The sprintf %j format size modifier is now available with pre-C99 compilers"
194 The actual size used depends on the platform, so remains unportable.
195 .SS "Close\-on\-exec flag set atomically"
196 .IX Subsection "Close-on-exec flag set atomically"
197 When opening a file descriptor, perl now generally opens it with its
198 close\-on\-exec flag already set, on platforms that support doing so.
199 This improves thread safety, because it means that an \f(CW\*(C`exec\*(C'\fR initiated
200 by one thread can no longer cause a file descriptor in the process
201 of being opened by another thread to be accidentally passed to the
202 executed program.
203 .PP
204 Additionally, perl now sets the close\-on\-exec flag more reliably, whether
205 it does so atomically or not. Most file descriptors were getting the
206 flag set, but some were being missed.
207 .SS "String\- and number\-specific bitwise ops are no longer experimental"
208 .IX Subsection "String- and number-specific bitwise ops are no longer experimental"
209 The new string\-specific (\f(CW\*(C`&. |. ^. ~.\*(C'\fR) and number\-specific (\f(CW\*(C`& | ^ ~\*(C'\fR)
210 bitwise operators introduced in Perl 5.22 that are available within the
211 scope of \f(CW\*(C`use feature \*(Aqbitwise\*(Aq\*(C'\fR are no longer experimental.
212 Because the number\-specific ops are spelled the same way as the existing
213 operators that choose their behaviour based on their operands, these
214 operators must still be enabled via the "bitwise" feature, in either of
215 these two ways:
216 .PP
217 .Vb 1
218 \& use feature "bitwise";
219 \&
220 \& use v5.28; # "bitwise" now included
221 .Ve
222 .PP
223 They are also now enabled by the \fB\-E\fR command\-line switch.
224 .PP
225 The "bitwise" feature no longer emits a warning. Existing code that
226 disables the "experimental::bitwise" warning category that the feature
227 previously used will continue to work.
228 .PP
229 One caveat that module authors ought to be aware of is that the numeric
230 operators now pass a fifth TRUE argument to overload methods. Any methods
231 that check the number of operands may croak if they do not expect so many.
232 XS authors in particular should be aware that this:
233 .PP
234 .Vb 2
235 \& SV *
236 \& bitop_handler (lobj, robj, swap)
237 .Ve
238 .PP
239 may need to be changed to this:
240 .PP
241 .Vb 2
242 \& SV *
243 \& bitop_handler (lobj, robj, swap, ...)
244 .Ve
245 .SS "Locales are now thread\-safe on systems that support them"
246 .IX Subsection "Locales are now thread-safe on systems that support them"
247 These systems include Windows starting with Visual Studio 2005, and in
248 POSIX 2008 systems.
249 .PP
250 The implication is that you are now free to use locales and change them
251 in a threaded environment. Your changes affect only your thread.
252 See "Multi\-threaded operation" in perllocale
253 .ie n .SS "New read\-only predefined variable ""${^SAFE_LOCALES}"""
254 .el .SS "New read\-only predefined variable \f(CW${^SAFE_LOCALES}\fP"
255 .IX Subsection "New read-only predefined variable ${^SAFE_LOCALES}"
256 This variable is 1 if the Perl interpreter is operating in an
257 environment where it is safe to use and change locales (see
258 perllocale.) This variable is true when the perl is
259 unthreaded, or compiled in a platform that supports thread\-safe locale
260 operation (see previous item).
261 .SH Security
262 .IX Header "Security"
263 .SS "[CVE\-2017\-12837] Heap buffer overflow in regular expression compiler"
264 .IX Subsection "[CVE-2017-12837] Heap buffer overflow in regular expression compiler"
265 Compiling certain regular expression patterns with the case\-insensitive
266 modifier could cause a heap buffer overflow and crash perl. This has now been
267 fixed.
268 [GH #16021] <https://github.com/Perl/perl5/issues/16021>
269 .SS "[CVE\-2017\-12883] Buffer over\-read in regular expression parser"
270 .IX Subsection "[CVE-2017-12883] Buffer over-read in regular expression parser"
271 For certain types of syntax error in a regular expression pattern, the error
272 message could either contain the contents of a random, possibly large, chunk of
273 memory, or could crash perl. This has now been fixed.
274 [GH #16025] <https://github.com/Perl/perl5/issues/16025>
275 .ie n .SS "[CVE\-2017\-12814] $ENV{$key} stack buffer overflow on Windows"
276 .el .SS "[CVE\-2017\-12814] \f(CW$ENV{$key}\fP stack buffer overflow on Windows"
277 .IX Subsection "[CVE-2017-12814] $ENV{$key} stack buffer overflow on Windows"
278 A possible stack buffer overflow in the \f(CW%ENV\fR code on Windows has been fixed
279 by removing the buffer completely since it was superfluous anyway.
280 [GH #16051] <https://github.com/Perl/perl5/issues/16051>
281 .SS "Default Hash Function Change"
282 .IX Subsection "Default Hash Function Change"
283 Perl 5.28.0 retires various older hash functions which are not viewed as
284 sufficiently secure for use in Perl. We now support four general purpose
285 hash functions, Siphash (2\-4 and 1\-3 variants), and Zaphod32, and StadtX
286 hash. In addition we support SBOX32 (a form of tabular hashing) for hashing
287 short strings, in conjunction with any of the other hash functions provided.
288 .PP
289 By default Perl is configured to support SBOX hashing of strings up to 24
290 characters, in conjunction with StadtX hashing on 64 bit builds, and
291 Zaphod32 hashing for 32 bit builds.
292 .PP
293 You may control these settings with the following options to Configure:
294 .PP
295 .Vb 4
296 \& \-DPERL_HASH_FUNC_SIPHASH
297 \& \-DPERL_HASH_FUNC_SIPHASH13
298 \& \-DPERL_HASH_FUNC_STADTX
299 \& \-DPERL_HASH_FUNC_ZAPHOD32
300 .Ve
301 .PP
302 To disable SBOX hashing you can use
303 .PP
304 .Vb 1
305 \& \-DPERL_HASH_USE_SBOX32_ALSO=0
306 .Ve
307 .PP
308 And to set the maximum length to use SBOX32 hashing on with:
309 .PP
310 .Vb 1
311 \& \-DSBOX32_MAX_LEN=16
312 .Ve
313 .PP
314 The maximum length allowed is 256. There probably isn\*(Aqt much point
315 in setting it higher than the default.
316 .SH "Incompatible Changes"
317 .IX Header "Incompatible Changes"
318 .SS "Subroutine attribute and signature order"
319 .IX Subsection "Subroutine attribute and signature order"
320 The experimental subroutine signatures feature has been changed so that
321 subroutine attributes must now come before the signature rather than
322 after. This is because attributes like \f(CW\*(C`:lvalue\*(C'\fR can affect the
323 compilation of code within the signature, for example:
324 .PP
325 .Vb 1
326 \& sub f :lvalue ($a = do { $x = "abc"; return substr($x,0,1)}) { ...}
327 .Ve
328 .PP
329 Note that this the second time they have been flipped:
330 .PP
331 .Vb 2
332 \& sub f :lvalue ($a, $b) { ... }; # 5.20; 5.28 onwards
333 \& sub f ($a, $b) :lvalue { ... }; # 5.22 \- 5.26
334 .Ve
335 .SS "Comma\-less variable lists in formats are no longer allowed"
336 .IX Subsection "Comma-less variable lists in formats are no longer allowed"
337 Omitting the commas between variables passed to formats is no longer
338 allowed. This has been deprecated since Perl 5.000.
339 .ie n .SS "The "":locked"" and "":unique"" attributes have been removed"
340 .el .SS "The \f(CW:locked\fP and \f(CW:unique\fP attributes have been removed"
341 .IX Subsection "The :locked and :unique attributes have been removed"
342 These have been no\-ops and deprecated since Perl 5.12 and 5.10,
343 respectively.
344 .ie n .SS """\eN{}"" with nothing between the braces is now illegal"
345 .el .SS "\f(CW\eN{}\fP with nothing between the braces is now illegal"
346 .IX Subsection "N{} with nothing between the braces is now illegal"
347 This has been deprecated since Perl 5.24.
348 .SS "Opening the same symbol as both a file and directory handle is no longer allowed"
349 .IX Subsection "Opening the same symbol as both a file and directory handle is no longer allowed"
350 Using \f(CWopen()\fR and \f(CWopendir()\fR to associate both a filehandle and a dirhandle
351 to the same symbol (glob or scalar) has been deprecated since Perl 5.10.
352 .ie n .SS "Use of bare ""<<"" to mean ""<<"""""" is no longer allowed"
353 .el .SS "Use of bare \f(CW<<\fP to mean \f(CW<<""""\fP is no longer allowed"
354 .IX Subsection "Use of bare << to mean <<"""" is no longer allowed"
355 Use of a bare terminator has been deprecated since Perl 5.000.
356 .SS "Setting $/ to a reference to a non\-positive integer no longer allowed"
357 .IX Subsection "Setting $/ to a reference to a non-positive integer no longer allowed"
358 This used to work like setting it to \f(CW\*(C`undef\*(C'\fR, but has been deprecated
359 since Perl 5.20.
360 .ie n .SS "Unicode code points with values exceeding ""IV_MAX"" are now fatal"
361 .el .SS "Unicode code points with values exceeding \f(CWIV_MAX\fP are now fatal"
362 .IX Subsection "Unicode code points with values exceeding IV_MAX are now fatal"
363 This was deprecated since Perl 5.24.
364 .ie n .SS "The ""B::OP::terse"" method has been removed"
365 .el .SS "The \f(CWB::OP::terse\fP method has been removed"
366 .IX Subsection "The B::OP::terse method has been removed"
367 Use \f(CW\*(C`B::Concise::b_terse\*(C'\fR instead.
368 .SS "Use of inherited AUTOLOAD for non\-methods is no longer allowed"
369 .IX Subsection "Use of inherited AUTOLOAD for non-methods is no longer allowed"
370 This was deprecated in Perl 5.004.
371 .SS "Use of strings with code points over 0xFF is not allowed for bitwise string operators"
372 .IX Subsection "Use of strings with code points over 0xFF is not allowed for bitwise string operators"
373 Code points over \f(CW0xFF\fR do not make sense for bitwise operators and such
374 an operation will now croak, except for a few remaining cases. See
375 perldeprecation.
376 .PP
377 This was deprecated in Perl 5.24.
378 .ie n .SS "Setting ""${^ENCODING}"" to a defined value is now illegal"
379 .el .SS "Setting \f(CW${^ENCODING}\fP to a defined value is now illegal"
380 .IX Subsection "Setting ${^ENCODING} to a defined value is now illegal"
381 This has been deprecated since Perl 5.22 and a no\-op since Perl 5.26.
382 .ie n .SS "Backslash no longer escapes colon in PATH for the ""\-S"" switch"
383 .el .SS "Backslash no longer escapes colon in PATH for the \f(CW\-S\fP switch"
384 .IX Subsection "Backslash no longer escapes colon in PATH for the -S switch"
385 Previously the \f(CW\*(C`\-S\*(C'\fR switch incorrectly treated backslash ("\e") as an
386 escape for colon when traversing the \f(CW\*(C`PATH\*(C'\fR environment variable.
387 [GH #15584] <https://github.com/Perl/perl5/issues/15584>
388 .SS "the \-DH (DEBUG_H) misfeature has been removed"
389 .IX Subsection "the -DH (DEBUG_H) misfeature has been removed"
390 On a perl built with debugging support, the \f(CW\*(C`H\*(C'\fR flag to the \f(CW\*(C`\-D\*(C'\fR
391 debugging option has been removed. This was supposed to dump hash values,
392 but has been broken for many years.
393 .SS "Yada\-yada is now strictly a statement"
394 .IX Subsection "Yada-yada is now strictly a statement"
395 By the time of its initial stable release in Perl 5.12, the \f(CW\*(C`...\*(C'\fR
396 (yada\-yada) operator was explicitly intended to serve as a statement,
397 not an expression. However, the original implementation was confused
398 on this point, leading to inconsistent parsing. The operator was
399 accidentally accepted in a few situations where it did not serve as a
400 complete statement, such as
401 .PP
402 .Vb 2
403 \& ... . "foo";
404 \& ... if $a < $b;
405 .Ve
406 .PP
407 The parsing has now been made consistent, permitting yada\-yada only as
408 a statement. Affected code can use \f(CW\*(C`do{...}\*(C'\fR to put a yada\-yada into
409 an arbitrary expression context.
410 .SS "Sort algorithm can no longer be specified"
411 .IX Subsection "Sort algorithm can no longer be specified"
412 Since Perl 5.8, the sort pragma has had subpragmata \f(CW\*(C`_mergesort\*(C'\fR,
413 \&\f(CW\*(C`_quicksort\*(C'\fR, and \f(CW\*(C`_qsort\*(C'\fR that can be used to specify which algorithm
414 perl should use to implement the sort builtin.
415 This was always considered a dubious feature that might not last,
416 hence the underscore spellings, and they were documented as not being
417 portable beyond Perl 5.8. These subpragmata have now been deleted,
418 and any attempt to use them is an error. The sort pragma otherwise
419 remains, and the algorithm\-neutral \f(CW\*(C`stable\*(C'\fR subpragma can be used to
420 control sorting behaviour.
421 [GH #13234] <https://github.com/Perl/perl5/issues/13234>
422 .SS "Over\-radix digits in floating point literals"
423 .IX Subsection "Over-radix digits in floating point literals"
424 Octal and binary floating point literals used to permit any hexadecimal
425 digit to appear after the radix point. The digits are now restricted
426 to those appropriate for the radix, as digits before the radix point
427 always were.
428 .ie n .SS "Return type of unpackstring()"
429 .el .SS "Return type of \f(CWunpackstring()\fP"
430 .IX Subsection "Return type of unpackstring()"
431 The return types of the C API functions \f(CWunpackstring()\fR and
432 \&\f(CWunpack_str()\fR have changed from \f(CW\*(C`I32\*(C'\fR to \f(CW\*(C`SSize_t\*(C'\fR, in order to
433 accommodate datasets of more than two billion items.
434 .SH Deprecations
435 .IX Header "Deprecations"
436 .ie n .SS "Use of ""vec"" on strings with code points above 0xFF is deprecated"
437 .el .SS "Use of \f(CWvec\fP on strings with code points above 0xFF is deprecated"
438 .IX Subsection "Use of vec on strings with code points above 0xFF is deprecated"
439 Such strings are represented internally in UTF\-8, and \f(CW\*(C`vec\*(C'\fR is a
440 bit\-oriented operation that will likely give unexpected results on those
441 strings.
442 .ie n .SS "Some uses of unescaped ""{"" in regexes are no longer fatal"
443 .el .SS "Some uses of unescaped \f(CW""{""\fP in regexes are no longer fatal"
444 .IX Subsection "Some uses of unescaped ""{"" in regexes are no longer fatal"
445 Perl 5.26.0 fatalized some uses of an unescaped left brace, but an
446 exception was made at the last minute, specifically crafted to be a
447 minimal change to allow GNU Autoconf to work. That tool is heavily
448 depended upon, and continues to use the deprecated usage. Its use of an
449 unescaped left brace is one where we have no intention of repurposing
450 \&\f(CW"{"\fR to be something other than itself.
451 .PP
452 That exception is now generalized to include various other such cases
453 where the \f(CW"{"\fR will not be repurposed.
454 .PP
455 Note that these uses continue to raise a deprecation message.
456 .ie n .SS "Use of unescaped ""{"" immediately after a ""("" in regular expression patterns is deprecated"
457 .el .SS "Use of unescaped \f(CW""{""\fP immediately after a \f(CW""(""\fP in regular expression patterns is deprecated"
458 .IX Subsection "Use of unescaped ""{"" immediately after a ""("" in regular expression patterns is deprecated"
459 Using unescaped left braces is officially deprecated everywhere, but it
460 is not enforced in contexts where their use does not interfere with
461 expected extensions to the language. A deprecation is added in this
462 release when the brace appears immediately after an opening parenthesis.
463 Before this, even if the brace was part of a legal quantifier, it was
464 not interpreted as such, but as the literal characters, unlike other
465 quantifiers that follow a \f(CW"("\fR which are considered errors. Now,
466 their use will raise a deprecation message, unless turned off.
467 .ie n .SS "Assignment to $[ will be fatal in Perl 5.30"
468 .el .SS "Assignment to \f(CW$[\fP will be fatal in Perl 5.30"
469 .IX Subsection "Assignment to $[ will be fatal in Perl 5.30"
470 Assigning a non\-zero value to \f(CW$[\fR has been deprecated
471 since Perl 5.12, but was never given a deadline for removal. This has
472 now been scheduled for Perl 5.30.
473 .SS "\fBhostname()\fP won\*(Aqt accept arguments in Perl 5.32"
474 .IX Subsection "hostname() won't accept arguments in Perl 5.32"
475 Passing arguments to \f(CWSys::Hostname::hostname()\fR was already deprecated,
476 but didn\*(Aqt have a removal date. This has now been scheduled for Perl
477 5.32. [GH #14662] <https://github.com/Perl/perl5/issues/14662>
478 .SS "Module removals"
479 .IX Subsection "Module removals"
480 The following modules will be removed from the core distribution in a
481 future release, and will at that time need to be installed from CPAN.
482 Distributions on CPAN which require these modules will need to list them as
483 prerequisites.
484 .PP
485 The core versions of these modules will now issue \f(CW"deprecated"\fR\-category
486 warnings to alert you to this fact. To silence these deprecation warnings,
487 install the modules in question from CPAN.
488 .PP
489 Note that these are (with rare exceptions) fine modules that you are encouraged
490 to continue to use. Their disinclusion from core primarily hinges on their
491 necessity to bootstrapping a fully functional, CPAN\-capable Perl installation,
492 not usually on concerns over their design.
493 .IP B::Debug 4
494 .IX Item "B::Debug"
495 .PD 0
496 .IP "Locale::Codes and its associated Country, Currency and Language modules" 4
497 .IX Item "Locale::Codes and its associated Country, Currency and Language modules"
498 .PD
499 .SH "Performance Enhancements"
500 .IX Header "Performance Enhancements"
501 .IP \(bu 4
502 The start up overhead for creating regular expression patterns with
503 Unicode properties (\f(CW\*(C`\ep{...}\*(C'\fR) has been greatly reduced in most cases.
504 .IP \(bu 4
505 Many string concatenation expressions are now considerably faster, due
506 to the introduction internally of a \f(CW\*(C`multiconcat\*(C'\fR opcode which combines
507 multiple concatenations, and optionally a \f(CW\*(C`=\*(C'\fR or \f(CW\*(C`.=\*(C'\fR, into a single
508 action. For example, apart from retrieving \f(CW$s\fR, \f(CW$a\fR and \f(CW$b\fR, this
509 whole expression is now handled as a single op:
510 .Sp
511 .Vb 1
512 \& $s .= "a=$a b=$b\en"
513 .Ve
514 .Sp
515 As a special case, if the LHS of an assignment is a lexical variable or
516 \&\f(CW\*(C`my $s\*(C'\fR, the op itself handles retrieving the lexical variable, which
517 is faster.
518 .Sp
519 In general, the more the expression includes a mix of constant strings and
520 variable expressions, the longer the expression, and the more it mixes
521 together non\-utf8 and utf8 strings, the more marked the performance
522 improvement. For example on a \f(CW\*(C`x86_64\*(C'\fR system, this code has been
523 benchmarked running four times faster:
524 .Sp
525 .Vb 4
526 \& my $s;
527 \& my $a = "ab\ex{100}cde";
528 \& my $b = "fghij";
529 \& my $c = "\ex{101}klmn";
530 \&
531 \& for my $i (1..10_000_000) {
532 \& $s = "\ex{100}wxyz";
533 \& $s .= "foo=$a bar=$b baz=$c";
534 \& }
535 .Ve
536 .Sp
537 In addition, \f(CW\*(C`sprintf\*(C'\fR expressions which have a constant format
538 containing only \f(CW%s\fR and \f(CW\*(C`%%\*(C'\fR format elements, and which have a fixed
539 number of arguments, are now also optimised into a \f(CW\*(C`multiconcat\*(C'\fR op.
540 .IP \(bu 4
541 The \f(CWref()\fR builtin is now much faster in boolean context, since it no
542 longer bothers to construct a temporary string like \f(CW\*(C`Foo=ARRAY(0x134af48)\*(C'\fR.
543 .IP \(bu 4
544 \&\f(CWkeys()\fR in void and scalar contexts is now more efficient.
545 .IP \(bu 4
546 The common idiom of comparing the result of \fBindex()\fR with \-1 is now
547 specifically optimised, e.g.
548 .Sp
549 .Vb 1
550 \& if (index(...) != \-1) { ... }
551 .Ve
552 .IP \(bu 4
553 \&\f(CWfor()\fR loops and similar constructs are now more efficient in most cases.
554 .IP \(bu 4
555 File::Glob has been modified to remove unnecessary backtracking and
556 recursion, thanks to Russ Cox. See <https://research.swtch.com/glob>
557 for more details.
558 .IP \(bu 4
559 The XS\-level \f(CWSvTRUE()\fR API function is now more efficient.
560 .IP \(bu 4
561 Various integer\-returning ops are now more efficient in scalar/boolean context.
562 .IP \(bu 4
563 Slightly improved performance when parsing stash names.
564 [GH #15689] <https://github.com/Perl/perl5/issues/15689>
565 .IP \(bu 4
566 Calls to \f(CW\*(C`require\*(C'\fR for an already loaded module are now slightly faster.
567 [GH #16175] <https://github.com/Perl/perl5/issues/16175>
568 .IP \(bu 4
569 The performance of pattern matching \f(CW\*(C`[[:ascii:]]\*(C'\fR and \f(CW\*(C`[[:^ascii:]]\*(C'\fR
570 has been improved significantly except on EBCDIC platforms.
571 .IP \(bu 4
572 Various optimizations have been applied to matching regular expression
573 patterns, so under the right circumstances, significant performance
574 gains may be noticed. But in an application with many varied patterns,
575 little overall improvement likely will be seen.
576 .IP \(bu 4
577 Other optimizations have been applied to UTF\-8 handling, but these are
578 not typically a major factor in most applications.
579 .SH "Modules and Pragmata"
580 .IX Header "Modules and Pragmata"
581 Key highlights in this release across several modules:
582 .SS "Removal of use vars"
583 .IX Subsection "Removal of use vars"
584 The usage of \f(CW\*(C`use vars\*(C'\fR has been discouraged since the introduction of
585 \&\f(CW\*(C`our\*(C'\fR in Perl 5.6.0. Where possible the usage of this pragma has now been
586 removed from the Perl source code.
587 .PP
588 This had a slight effect (for the better) on the output of WARNING_BITS in
589 B::Deparse.
590 .SS "Use of DynaLoader changed to XSLoader in many modules"
591 .IX Subsection "Use of DynaLoader changed to XSLoader in many modules"
592 XSLoader is more modern, and most modules already require perl 5.6 or
593 greater, so no functionality is lost by switching. In some cases, we have
594 also made changes to the local implementation that may not be reflected in
595 the version on CPAN due to a desire to maintain more backwards
596 compatibility.
597 .SS "Updated Modules and Pragmata"
598 .IX Subsection "Updated Modules and Pragmata"
599 .IP \(bu 4
600 Archive::Tar has been upgraded from version 2.24 to 2.30.
601 .Sp
602 This update also handled CVE\-2018\-12015: directory traversal
603 vulnerability.
604 [cpan #125523] <https://rt.cpan.org/Ticket/Display.html?id=125523>
605 .IP \(bu 4
606 arybase has been upgraded from version 0.12 to 0.15.
607 .IP \(bu 4
608 Attribute::Handlers has been upgraded from version 0.99 to 1.01.
609 .IP \(bu 4
610 attributes has been upgraded from version 0.29 to 0.33.
611 .IP \(bu 4
612 B has been upgraded from version 1.68 to 1.74.
613 .IP \(bu 4
614 B::Concise has been upgraded from version 0.999 to 1.003.
615 .IP \(bu 4
616 B::Debug has been upgraded from version 1.24 to 1.26.
617 .Sp
618 NOTE: B::Debug is deprecated and may be removed from a future version
619 of Perl.
620 .IP \(bu 4
621 B::Deparse has been upgraded from version 1.40 to 1.48.
622 .Sp
623 It includes many bug fixes, and in particular, it now deparses variable
624 attributes correctly:
625 .Sp
626 .Vb 2
627 \& my $x :foo; # used to deparse as
628 \& # \*(Aqattributes\*(Aq\->import(\*(Aqmain\*(Aq, \e$x, \*(Aqfoo\*(Aq), my $x;
629 .Ve
630 .IP \(bu 4
631 base has been upgraded from version 2.25 to 2.27.
632 .IP \(bu 4
633 bignum has been upgraded from version 0.47 to 0.49.
634 .IP \(bu 4
635 blib has been upgraded from version 1.06 to 1.07.
636 .IP \(bu 4
637 bytes has been upgraded from version 1.05 to 1.06.
638 .IP \(bu 4
639 Carp has been upgraded from version 1.42 to 1.50.
640 .Sp
641 If a package on the call stack contains a constant named \f(CW\*(C`ISA\*(C'\fR, Carp no
642 longer throws a "Not a GLOB reference" error.
643 .Sp
644 Carp, when generating stack traces, now attempts to work around
645 longstanding bugs resulting from Perl\*(Aqs non\-reference\-counted stack.
646 [GH #9282] <https://github.com/Perl/perl5/issues/9282>
647 .Sp
648 Carp has been modified to avoid assuming that objects cannot be
649 overloaded without the overload module loaded (this can happen with
650 objects created by XS modules). Previously, infinite recursion would
651 result if an XS\-defined overload method itself called Carp.
652 [GH #16407] <https://github.com/Perl/perl5/issues/16407>
653 .Sp
654 Carp now avoids using \f(CW\*(C`overload::StrVal\*(C'\fR, partly because older versions
655 of overload (included with perl 5.14 and earlier) load Scalar::Util
656 at run time, which will fail if Carp has been invoked after a syntax error.
657 .IP \(bu 4
658 charnames has been upgraded from version 1.44 to 1.45.
659 .IP \(bu 4
660 Compress::Raw::Zlib has been upgraded from version 2.074 to 2.076.
661 .Sp
662 This addresses a security vulnerability in older versions of the \*(Aqzlib\*(Aq library
663 (which is bundled with Compress\-Raw\-Zlib).
664 .IP \(bu 4
665 Config::Extensions has been upgraded from version 0.01 to 0.02.
666 .IP \(bu 4
667 Config::Perl::V has been upgraded from version 0.28 to 0.29.
668 .IP \(bu 4
669 CPAN has been upgraded from version 2.18 to 2.20.
670 .IP \(bu 4
671 Data::Dumper has been upgraded from version 2.167 to 2.170.
672 .Sp
673 Quoting of glob names now obeys the Useqq option
674 [GH #13274] <https://github.com/Perl/perl5/issues/13274>.
675 .Sp
676 Attempts to set an option to \f(CW\*(C`undef\*(C'\fR through a combined getter/setter
677 method are no longer mistaken for getter calls
678 [GH #12135] <https://github.com/Perl/perl5/issues/12135>.
679 .IP \(bu 4
680 Devel::Peek has been upgraded from version 1.26 to 1.27.
681 .IP \(bu 4
682 Devel::PPPort has been upgraded from version 3.35 to 3.40.
683 .Sp
684 Devel::PPPort has moved from cpan\-first to perl\-first maintenance
685 .Sp
686 Primary responsibility for the code in Devel::PPPort has moved into core perl.
687 In a practical sense there should be no change except that hopefully it will
688 stay more up to date with changes made to symbols in perl, rather than needing
689 to be updated after the fact.
690 .IP \(bu 4
691 Digest::SHA has been upgraded from version 5.96 to 6.01.
692 .IP \(bu 4
693 DirHandle has been upgraded from version 1.04 to 1.05.
694 .IP \(bu 4
695 DynaLoader has been upgraded from version 1.42 to 1.45.
696 .Sp
697 Its documentation now shows the use of \f(CW\*(C`_\|_PACKAGE_\|_\*(C'\fR and direct object
698 syntax
699 [GH #16190] <https://github.com/Perl/perl5/issues/16190>.
700 .IP \(bu 4
701 Encode has been upgraded from version 2.88 to 2.97.
702 .IP \(bu 4
703 encoding has been upgraded from version 2.19 to 2.22.
704 .IP \(bu 4
705 Errno has been upgraded from version 1.28 to 1.29.
706 .IP \(bu 4
707 experimental has been upgraded from version 0.016 to 0.019.
708 .IP \(bu 4
709 Exporter has been upgraded from version 5.72 to 5.73.
710 .IP \(bu 4
711 ExtUtils::CBuilder has been upgraded from version 0.280225 to 0.280230.
712 .IP \(bu 4
713 ExtUtils::Constant has been upgraded from version 0.23 to 0.25.
714 .IP \(bu 4
715 ExtUtils::Embed has been upgraded from version 1.34 to 1.35.
716 .IP \(bu 4
717 ExtUtils::Install has been upgraded from version 2.04 to 2.14.
718 .IP \(bu 4
719 ExtUtils::MakeMaker has been upgraded from version 7.24 to 7.34.
720 .IP \(bu 4
721 ExtUtils::Miniperl has been upgraded from version 1.06 to 1.08.
722 .IP \(bu 4
723 ExtUtils::ParseXS has been upgraded from version 3.34 to 3.39.
724 .IP \(bu 4
725 ExtUtils::Typemaps has been upgraded from version 3.34 to 3.38.
726 .IP \(bu 4
727 ExtUtils::XSSymSet has been upgraded from version 1.3 to 1.4.
728 .IP \(bu 4
729 feature has been upgraded from version 1.47 to 1.52.
730 .IP \(bu 4
731 fields has been upgraded from version 2.23 to 2.24.
732 .IP \(bu 4
733 File::Copy has been upgraded from version 2.32 to 2.33.
734 .Sp
735 It will now use the sub\-second precision variant of \fButime()\fR supplied by
736 Time::HiRes where available.
737 [GH #16225] <https://github.com/Perl/perl5/issues/16225>.
738 .IP \(bu 4
739 File::Fetch has been upgraded from version 0.52 to 0.56.
740 .IP \(bu 4
741 File::Glob has been upgraded from version 1.28 to 1.31.
742 .IP \(bu 4
743 File::Path has been upgraded from version 2.12_01 to 2.15.
744 .IP \(bu 4
745 File::Spec and Cwd have been upgraded from version 3.67 to 3.74.
746 .IP \(bu 4
747 File::stat has been upgraded from version 1.07 to 1.08.
748 .IP \(bu 4
749 FileCache has been upgraded from version 1.09 to 1.10.
750 .IP \(bu 4
751 Filter::Simple has been upgraded from version 0.93 to 0.95.
752 .IP \(bu 4
753 Filter::Util::Call has been upgraded from version 1.55 to 1.58.
754 .IP \(bu 4
755 GDBM_File has been upgraded from version 1.15 to 1.17.
756 .Sp
757 Its documentation now explains that \f(CW\*(C`each\*(C'\fR and \f(CW\*(C`delete\*(C'\fR don\*(Aqt mix in
758 hashes tied to this module
759 [GH #12894] <https://github.com/Perl/perl5/issues/12894>.
760 .Sp
761 It will now retry opening with an acceptable block size if asking gdbm
762 to default the block size failed
763 [GH #13232] <https://github.com/Perl/perl5/issues/13232>.
764 .IP \(bu 4
765 Getopt::Long has been upgraded from version 2.49 to 2.5.
766 .IP \(bu 4
767 Hash::Util::FieldHash has been upgraded from version 1.19 to 1.20.
768 .IP \(bu 4
769 I18N::Langinfo has been upgraded from version 0.13 to 0.17.
770 .Sp
771 This module is now available on all platforms, emulating the system
772 \&\fBnl_langinfo\fR\|(3) on systems that lack it. Some caveats apply, as
773 detailed in its documentation, the most severe being
774 that, except for MS Windows, the \f(CW\*(C`CODESET\*(C'\fR item is not implemented on
775 those systems, always returning \f(CW""\fR.
776 .Sp
777 It now sets the UTF\-8 flag in its returned scalar if the string contains
778 legal non\-ASCII UTF\-8, and the locale is UTF\-8
779 [GH #15131] <https://github.com/Perl/perl5/issues/15131>.
780 .Sp
781 This update also fixes a bug in which the underlying locale was ignored
782 for the \f(CW\*(C`RADIXCHAR\*(C'\fR (always was returned as a dot) and the \f(CW\*(C`THOUSEP\*(C'\fR
783 (always empty). Now the locale\-appropriate values are returned.
784 .IP \(bu 4
785 I18N::LangTags has been upgraded from version 0.42 to 0.43.
786 .IP \(bu 4
787 if has been upgraded from version 0.0606 to 0.0608.
788 .IP \(bu 4
789 IO has been upgraded from version 1.38 to 1.39.
790 .IP \(bu 4
791 IO::Socket::IP has been upgraded from version 0.38 to 0.39.
792 .IP \(bu 4
793 IPC::Cmd has been upgraded from version 0.96 to 1.00.
794 .IP \(bu 4
795 JSON::PP has been upgraded from version 2.27400_02 to 2.97001.
796 .IP \(bu 4
797 The \f(CW\*(C`libnet\*(C'\fR distribution has been upgraded from version 3.10 to 3.11.
798 .IP \(bu 4
799 List::Util has been upgraded from version 1.46_02 to 1.49.
800 .IP \(bu 4
801 Locale::Codes has been upgraded from version 3.42 to 3.56.
802 .Sp
803 \&\fBNOTE\fR: Locale::Codes scheduled to be removed from core in Perl 5.30.
804 .IP \(bu 4
805 Locale::Maketext has been upgraded from version 1.28 to 1.29.
806 .IP \(bu 4
807 Math::BigInt has been upgraded from version 1.999806 to 1.999811.
808 .IP \(bu 4
809 Math::BigInt::FastCalc has been upgraded from version 0.5005 to 0.5006.
810 .IP \(bu 4
811 Math::BigRat has been upgraded from version 0.2611 to 0.2613.
812 .IP \(bu 4
813 Module::CoreList has been upgraded from version 5.20170530 to 5.20180622.
814 .IP \(bu 4
815 mro has been upgraded from version 1.20 to 1.22.
816 .IP \(bu 4
817 Net::Ping has been upgraded from version 2.55 to 2.62.
818 .IP \(bu 4
819 NEXT has been upgraded from version 0.67 to 0.67_01.
820 .IP \(bu 4
821 ODBM_File has been upgraded from version 1.14 to 1.15.
822 .IP \(bu 4
823 Opcode has been upgraded from version 1.39 to 1.43.
824 .IP \(bu 4
825 overload has been upgraded from version 1.28 to 1.30.
826 .IP \(bu 4
827 PerlIO::encoding has been upgraded from version 0.25 to 0.26.
828 .IP \(bu 4
829 PerlIO::scalar has been upgraded from version 0.26 to 0.29.
830 .IP \(bu 4
831 PerlIO::via has been upgraded from version 0.16 to 0.17.
832 .IP \(bu 4
833 Pod::Functions has been upgraded from version 1.11 to 1.13.
834 .IP \(bu 4
835 Pod::Html has been upgraded from version 1.2202 to 1.24.
836 .Sp
837 A title for the HTML document will now be automatically generated by
838 default from a "NAME" section in the POD document, as it used to be
839 before the module was rewritten to use Pod::Simple::XHTML to do the
840 core of its job
841 [GH #11954] <https://github.com/Perl/perl5/issues/11954>.
842 .IP \(bu 4
843 Pod::Perldoc has been upgraded from version 3.28 to 3.2801.
844 .IP \(bu 4
845 The \f(CW\*(C`podlators\*(C'\fR distribution has been upgraded from version 4.09 to 4.10.
846 .Sp
847 Man page references and function names now follow the Linux man page
848 formatting standards, instead of the Solaris standard.
849 .IP \(bu 4
850 POSIX has been upgraded from version 1.76 to 1.84.
851 .Sp
852 Some more cautions were added about using locale\-specific functions in
853 threaded applications.
854 .IP \(bu 4
855 re has been upgraded from version 0.34 to 0.36.
856 .IP \(bu 4
857 Scalar::Util has been upgraded from version 1.46_02 to 1.50.
858 .IP \(bu 4
859 SelfLoader has been upgraded from version 1.23 to 1.25.
860 .IP \(bu 4
861 Socket has been upgraded from version 2.020_03 to 2.027.
862 .IP \(bu 4
863 sort has been upgraded from version 2.02 to 2.04.
864 .IP \(bu 4
865 Storable has been upgraded from version 2.62 to 3.08.
866 .IP \(bu 4
867 Sub::Util has been upgraded from version 1.48 to 1.49.
868 .IP \(bu 4
869 subs has been upgraded from version 1.02 to 1.03.
870 .IP \(bu 4
871 Sys::Hostname has been upgraded from version 1.20 to 1.22.
872 .IP \(bu 4
873 Term::ReadLine has been upgraded from version 1.16 to 1.17.
874 .IP \(bu 4
875 Test has been upgraded from version 1.30 to 1.31.
876 .IP \(bu 4
877 Test::Harness has been upgraded from version 3.38 to 3.42.
878 .IP \(bu 4
879 Test::Simple has been upgraded from version 1.302073 to 1.302133.
880 .IP \(bu 4
881 threads has been upgraded from version 2.15 to 2.22.
882 .Sp
883 The documentation now better describes the problems that arise when
884 returning values from threads, and no longer warns about creating threads
885 in \f(CW\*(C`BEGIN\*(C'\fR blocks.
886 [GH #11563] <https://github.com/Perl/perl5/issues/11563>
887 .IP \(bu 4
888 threads::shared has been upgraded from version 1.56 to 1.58.
889 .IP \(bu 4
890 Tie::Array has been upgraded from version 1.06 to 1.07.
891 .IP \(bu 4
892 Tie::StdHandle has been upgraded from version 4.4 to 4.5.
893 .IP \(bu 4
894 Time::gmtime has been upgraded from version 1.03 to 1.04.
895 .IP \(bu 4
896 Time::HiRes has been upgraded from version 1.9741 to 1.9759.
897 .IP \(bu 4
898 Time::localtime has been upgraded from version 1.02 to 1.03.
899 .IP \(bu 4
900 Time::Piece has been upgraded from version 1.31 to 1.3204.
901 .IP \(bu 4
902 Unicode::Collate has been upgraded from version 1.19 to 1.25.
903 .IP \(bu 4
904 Unicode::Normalize has been upgraded from version 1.25 to 1.26.
905 .IP \(bu 4
906 Unicode::UCD has been upgraded from version 0.68 to 0.70.
907 .Sp
908 The function \f(CW\*(C`num\*(C'\fR now accepts an optional parameter to help in
909 diagnosing error returns.
910 .IP \(bu 4
911 User::grent has been upgraded from version 1.01 to 1.02.
912 .IP \(bu 4
913 User::pwent has been upgraded from version 1.00 to 1.01.
914 .IP \(bu 4
915 utf8 has been upgraded from version 1.19 to 1.21.
916 .IP \(bu 4
917 vars has been upgraded from version 1.03 to 1.04.
918 .IP \(bu 4
919 version has been upgraded from version 0.9917 to 0.9923.
920 .IP \(bu 4
921 VMS::DCLsym has been upgraded from version 1.08 to 1.09.
922 .IP \(bu 4
923 VMS::Stdio has been upgraded from version 2.41 to 2.44.
924 .IP \(bu 4
925 warnings has been upgraded from version 1.37 to 1.42.
926 .Sp
927 It now includes new functions with names ending in \f(CW\*(C`_at_level\*(C'\fR, allowing
928 callers to specify the exact call frame.
929 [GH #16257] <https://github.com/Perl/perl5/issues/16257>
930 .IP \(bu 4
931 XS::Typemap has been upgraded from version 0.15 to 0.16.
932 .IP \(bu 4
933 XSLoader has been upgraded from version 0.27 to 0.30.
934 .Sp
935 Its documentation now shows the use of \f(CW\*(C`_\|_PACKAGE_\|_\*(C'\fR, and direct object
936 syntax for example \f(CW\*(C`DynaLoader\*(C'\fR usage
937 [GH #16190] <https://github.com/Perl/perl5/issues/16190>.
938 .Sp
939 Platforms that use \f(CW\*(C`mod2fname\*(C'\fR to edit the names of loadable
940 libraries now look for bootstrap (.bs) files under the correct,
941 non\-edited name.
942 .SS "Removed Modules and Pragmata"
943 .IX Subsection "Removed Modules and Pragmata"
944 .IP \(bu 4
945 The \f(CW\*(C`VMS::stdio\*(C'\fR compatibility shim has been removed.
946 .SH Documentation
947 .IX Header "Documentation"
948 .SS "Changes to Existing Documentation"
949 .IX Subsection "Changes to Existing Documentation"
950 We have attempted to update the documentation to reflect the changes
951 listed in this document. If you find any we have missed, send email
952 to [email protected] <mailto:[email protected]>.
953 .PP
954 Additionally, the following selected changes have been made:
955 .PP
956 \fIperlapi\fR
957 .IX Subsection "perlapi"
958 .IP \(bu 4
959 The API functions \f(CWperl_parse()\fR, \f(CWperl_run()\fR, and \f(CWperl_destruct()\fR
960 are now documented comprehensively, where previously the only
961 documentation was a reference to the perlembed tutorial.
962 .IP \(bu 4
963 The documentation of \f(CWnewGIVENOP()\fR has been belatedly updated to
964 account for the removal of lexical \f(CW$_\fR.
965 .IP \(bu 4
966 The API functions \f(CWnewCONSTSUB()\fR and \f(CWnewCONSTSUB_flags()\fR are
967 documented much more comprehensively than before.
968 .PP
969 \fIperldata\fR
970 .IX Subsection "perldata"
971 .IP \(bu 4
972 The section "Truth and Falsehood" in perlsyn has been moved into
973 perldata.
974 .PP
975 \fIperldebguts\fR
976 .IX Subsection "perldebguts"
977 .IP \(bu 4
978 The description of the conditions under which \f(CWDB::sub()\fR will be called
979 has been clarified.
980 [GH #16055] <https://github.com/Perl/perl5/issues/16055>
981 .PP
982 \fIperldiag\fR
983 .IX Subsection "perldiag"
984 .IP \(bu 4
985 "Variable length lookbehind not implemented in regex m/%s/" in perldiag
986 .Sp
987 This now gives more ideas as to workarounds to the issue that was
988 introduced in Perl 5.18 (but not documented explicitly in its perldelta)
989 for the fact that some Unicode \f(CW\*(C`/i\*(C'\fR rules cause a few sequences such as
990 .Sp
991 .Vb 1
992 \& (?<!st)
993 .Ve
994 .Sp
995 to be considered variable length, and hence disallowed.
996 .IP \(bu 4
997 "Use of state \f(CW$_\fR is experimental" in perldiag
998 .Sp
999 This entry has been removed, as the experimental support of this construct was
1000 removed in perl 5.24.0.
1001 .IP \(bu 4
1002 The diagnostic \f(CW\*(C`Initialization of state variables in list context
1003 currently forbidden\*(C'\fR has changed to \f(CW\*(C`Initialization of state variables
1004 in list currently forbidden\*(C'\fR, because list\-context initialization of
1005 single aggregate state variables is now permitted.
1006 .PP
1007 \fIperlembed\fR
1008 .IX Subsection "perlembed"
1009 .IP \(bu 4
1010 The examples in perlembed have been made more portable in the way
1011 they exit, and the example that gets an exit code from the embedded Perl
1012 interpreter now gets it from the right place. The examples that pass
1013 a constructed argv to Perl now show the mandatory null \f(CW\*(C`argv[argc]\*(C'\fR.
1014 .IP \(bu 4
1015 An example in perlembed used the string value of \f(CW\*(C`ERRSV\*(C'\fR as a
1016 format string when calling \fBcroak()\fR. If that string contains format
1017 codes such as \f(CW%s\fR this could crash the program.
1018 .Sp
1019 This has been changed to a call to \fBcroak_sv()\fR.
1020 .Sp
1021 An alternative could have been to supply a trivial format string:
1022 .Sp
1023 .Vb 1
1024 \& croak("%s", SvPV_nolen(ERRSV));
1025 .Ve
1026 .Sp
1027 or as a special case for \f(CW\*(C`ERRSV\*(C'\fR simply:
1028 .Sp
1029 .Vb 1
1030 \& croak(NULL);
1031 .Ve
1032 .PP
1033 \fIperlfunc\fR
1034 .IX Subsection "perlfunc"
1035 .IP \(bu 4
1036 There is now a note that warnings generated by built\-in functions are
1037 documented in perldiag and warnings.
1038 [GH #12642] <https://github.com/Perl/perl5/issues/12642>
1039 .IP \(bu 4
1040 The documentation for the \f(CW\*(C`exists\*(C'\fR operator no longer says that
1041 autovivification behaviour "may be fixed in a future release".
1042 We\*(Aqve determined that we\*(Aqre not going to change the default behaviour.
1043 [GH #15231] <https://github.com/Perl/perl5/issues/15231>
1044 .IP \(bu 4
1045 A couple of small details in the documentation for the \f(CW\*(C`bless\*(C'\fR operator
1046 have been clarified.
1047 [GH #14684] <https://github.com/Perl/perl5/issues/14684>
1048 .IP \(bu 4
1049 The description of \f(CW@INC\fR hooks in the documentation for \f(CW\*(C`require\*(C'\fR
1050 has been corrected to say that filter subroutines receive a useless
1051 first argument.
1052 [GH #12569] <https://github.com/Perl/perl5/issues/12569>
1053 .IP \(bu 4
1054 The documentation of \f(CW\*(C`ref\*(C'\fR has been rewritten for clarity.
1055 .IP \(bu 4
1056 The documentation of \f(CW\*(C`use\*(C'\fR now explains what syntactically qualifies
1057 as a version number for its module version checking feature.
1058 .IP \(bu 4
1059 The documentation of \f(CW\*(C`warn\*(C'\fR has been updated to reflect that since Perl
1060 5.14 it has treated complex exception objects in a manner equivalent
1061 to \f(CW\*(C`die\*(C'\fR.
1062 [GH #13641] <https://github.com/Perl/perl5/issues/13641>
1063 .IP \(bu 4
1064 The documentation of \f(CW\*(C`die\*(C'\fR and \f(CW\*(C`warn\*(C'\fR has been revised for clarity.
1065 .IP \(bu 4
1066 The documentation of \f(CW\*(C`each\*(C'\fR has been improved, with a slightly more
1067 explicit description of the sharing of iterator state, and with
1068 caveats regarding the fragility of while\-each loops.
1069 [GH #16334] <https://github.com/Perl/perl5/issues/16334>
1070 .IP \(bu 4
1071 Clarification to \f(CW\*(C`require\*(C'\fR was added to explain the differences between
1072 .Sp
1073 .Vb 2
1074 \& require Foo::Bar;
1075 \& require "Foo/Bar.pm";
1076 .Ve
1077 .PP
1078 \fIperlgit\fR
1079 .IX Subsection "perlgit"
1080 .IP \(bu 4
1081 The precise rules for identifying \f(CW\*(C`smoke\-me\*(C'\fR branches are now stated.
1082 .PP
1083 \fIperlguts\fR
1084 .IX Subsection "perlguts"
1085 .IP \(bu 4
1086 The section on reference counting in perlguts has been heavily revised,
1087 to describe references in the way a programmer needs to think about them
1088 rather than in terms of the physical data structures.
1089 .IP \(bu 4
1090 Improve documentation related to UTF\-8 multibytes.
1091 .PP
1092 \fIperlintern\fR
1093 .IX Subsection "perlintern"
1094 .IP \(bu 4
1095 The internal functions \f(CWnewXS_len_flags()\fR and \f(CWnewATTRSUB_x()\fR are
1096 now documented.
1097 .PP
1098 \fIperlobj\fR
1099 .IX Subsection "perlobj"
1100 .IP \(bu 4
1101 The documentation about \f(CW\*(C`DESTROY\*(C'\fR methods has been corrected, updated,
1102 and revised, especially in regard to how they interact with exceptions.
1103 [GH #14083] <https://github.com/Perl/perl5/issues/14083>
1104 .PP
1105 \fIperlop\fR
1106 .IX Subsection "perlop"
1107 .IP \(bu 4
1108 The description of the \f(CW\*(C`x\*(C'\fR operator in perlop has been clarified.
1109 [GH #16253] <https://github.com/Perl/perl5/issues/16253>
1110 .IP \(bu 4
1111 perlop has been updated to note that \f(CW\*(C`qw\*(C'\fR\*(Aqs whitespace rules differ
1112 from that of \f(CW\*(C`split\*(C'\fR\*(Aqs in that only ASCII whitespace is used.
1113 .IP \(bu 4
1114 The general explanation of operator precedence and associativity has
1115 been corrected and clarified.
1116 [GH #15153] <https://github.com/Perl/perl5/issues/15153>
1117 .IP \(bu 4
1118 The documentation for the \f(CW\*(C`\e\*(C'\fR referencing operator now explains the
1119 unusual context that it supplies to its operand.
1120 [GH #15932] <https://github.com/Perl/perl5/issues/15932>
1121 .PP
1122 \fIperlrequick\fR
1123 .IX Subsection "perlrequick"
1124 .IP \(bu 4
1125 Clarifications on metacharacters and character classes
1126 .PP
1127 \fIperlretut\fR
1128 .IX Subsection "perlretut"
1129 .IP \(bu 4
1130 Clarify metacharacters.
1131 .PP
1132 \fIperlrun\fR
1133 .IX Subsection "perlrun"
1134 .IP \(bu 4
1135 Clarify the differences between \fB\-M\fR and \fB\-m\fR.
1136 [GH #15998] <https://github.com/Perl/perl5/issues/15998>
1137 .PP
1138 \fIperlsec\fR
1139 .IX Subsection "perlsec"
1140 .IP \(bu 4
1141 The documentation about set\-id scripts has been updated and revised.
1142 [GH #10289] <https://github.com/Perl/perl5/issues/10289>
1143 .IP \(bu 4
1144 A section about using \f(CW\*(C`sudo\*(C'\fR to run Perl scripts has been added.
1145 .PP
1146 \fIperlsyn\fR
1147 .IX Subsection "perlsyn"
1148 .IP \(bu 4
1149 The section "Truth and Falsehood" in perlsyn has been removed from
1150 that document, where it didn\*(Aqt belong, and merged into the existing
1151 paragraph on the same topic in perldata.
1152 .IP \(bu 4
1153 The means to disambiguate between code blocks and hash constructors,
1154 already documented in perlref, are now documented in perlsyn too.
1155 [GH #15918] <https://github.com/Perl/perl5/issues/15918>
1156 .PP
1157 \fIperluniprops\fR
1158 .IX Subsection "perluniprops"
1159 .IP \(bu 4
1160 perluniprops has been updated to note that \f(CW\*(C`\ep{Word}\*(C'\fR now includes
1161 code points matching the \f(CW\*(C`\ep{Join_Control}\*(C'\fR property. The change to
1162 the property was made in Perl 5.18, but not documented until now. There
1163 are currently only two code points that match this property U+200C (ZERO
1164 WIDTH NON\-JOINER) and U+200D (ZERO WIDTH JOINER).
1165 .IP \(bu 4
1166 For each binary table or property, the documentation now includes which
1167 characters in the range \f(CW\*(C`\ex00\-\exFF\*(C'\fR it matches, as well as a list of
1168 the first few ranges of code points matched above that.
1169 .PP
1170 \fIperlvar\fR
1171 .IX Subsection "perlvar"
1172 .IP \(bu 4
1173 The entry for \f(CW$+\fR in perlvar has been expanded upon to describe handling of
1174 multiply\-named capturing groups.
1175 .PP
1176 \fIperlfunc, perlop, perlsyn\fR
1177 .IX Subsection "perlfunc, perlop, perlsyn"
1178 .IP \(bu 4
1179 In various places, improve the documentation of the special cases
1180 in the condition expression of a while loop, such as implicit \f(CW\*(C`defined\*(C'\fR
1181 and assignment to \f(CW$_\fR.
1182 [GH #16334] <https://github.com/Perl/perl5/issues/16334>
1183 .SH Diagnostics
1184 .IX Header "Diagnostics"
1185 The following additions or changes have been made to diagnostic output,
1186 including warnings and fatal error messages. For the complete list of
1187 diagnostic messages, see perldiag.
1188 .SS "New Diagnostics"
1189 .IX Subsection "New Diagnostics"
1190 \fINew Errors\fR
1191 .IX Subsection "New Errors"
1192 .IP \(bu 4
1193 Can\*(Aqt "goto" into a "given" block
1194 .Sp
1195 (F) A "goto" statement was executed to jump into the middle of a \f(CW\*(C`given\*(C'\fR
1196 block. You can\*(Aqt get there from here. See "goto" in perlfunc.
1197 .IP \(bu 4
1198 Can\*(Aqt "goto" into a binary or list expression
1199 .Sp
1200 Use of \f(CW\*(C`goto\*(C'\fR to jump into the parameter of a binary or list operator has
1201 been prohibited, to prevent crashes and stack corruption.
1202 [GH #15914] <https://github.com/Perl/perl5/issues/15914>
1203 .Sp
1204 You may only enter the \fIfirst\fR argument of an operator that takes a fixed
1205 number of arguments, since this is a case that will not cause stack
1206 corruption.
1207 [GH #16415] <https://github.com/Perl/perl5/issues/16415>
1208 .PP
1209 \fINew Warnings\fR
1210 .IX Subsection "New Warnings"
1211 .IP \(bu 4
1212 Old package separator used in string
1213 .Sp
1214 (W syntax) You used the old package separator, "\*(Aq", in a variable
1215 named inside a double\-quoted string; e.g., \f(CW"In $name\*(Aqs house"\fR. This
1216 is equivalent to \f(CW"In $name::s house"\fR. If you meant the former, put
1217 a backslash before the apostrophe (\f(CW"In $name\e\*(Aqs house"\fR).
1218 .IP \(bu 4
1219 "Locale \*(Aq%s\*(Aq contains (at least) the following characters which
1220 have unexpected meanings: \f(CW%s\fR The Perl program will use the expected
1221 meanings" in perldiag
1222 .SS "Changes to Existing Diagnostics"
1223 .IX Subsection "Changes to Existing Diagnostics"
1224 .IP \(bu 4
1225 A false\-positive warning that was issued when using a
1226 numerically\-quantified sub\-pattern in a recursive regex has been
1227 silenced. [GH #16106] <https://github.com/Perl/perl5/issues/16106>
1228 .IP \(bu 4
1229 The warning about useless use of a concatenation operator in void context
1230 is now generated for expressions with multiple concatenations, such as
1231 \&\f(CW\*(C`$a.$b.$c\*(C'\fR, which used to mistakenly not warn.
1232 [GH #3990] <https://github.com/Perl/perl5/issues/3990>
1233 .IP \(bu 4
1234 Warnings that a variable or subroutine "masks earlier declaration in same
1235 \&...", or that an \f(CW\*(C`our\*(C'\fR variable has been redeclared, have been moved to a
1236 new warnings category "shadow". Previously they were in category "misc".
1237 .IP \(bu 4
1238 The deprecation warning from \f(CWSys::Hostname::hostname()\fR saying that
1239 it doesn\*(Aqt accept arguments now states the Perl version in which the
1240 warning will be upgraded to an error.
1241 [GH #14662] <https://github.com/Perl/perl5/issues/14662>
1242 .IP \(bu 4
1243 The perldiag entry for the error regarding a set\-id script has been
1244 expanded to make clear that the error is reporting a specific security
1245 vulnerability, and to advise how to fix it.
1246 .IP \(bu 4
1247 The \f(CW\*(C`Unable to flush stdout\*(C'\fR error message was missing a trailing
1248 newline. [debian #875361]
1249 .SH "Utility Changes"
1250 .IX Header "Utility Changes"
1251 .SS perlbug
1252 .IX Subsection "perlbug"
1253 .IP \(bu 4
1254 \&\f(CW\*(C`\-\-help\*(C'\fR and \f(CW\*(C`\-\-version\*(C'\fR options have been added.
1255 .SH "Configuration and Compilation"
1256 .IX Header "Configuration and Compilation"
1257 .IP \(bu 4
1258 C89 requirement
1259 .Sp
1260 Perl has been documented as requiring a C89 compiler to build since October
1261 1998. A variety of simplifications have now been made to Perl\*(Aqs internals to
1262 rely on the features specified by the C89 standard. We believe that this
1263 internal change hasn\*(Aqt altered the set of platforms that Perl builds on, but
1264 please report a bug if Perl now has new problems building on your platform.
1265 .IP \(bu 4
1266 On GCC, \f(CW\*(C`\-Werror=pointer\-arith\*(C'\fR is now enabled by default,
1267 disallowing arithmetic on void and function pointers.
1268 .IP \(bu 4
1269 Where an HTML version of the documentation is installed, the HTML
1270 documents now use relative links to refer to each other. Links from
1271 the index page of perlipc to the individual section documents are
1272 now correct.
1273 [GH #11941] <https://github.com/Perl/perl5/issues/11941>
1274 .IP \(bu 4
1275 \&\fIlib/unicore/mktables\fR now correctly canonicalizes the names of the
1276 dependencies stored in the files it generates.
1277 .Sp
1278 \&\fIregen/mk_invlists.pl\fR, unlike the other \fIregen/*.pl\fR scripts, used
1279 \&\f(CW$0\fR to name itself in the dependencies stored in the files it
1280 generates. It now uses a literal so that the path stored in the
1281 generated files doesn\*(Aqt depend on how \fIregen/mk_invlists.pl\fR is
1282 invoked.
1283 .Sp
1284 This lack of canonical names could cause test failures in \fIt/porting/regen.t\fR.
1285 [GH #16446] <https://github.com/Perl/perl5/issues/16446>
1286 .IP \(bu 4
1287 New probes
1288 .RS 4
1289 .IP HAS_BUILTIN_ADD_OVERFLOW 2
1290 .IX Item "HAS_BUILTIN_ADD_OVERFLOW"
1291 .PD 0
1292 .IP HAS_BUILTIN_MUL_OVERFLOW 2
1293 .IX Item "HAS_BUILTIN_MUL_OVERFLOW"
1294 .IP HAS_BUILTIN_SUB_OVERFLOW 2
1295 .IX Item "HAS_BUILTIN_SUB_OVERFLOW"
1296 .IP HAS_THREAD_SAFE_NL_LANGINFO_L 2
1297 .IX Item "HAS_THREAD_SAFE_NL_LANGINFO_L"
1298 .IP HAS_LOCALECONV_L 2
1299 .IX Item "HAS_LOCALECONV_L"
1300 .IP HAS_MBRLEN 2
1301 .IX Item "HAS_MBRLEN"
1302 .IP HAS_MBRTOWC 2
1303 .IX Item "HAS_MBRTOWC"
1304 .IP HAS_MEMRCHR 2
1305 .IX Item "HAS_MEMRCHR"
1306 .IP HAS_NANOSLEEP 2
1307 .IX Item "HAS_NANOSLEEP"
1308 .IP HAS_STRNLEN 2
1309 .IX Item "HAS_STRNLEN"
1310 .IP HAS_STRTOLD_L 2
1311 .IX Item "HAS_STRTOLD_L"
1312 .IP I_WCHAR 2
1313 .IX Item "I_WCHAR"
1314 .PD
1315 .RE
1316 .RS 4
1317 .RE
1318 .SH Testing
1319 .IX Header "Testing"
1320 .IP \(bu 4
1321 Testing of the XS\-APItest directory is now done in parallel, where
1322 applicable.
1323 .IP \(bu 4
1324 Perl now includes a default \fI.travis.yml\fR file for Travis CI testing
1325 on GitHub mirrors.
1326 [GH #14558] <https://github.com/Perl/perl5/issues/14558>
1327 .IP \(bu 4
1328 The watchdog timer count in \fIre/pat_psycho.t\fR can now be overridden.
1329 .Sp
1330 This test can take a long time to run, so there is a timer to keep
1331 this in check (currently, 5 minutes). This commit adds checking
1332 the environment variable \f(CW\*(C`PERL_TEST_TIME_OUT_FACTOR\*(C'\fR; if set,
1333 the time out setting is multiplied by its value.
1334 .IP \(bu 4
1335 \&\fIharness\fR no longer waits for 30 seconds when running \fIt/io/openpid.t\fR.
1336 [GH #13535] <https://github.com/Perl/perl5/issues/13535>
1337 [GH #16420] <https://github.com/Perl/perl5/issues/16420>
1338 .SH Packaging
1339 .IX Header "Packaging"
1340 For the past few years we have released perl using three different archive
1341 formats: bzip (\f(CW\*(C`.bz2\*(C'\fR), LZMA2 (\f(CW\*(C`.xz\*(C'\fR) and gzip (\f(CW\*(C`.gz\*(C'\fR). Since xz compresses
1342 better and decompresses faster, and gzip is more compatible and uses less
1343 memory, we have dropped the \f(CW\*(C`.bz2\*(C'\fR archive format with this release.
1344 (If this poses a problem, do let us know; see "Reporting Bugs", below.)
1345 .SH "Platform Support"
1346 .IX Header "Platform Support"
1347 .SS "Discontinued Platforms"
1348 .IX Subsection "Discontinued Platforms"
1349 .IP "PowerUX / Power MAX OS" 4
1350 .IX Item "PowerUX / Power MAX OS"
1351 Compiler hints and other support for these apparently long\-defunct
1352 platforms has been removed.
1353 .SS "Platform\-Specific Notes"
1354 .IX Subsection "Platform-Specific Notes"
1355 .IP CentOS 4
1356 .IX Item "CentOS"
1357 Compilation on CentOS 5 is now fixed.
1358 .IP Cygwin 4
1359 .IX Item "Cygwin"
1360 A build with the quadmath library can now be done on Cygwin.
1361 .IP Darwin 4
1362 .IX Item "Darwin"
1363 Perl now correctly uses reentrant functions, like \f(CW\*(C`asctime_r\*(C'\fR, on
1364 versions of Darwin that have support for them.
1365 .IP FreeBSD 4
1366 .IX Item "FreeBSD"
1367 FreeBSD\*(Aqs \fI/usr/share/mk/sys.mk\fR specifies \f(CW\*(C`\-O2\*(C'\fR for
1368 architectures other than ARM and MIPS. By default, perl is now compiled
1369 with the same optimization levels.
1370 .IP VMS 4
1371 .IX Item "VMS"
1372 Several fix\-ups for \fIconfigure.com\fR, marking function VMS has
1373 (or doesn\*(Aqt have).
1374 .Sp
1375 CRTL features can now be set by embedders before invoking Perl by using
1376 the \f(CW\*(C`decc$feature_set\*(C'\fR and \f(CW\*(C`decc$feature_set_value\*(C'\fR functions.
1377 Previously any attempt to set features after image initialization were
1378 ignored.
1379 .IP Windows 4
1380 .IX Item "Windows"
1381 .RS 4
1382 .PD 0
1383 .IP \(bu 4
1384 .PD
1385 Support for compiling perl on Windows using Microsoft Visual Studio 2017
1386 (containing Visual C++ 14.1) has been added.
1387 .IP \(bu 4
1388 Visual C++ compiler version detection has been improved to work on non\-English
1389 language systems.
1390 .IP \(bu 4
1391 We now set \f(CW$Config{libpth}\fR correctly for 64\-bit builds using Visual C++
1392 versions earlier than 14.1.
1393 .RE
1394 .RS 4
1395 .RE
1396 .SH "Internal Changes"
1397 .IX Header "Internal Changes"
1398 .IP \(bu 4
1399 A new optimisation phase has been added to the compiler,
1400 \&\f(CWoptimize_optree()\fR, which does a top\-down scan of a complete optree
1401 just before the peephole optimiser is run. This phase is not currently
1402 hookable.
1403 .IP \(bu 4
1404 An \f(CW\*(C`OP_MULTICONCAT\*(C'\fR op has been added. At \f(CWoptimize_optree()\fR time, a
1405 chain of \f(CW\*(C`OP_CONCAT\*(C'\fR and \f(CW\*(C`OP_CONST\*(C'\fR ops, together optionally with an
1406 \&\f(CW\*(C`OP_STRINGIFY\*(C'\fR and/or \f(CW\*(C`OP_SASSIGN\*(C'\fR, are combined into a single
1407 \&\f(CW\*(C`OP_MULTICONCAT\*(C'\fR op. The op is of type \f(CW\*(C`UNOP_AUX\*(C'\fR, and the aux array
1408 contains the argument count, plus a pointer to a constant string and a set
1409 of segment lengths. For example with
1410 .Sp
1411 .Vb 1
1412 \& my $x = "foo=$foo, bar=$bar\en";
1413 .Ve
1414 .Sp
1415 the constant string would be \f(CW"foo=, bar=\en"\fR and the segment lengths
1416 would be (4,6,1). If the string contains characters such as \f(CW\*(C`\ex80\*(C'\fR, whose
1417 representation changes under utf8, two sets of strings plus lengths are
1418 precomputed and stored.
1419 .IP \(bu 4
1420 Direct access to \f(CW\*(C`PL_keyword_plugin\*(C'\fR is not
1421 safe in the presence of multithreading. A new
1422 \&\f(CW\*(C`wrap_keyword_plugin\*(C'\fR function has been
1423 added to allow XS modules to safely define custom keywords even when
1424 loaded from a thread, analogous to \f(CW\*(C`PL_check\*(C'\fR /
1425 \&\f(CW\*(C`wrap_op_checker\*(C'\fR.
1426 .IP \(bu 4
1427 The \f(CW\*(C`PL_statbuf\*(C'\fR interpreter variable has been removed.
1428 .IP \(bu 4
1429 The deprecated function \f(CWto_utf8_case()\fR, accessible from XS code, has
1430 been removed.
1431 .IP \(bu 4
1432 A new function
1433 \&\f(CWis_utf8_invariant_string_loc()\fR
1434 has been added that is like
1435 \&\f(CWis_utf8_invariant_string()\fR
1436 but takes an extra pointer parameter into which is stored the location
1437 of the first variant character, if any are found.
1438 .IP \(bu 4
1439 A new function, \f(CWPerl_langinfo()\fR has been
1440 added. It is an (almost) drop\-in replacement for the system
1441 \&\f(CWnl_langinfo(3)\fR, but works on platforms that lack that; as well as
1442 being more thread\-safe, and hiding some gotchas with locale handling
1443 from the caller. Code that uses this, needn\*(Aqt use \f(CW\*(C`\fR\f(CBlocaleconv\fR\f(CW\|(3)\*(C'\fR
1444 (and be affected by the gotchas) to find the decimal point, thousands
1445 separator, or currency symbol. See "Perl_langinfo" in perlapi.
1446 .IP \(bu 4
1447 A new API function \f(CWsv_rvunweaken()\fR has
1448 been added to complement \f(CWsv_rvweaken()\fR.
1449 The implementation was taken from "unweaken" in Scalar::Util.
1450 .IP \(bu 4
1451 A new flag, \f(CW\*(C`SORTf_UNSTABLE\*(C'\fR, has been added. This will allow a
1452 future commit to make mergesort unstable when the user specifies ‘no
1453 sort stable’, since it has been decided that mergesort should remain
1454 stable by default.
1455 .IP \(bu 4
1456 XS modules can now automatically get reentrant versions of system
1457 functions on threaded perls.
1458 .Sp
1459 By adding
1460 .Sp
1461 .Vb 1
1462 \& #define PERL_REENTRANT
1463 .Ve
1464 .Sp
1465 near the beginning of an \f(CW\*(C`XS\*(C'\fR file, it will be compiled so that
1466 whatever reentrant functions perl knows about on that system will
1467 automatically and invisibly be used instead of the plain, non\-reentrant
1468 versions. For example, if you write \f(CWgetpwnam()\fR in your code, on a
1469 system that has \f(CWgetpwnam_r()\fR all calls to the former will be translated
1470 invisibly into the latter. This does not happen except on threaded
1471 perls, as they aren\*(Aqt needed otherwise. Be aware that which functions
1472 have reentrant versions varies from system to system.
1473 .IP \(bu 4
1474 The \f(CW\*(C`PERL_NO_OP_PARENT\*(C'\fR build define is no longer supported, which means
1475 that perl is now always built with \f(CW\*(C`PERL_OP_PARENT\*(C'\fR enabled.
1476 .IP \(bu 4
1477 The format and content of the non\-utf8 transliteration table attached to
1478 the \f(CW\*(C`op_pv\*(C'\fR field of \f(CW\*(C`OP_TRANS\*(C'\fR/\f(CW\*(C`OP_TRANSR\*(C'\fR ops has changed. It\*(Aqs now a
1479 \&\f(CW\*(C`struct OPtrans_map\*(C'\fR.
1480 .IP \(bu 4
1481 A new compiler \f(CW\*(C`#define\*(C'\fR, \f(CW\*(C`dTHX_DEBUGGING\*(C'\fR. has been added. This is
1482 useful for XS or C code that only need the thread context because their
1483 debugging statements that get compiled only under \f(CW\*(C`\-DDEBUGGING\*(C'\fR need
1484 one.
1485 .IP \(bu 4
1486 A new API function "Perl_setlocale" in perlapi has been added.
1487 .IP \(bu 4
1488 "sync_locale" in perlapi has been revised to return a boolean as to
1489 whether the system was using the global locale or not.
1490 .IP \(bu 4
1491 A new kind of magic scalar, called a "nonelem" scalar, has been introduced.
1492 It is stored in an array to denote a non\-existent element, whenever such an
1493 element is accessed in a potential lvalue context. It replaces the
1494 existing "defelem" (deferred element) magic wherever this is possible,
1495 being significantly more efficient. This means that
1496 \&\f(CWsome_sub($sparse_array[$nonelem])\fR no longer has to create a new magic
1497 defelem scalar each time, as long as the element is within the array.
1498 .Sp
1499 It partially fixes the rare bug of deferred elements getting out of synch
1500 with their arrays when the array is shifted or unshifted.
1501 [GH #16364] <https://github.com/Perl/perl5/issues/16364>
1502 .SH "Selected Bug Fixes"
1503 .IX Header "Selected Bug Fixes"
1504 .IP \(bu 4
1505 List assignment (\f(CW\*(C`aassign\*(C'\fR) could in some rare cases allocate an
1506 entry on the mortals stack and leave the entry uninitialized, leading to
1507 possible crashes.
1508 [GH #16017] <https://github.com/Perl/perl5/issues/16017>
1509 .IP \(bu 4
1510 Attempting to apply an attribute to an \f(CW\*(C`our\*(C'\fR variable where a
1511 function of that name already exists could result in a NULL pointer
1512 being supplied where an SV was expected, crashing perl.
1513 [perl #131597] <https://rt.perl.org/Ticket/Display.html?id=131597>
1514 .IP \(bu 4
1515 \&\f(CW\*(C`split \*(Aq \*(Aq\*(C'\fR now correctly handles the argument being split when in the
1516 scope of the \f(CW\*(C`unicode_strings\*(C'\fR feature. Previously, when a string using the single\-byte internal
1517 representation contained characters that are whitespace by Unicode rules but
1518 not by ASCII rules, it treated those characters as part of fields rather
1519 than as field separators.
1520 [GH #15904] <https://github.com/Perl/perl5/issues/15904>
1521 .IP \(bu 4
1522 Several built\-in functions previously had bugs that could cause them to
1523 write to the internal stack without allocating room for the item being
1524 written. In rare situations, this could have led to a crash. These bugs have
1525 now been fixed, and if any similar bugs are introduced in future, they will
1526 be detected automatically in debugging builds.
1527 .Sp
1528 These internal stack usage checks introduced are also done
1529 by the \f(CW\*(C`entersub\*(C'\fR operator when calling XSUBs. This means we can
1530 report which XSUB failed to allocate enough stack space.
1531 [GH #16126] <https://github.com/Perl/perl5/issues/16126>
1532 .IP \(bu 4
1533 Using a symbolic ref with postderef syntax as the key in a hash lookup was
1534 yielding an assertion failure on debugging builds.
1535 [GH #16029] <https://github.com/Perl/perl5/issues/16029>
1536 .IP \(bu 4
1537 Array and hash variables whose names begin with a caret now admit indexing
1538 inside their curlies when interpolated into strings, as in \f(CW"${^CAPTURE[0]}"\fR to index \f(CW\*(C`@{^CAPTURE}\*(C'\fR.
1539 [GH #16050] <https://github.com/Perl/perl5/issues/16050>
1540 .IP \(bu 4
1541 Fetching the name of a glob that was previously UTF\-8 but wasn\*(Aqt any
1542 longer would return that name flagged as UTF\-8.
1543 [GH #15971] <https://github.com/Perl/perl5/issues/15971>
1544 .IP \(bu 4
1545 The perl \f(CWsprintf()\fR function (via the underlying C function
1546 \&\f(CWPerl_sv_vcatpvfn_flags()\fR) has been heavily reworked to fix many minor
1547 bugs, including the integer wrapping of large width and precision
1548 specifiers and potential buffer overruns. It has also been made faster in
1549 many cases.
1550 .IP \(bu 4
1551 Exiting from an \f(CW\*(C`eval\*(C'\fR, whether normally or via an exception, now always
1552 frees temporary values (possibly calling destructors) \fIbefore\fR setting
1553 \&\f(CW$@\fR. For example:
1554 .Sp
1555 .Vb 3
1556 \& sub DESTROY { eval { die "died in DESTROY"; } }
1557 \& eval { bless []; };
1558 \& # $@ used to be equal to "died in DESTROY" here; it\*(Aqs now "".
1559 .Ve
1560 .IP \(bu 4
1561 Fixed a duplicate symbol failure with \f(CW\*(C`\-flto \-mieee\-fp\*(C'\fR builds.
1562 \&\fIpp.c\fR defined \f(CW\*(C`_LIB_VERSION\*(C'\fR which \f(CW\*(C`\-lieee\*(C'\fR already defines.
1563 [GH #16086] <https://github.com/Perl/perl5/issues/16086>
1564 .IP \(bu 4
1565 The tokenizer no longer consumes the exponent part of a floating
1566 point number if it\*(Aqs incomplete.
1567 [GH #16073] <https://github.com/Perl/perl5/issues/16073>
1568 .IP \(bu 4
1569 On non\-threaded builds, for \f(CW\*(C`m/$null/\*(C'\fR where \f(CW$null\fR is an empty
1570 string is no longer treated as if the \f(CW\*(C`/o\*(C'\fR flag was present when the
1571 previous matching match operator included the \f(CW\*(C`/o\*(C'\fR flag. The
1572 rewriting used to implement this behavior could confuse the
1573 interpreter. This matches the behaviour of threaded builds.
1574 [GH #14668] <https://github.com/Perl/perl5/issues/14668>
1575 .IP \(bu 4
1576 Parsing a \f(CW\*(C`sub\*(C'\fR definition could cause a use after free if the \f(CW\*(C`sub\*(C'\fR
1577 keyword was followed by whitespace including newlines (and comments.)
1578 [GH #16097] <https://github.com/Perl/perl5/issues/16097>
1579 .IP \(bu 4
1580 The tokenizer now correctly adjusts a parse pointer when skipping
1581 whitespace in a \f(CW\*(C`${identifier}\*(C'\fR construct.
1582 [perl #131949] <https://rt.perl.org/Public/Bug/Display.html?id=131949>
1583 .IP \(bu 4
1584 Accesses to \f(CW\*(C`${^LAST_FH}\*(C'\fR no longer assert after using any of a
1585 variety of I/O operations on a non\-glob.
1586 [GH #15372] <https://github.com/Perl/perl5/issues/15372>
1587 .IP \(bu 4
1588 The XS\-level \f(CWCopy()\fR, \f(CWMove()\fR, \f(CWZero()\fR macros and their variants now
1589 assert if the pointers supplied are \f(CW\*(C`NULL\*(C'\fR. ISO C considers
1590 supplying NULL pointers to the functions these macros are built upon
1591 as undefined behaviour even when their count parameters are zero.
1592 Based on these assertions and the original bug report three macro
1593 calls were made conditional.
1594 [GH #16079] <https://github.com/Perl/perl5/issues/16079>
1595 [GH #16112] <https://github.com/Perl/perl5/issues/16112>
1596 .IP \(bu 4
1597 Only the \f(CW\*(C`=\*(C'\fR operator is permitted for defining defaults for
1598 parameters in subroutine signatures. Previously other assignment
1599 operators, e.g. \f(CW\*(C`+=\*(C'\fR, were also accidentally permitted.
1600 [GH #16084] <https://github.com/Perl/perl5/issues/16084>
1601 .IP \(bu 4
1602 Package names are now always included in \f(CW\*(C`:prototype\*(C'\fR warnings
1603 [perl #131833] <https://rt.perl.org/Public/Bug/Display.html?id=131833>
1604 .IP \(bu 4
1605 The \f(CW\*(C`je_old_stack_hwm\*(C'\fR field, previously only found in the \f(CW\*(C`jmpenv\*(C'\fR
1606 structure on debugging builds, has been added to non\-debug builds as
1607 well. This fixes an issue with some CPAN modules caused by the size of
1608 this structure varying between debugging and non\-debugging builds.
1609 [GH #16122] <https://github.com/Perl/perl5/issues/16122>
1610 .IP \(bu 4
1611 The arguments to the \f(CWninstr()\fR macro are now correctly parenthesized.
1612 .IP \(bu 4
1613 A NULL pointer dereference in the \f(CWS_regmatch()\fR function has been
1614 fixed.
1615 [perl #132017] <https://rt.perl.org/Public/Bug/Display.html?id=132017>
1616 .IP \(bu 4
1617 Calling exec PROGRAM LIST with an empty \f(CW\*(C`LIST\*(C'\fR
1618 has been fixed. This should call \f(CWexecvp()\fR with an empty \f(CW\*(C`argv\*(C'\fR array
1619 (containing only the terminating \f(CW\*(C`NULL\*(C'\fR pointer), but was instead just
1620 returning false (and not setting \f(CW$!\fR).
1621 [GH #16075] <https://github.com/Perl/perl5/issues/16075>
1622 .IP \(bu 4
1623 The \f(CW\*(C`gv_fetchmeth_sv\*(C'\fR C function stopped working properly in Perl 5.22 when
1624 fetching a constant with a UTF\-8 name if that constant subroutine was stored in
1625 the stash as a simple scalar reference, rather than a full typeglob. This has
1626 been corrected.
1627 .IP \(bu 4
1628 Single\-letter debugger commands followed by an argument which starts with
1629 punctuation (e.g. \f(CW\*(C`p$^V\*(C'\fR and \f(CW\*(C`x@ARGV\*(C'\fR) now work again. They had been
1630 wrongly requiring a space between the command and the argument.
1631 [GH #13342] <https://github.com/Perl/perl5/issues/13342>
1632 .IP \(bu 4
1633 splice now throws an exception
1634 ("Modification of a read\-only value attempted") when modifying a read\-only
1635 array. Until now it had been silently modifying the array. The new behaviour
1636 is consistent with the behaviour of push and
1637 unshift.
1638 [GH #15923] <https://github.com/Perl/perl5/issues/15923>
1639 .IP \(bu 4
1640 \&\f(CWstat()\fR, \f(CWlstat()\fR, and file test operators now fail if given a
1641 filename containing a nul character, in the same way that \f(CWopen()\fR
1642 already fails.
1643 .IP \(bu 4
1644 \&\f(CWstat()\fR, \f(CWlstat()\fR, and file test operators now reliably set \f(CW$!\fR when
1645 failing due to being applied to a closed or otherwise invalid file handle.
1646 .IP \(bu 4
1647 File test operators for Unix permission bits that don\*(Aqt exist on a
1648 particular platform, such as \f(CW\*(C`\-k\*(C'\fR (sticky bit) on Windows, now check that
1649 the file being tested exists before returning the blanket false result,
1650 and yield the appropriate errors if the argument doesn\*(Aqt refer to a file.
1651 .IP \(bu 4
1652 Fixed a \*(Aqread before buffer\*(Aq overrun when parsing a range starting with
1653 \&\f(CW\*(C`\eN{}\*(C'\fR at the beginning of the character set for the transliteration
1654 operator.
1655 [GH #16189] <https://github.com/Perl/perl5/issues/16189>
1656 .IP \(bu 4
1657 Fixed a leaked scalar when parsing an empty \f(CW\*(C`\eN{}\*(C'\fR at compile\-time.
1658 [GH #16189] <https://github.com/Perl/perl5/issues/16189>
1659 .IP \(bu 4
1660 Calling \f(CW\*(C`do $path\*(C'\fR on a directory or block device now yields a meaningful
1661 error code in \f(CW$!\fR.
1662 [GH #14841] <https://github.com/Perl/perl5/issues/14841>
1663 .IP \(bu 4
1664 Regexp substitution using an overloaded replacement value that provides
1665 a tainted stringification now correctly taints the resulting string.
1666 [GH #12495] <https://github.com/Perl/perl5/issues/12495>
1667 .IP \(bu 4
1668 Lexical sub declarations in \f(CW\*(C`do\*(C'\fR blocks such as \f(CW\*(C`do { my sub lex; 123 }\*(C'\fR
1669 could corrupt the stack, erasing items already on the stack in the
1670 enclosing statement. This has been fixed.
1671 [GH #16243] <https://github.com/Perl/perl5/issues/16243>
1672 .IP \(bu 4
1673 \&\f(CW\*(C`pack\*(C'\fR and \f(CW\*(C`unpack\*(C'\fR can now handle repeat counts and lengths that
1674 exceed two billion.
1675 [GH #13179] <https://github.com/Perl/perl5/issues/13179>
1676 .IP \(bu 4
1677 Digits past the radix point in octal and binary floating point literals
1678 now have the correct weight on platforms where a floating point
1679 significand doesn\*(Aqt fit into an integer type.
1680 .IP \(bu 4
1681 The canonical truth value no longer has a spurious special meaning as a
1682 callable subroutine. It used to be a magic placeholder for a missing
1683 \&\f(CW\*(C`import\*(C'\fR or \f(CW\*(C`unimport\*(C'\fR method, but is now treated like any other string
1684 \&\f(CW1\fR.
1685 [GH #14902] <https://github.com/Perl/perl5/issues/14902>
1686 .IP \(bu 4
1687 \&\f(CW\*(C`system\*(C'\fR now reduces its arguments to strings in the parent process, so
1688 any effects of stringifying them (such as overload methods being called
1689 or warnings being emitted) are visible in the way the program expects.
1690 [GH #13561] <https://github.com/Perl/perl5/issues/13561>
1691 .IP \(bu 4
1692 The \f(CWreadpipe()\fR built\-in function now checks at compile time that
1693 it has only one parameter expression, and puts it in scalar context,
1694 thus ensuring that it doesn\*(Aqt corrupt the stack at runtime.
1695 [GH #2793] <https://github.com/Perl/perl5/issues/2793>
1696 .IP \(bu 4
1697 \&\f(CW\*(C`sort\*(C'\fR now performs correct reference counting when aliasing \f(CW$a\fR and
1698 \&\f(CW$b\fR, thus avoiding premature destruction and leakage of scalars if they
1699 are re\-aliased during execution of the sort comparator.
1700 [GH #11422] <https://github.com/Perl/perl5/issues/11422>
1701 .IP \(bu 4
1702 \&\f(CW\*(C`reverse\*(C'\fR with no operand, reversing \f(CW$_\fR by default, is no longer in
1703 danger of corrupting the stack.
1704 [GH #16291] <https://github.com/Perl/perl5/issues/16291>
1705 .IP \(bu 4
1706 \&\f(CW\*(C`exec\*(C'\fR, \f(CW\*(C`system\*(C'\fR, et al are no longer liable to have their argument
1707 lists corrupted by reentrant calls and by magic such as tied scalars.
1708 [GH #15660] <https://github.com/Perl/perl5/issues/15660>
1709 .IP \(bu 4
1710 Perl\*(Aqs own \f(CW\*(C`malloc\*(C'\fR no longer gets confused by attempts to allocate
1711 more than a gigabyte on a 64\-bit platform.
1712 [GH #13273] <https://github.com/Perl/perl5/issues/13273>
1713 .IP \(bu 4
1714 Stacked file test operators in a sort comparator expression no longer
1715 cause a crash.
1716 [GH #15626] <https://github.com/Perl/perl5/issues/15626>
1717 .IP \(bu 4
1718 An identity \f(CW\*(C`tr///\*(C'\fR transformation on a reference is no longer mistaken
1719 for that reference for the purposes of deciding whether it can be
1720 assigned to.
1721 [GH #15812] <https://github.com/Perl/perl5/issues/15812>
1722 .IP \(bu 4
1723 Lengthy hexadecimal, octal, or binary floating point literals no
1724 longer cause undefined behaviour when parsing digits that are of such
1725 low significance that they can\*(Aqt affect the floating point value.
1726 [GH #16114] <https://github.com/Perl/perl5/issues/16114>
1727 .IP \(bu 4
1728 \&\f(CW\*(C`open $$scalarref...\*(C'\fR and similar invocations no longer leak the file
1729 handle.
1730 [GH #12593] <https://github.com/Perl/perl5/issues/12593>
1731 .IP \(bu 4
1732 Some convoluted kinds of regexp no longer cause an arithmetic overflow
1733 when compiled.
1734 [GH #16113] <https://github.com/Perl/perl5/issues/16113>
1735 .IP \(bu 4
1736 The default typemap, by avoiding \f(CW\*(C`newGVgen\*(C'\fR, now no longer leaks when
1737 XSUBs return file handles (\f(CW\*(C`PerlIO *\*(C'\fR or \f(CW\*(C`FILE *\*(C'\fR).
1738 [GH #12593] <https://github.com/Perl/perl5/issues/12593>
1739 .IP \(bu 4
1740 Creating a \f(CW\*(C`BEGIN\*(C'\fR block as an XS subroutine with a prototype no longer
1741 crashes because of the early freeing of the subroutine.
1742 .IP \(bu 4
1743 The \f(CW\*(C`printf\*(C'\fR format specifier \f(CW\*(C`%.0f\*(C'\fR no longer rounds incorrectly
1744 [GH #9125] <https://github.com/Perl/perl5/issues/9125>,
1745 and now shows the correct sign for a negative zero.
1746 .IP \(bu 4
1747 Fixed an issue where the error \f(CW\*(C`Scalar value @arrayname[0] better
1748 written as $arrayname\*(C'\fR would give an error \f(CW\*(C`Cannot printf Inf with \*(Aqc\*(Aq\*(C'\fR
1749 when arrayname starts with \f(CW\*(C`Inf\*(C'\fR.
1750 [GH #16335] <https://github.com/Perl/perl5/issues/16335>
1751 .IP \(bu 4
1752 The Perl implementation of \f(CWgetcwd()\fR in \f(CW\*(C`Cwd\*(C'\fR in the PathTools
1753 distribution now behaves the same as XS implementation on errors: it
1754 returns an error, and sets \f(CW$!\fR.
1755 [GH #16338] <https://github.com/Perl/perl5/issues/16338>
1756 .IP \(bu 4
1757 Vivify array elements when putting them on the stack.
1758 Fixes [GH #5310] <https://github.com/Perl/perl5/issues/5310>
1759 (reported in April 2002).
1760 .IP \(bu 4
1761 Fixed parsing of braced subscript after parens. Fixes
1762 [GH #4688] <https://github.com/Perl/perl5/issues/4688>
1763 (reported in December 2001).
1764 .IP \(bu 4
1765 \&\f(CW\*(C`tr/non_utf8/long_non_utf8/c\*(C'\fR could give the wrong results when the
1766 length of the replacement character list was greater than 0x7fff.
1767 .IP \(bu 4
1768 \&\f(CW\*(C`tr/non_utf8/non_utf8/cd\*(C'\fR failed to add the implied
1769 \&\f(CW\*(C`\ex{100}\-\ex{7fffffff}\*(C'\fR to the search character list.
1770 .IP \(bu 4
1771 Compilation failures within "perl\-within\-perl" constructs, such as with
1772 string interpolation and the right part of \f(CW\*(C`s///e\*(C'\fR, now cause
1773 compilation to abort earlier.
1774 .Sp
1775 Previously compilation could continue in order to report other errors,
1776 but the failed sub\-parse could leave partly parsed constructs on the
1777 parser shift\-reduce stack, confusing the parser, leading to perl
1778 crashes.
1779 [GH #14739] <https://github.com/Perl/perl5/issues/14739>
1780 .IP \(bu 4
1781 On threaded perls where the decimal point (radix) character is not a
1782 dot, it has been possible for a race to occur between threads when one
1783 needs to use the real radix character (such as with \f(CW\*(C`sprintf\*(C'\fR). This has
1784 now been fixed by use of a mutex on systems without thread\-safe locales,
1785 and the problem just doesn\*(Aqt come up on those with thread\-safe locales.
1786 .IP \(bu 4
1787 Errors while compiling a regex character class could sometime trigger an
1788 assertion failure.
1789 [GH #16172] <https://github.com/Perl/perl5/issues/16172>
1790 .SH Acknowledgements
1791 .IX Header "Acknowledgements"
1792 Perl 5.28.0 represents approximately 13 months of development since Perl
1793 5.26.0 and contains approximately 730,000 lines of changes across 2,200
1794 files from 77 authors.
1795 .PP
1796 Excluding auto\-generated files, documentation and release tools, there were
1797 approximately 580,000 lines of changes to 1,300 .pm, .t, .c and .h files.
1798 .PP
1799 Perl continues to flourish into its fourth decade thanks to a vibrant
1800 community of users and developers. The following people are known to have
1801 contributed the improvements that became Perl 5.28.0:
1802 .PP
1803 Aaron Crane, Abigail, Ævar Arnfjörð Bjarmason, Alberto Simões, Alexandr
1804 Savca, Andrew Fresh, Andy Dougherty, Andy Lester, Aristotle Pagaltzis, Ask
1805 Bjørn Hansen, Chris \*(AqBinGOs\*(Aq Williams, Craig A. Berry, Dagfinn Ilmari
1806 Mannsåker, Dan Collins, Daniel Dragan, David Cantrell, David Mitchell,
1807 Dmitry Ulanov, Dominic Hargreaves, E. Choroba, Eric Herman, Eugen Konkov,
1808 Father Chrysostomos, Gene Sullivan, George Hartzell, Graham Knop, Harald
1809 Jörg, H.Merijn Brand, Hugo van der Sanden, Jacques Germishuys, James E
1810 Keenan, Jarkko Hietaniemi, Jerry D. Hedden, J. Nick Koston, John Lightsey,
1811 John Peacock, John P. Linderman, John SJ Anderson, Karen Etheridge, Karl
1812 Williamson, Ken Brown, Ken Cotterill, Leon Timmermans, Lukas Mai, Marco
1813 Fontani, Marc\-Philip Werner, Matthew Horsfall, Neil Bowers, Nicholas Clark,
1814 Nicolas R., Niko Tyni, Pali, Paul Marquess, Peter John Acklam, Reini Urban,
1815 Renee Baecker, Ricardo Signes, Robin Barker, Sawyer X, Scott Lanning, Sergey
1816 Aleynikov, Shirakata Kentaro, Shoichi Kaji, Slaven Rezic, Smylers, Steffen
1817 Müller, Steve Hay, Sullivan Beck, Thomas Sibley, Todd Rinaldo, Tomasz
1818 Konojacki, Tom Hukins, Tom Wyant, Tony Cook, Vitali Peil, Yves Orton,
1819 Zefram.
1820 .PP
1821 The list above is almost certainly incomplete as it is automatically
1822 generated from version control history. In particular, it does not include
1823 the names of the (very much appreciated) contributors who reported issues to
1824 the Perl bug tracker.
1825 .PP
1826 Many of the changes included in this version originated in the CPAN modules
1827 included in Perl\*(Aqs core. We\*(Aqre grateful to the entire CPAN community for
1828 helping Perl to flourish.
1829 .PP
1830 For a more complete list of all of Perl\*(Aqs historical contributors, please
1831 see the \fIAUTHORS\fR file in the Perl source distribution.
1832 .SH "Reporting Bugs"
1833 .IX Header "Reporting Bugs"
1834 If you find what you think is a bug, you might check the perl bug database
1835 at <https://rt.perl.org/> . There may also be information at
1836 <http://www.perl.org/> , the Perl Home Page.
1837 .PP
1838 If you believe you have an unreported bug, please run the perlbug program
1839 included with your release. Be sure to trim your bug down to a tiny but
1840 sufficient test case. Your bug report, along with the output of \f(CW\*(C`perl \-V\*(C'\fR,
1841 will be sent off to [email protected] to be analysed by the Perl porting team.
1842 .PP
1843 If the bug you are reporting has security implications which make it
1844 inappropriate to send to a publicly archived mailing list, then see
1845 "SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec
1846 for details of how to report the issue.
1847 .SH "Give Thanks"
1848 .IX Header "Give Thanks"
1849 If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
1850 you can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program:
1851 .PP
1852 .Vb 1
1853 \& perlthanks
1854 .Ve
1855 .PP
1856 This will send an email to the Perl 5 Porters list with your show of thanks.
1857 .SH "SEE ALSO"
1858 .IX Header "SEE ALSO"
1859 The \fIChanges\fR file for an explanation of how to view exhaustive details on
1860 what changed.
1861 .PP
1862 The \fIINSTALL\fR file for how to build Perl.
1863 .PP
1864 The \fIREADME\fR file for general stuff.
1865 .PP
1866 The \fIArtistic\fR and \fICopying\fR files for copyright information.