Debian Codegraph @

upstream/fedora-44/man1/perl5240delta.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 "PERL5240DELTA 1"
61 .TH PERL5240DELTA 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 perl5240delta \- what is new for perl v5.24.0
68 .SH DESCRIPTION
69 .IX Header "DESCRIPTION"
70 This document describes the differences between the 5.22.0 release and the
71 5.24.0 release.
72 .SH "Core Enhancements"
73 .IX Header "Core Enhancements"
74 .SS "Postfix dereferencing is no longer experimental"
75 .IX Subsection "Postfix dereferencing is no longer experimental"
76 Using the \f(CW\*(C`postderef\*(C'\fR and \f(CW\*(C`postderef_qq\*(C'\fR features no longer emits a
77 warning. Existing code that disables the \f(CW\*(C`experimental::postderef\*(C'\fR warning
78 category that they previously used will continue to work. The \f(CW\*(C`postderef\*(C'\fR
79 feature has no effect; all Perl code can use postfix dereferencing,
80 regardless of what feature declarations are in scope. The \f(CW5.24\fR feature
81 bundle now includes the \f(CW\*(C`postderef_qq\*(C'\fR feature.
82 .SS "Unicode 8.0 is now supported"
83 .IX Subsection "Unicode 8.0 is now supported"
84 For details on what is in this release, see
85 <http://www.unicode.org/versions/Unicode8.0.0/>.
86 .SS "perl will now croak when closing an in\-place output file fails"
87 .IX Subsection "perl will now croak when closing an in-place output file fails"
88 Until now, failure to close the output file for an in\-place edit was not
89 detected, meaning that the input file could be clobbered without the edit being
90 successfully completed. Now, when the output file cannot be closed
91 successfully, an exception is raised.
92 .ie n .SS "New ""\eb{lb}"" boundary in regular expressions"
93 .el .SS "New \f(CW\eb{lb}\fP boundary in regular expressions"
94 .IX Subsection "New b{lb} boundary in regular expressions"
95 \&\f(CW\*(C`lb\*(C'\fR stands for Line Break. It is a Unicode property
96 that determines where a line of text is suitable to break (typically so
97 that it can be output without overflowing the available horizontal
98 space). This capability has long been furnished by the
99 Unicode::LineBreak module, but now a light\-weight, non\-customizable
100 version that is suitable for many purposes is in core Perl.
101 .ie n .SS """qr/(?[ ])/"" now works in UTF\-8 locales"
102 .el .SS "\f(CWqr/(?[ ])/\fP now works in UTF\-8 locales"
103 .IX Subsection "qr/(?[ ])/ now works in UTF-8 locales"
104 Extended Bracketed Character Classes
105 now will successfully compile when \f(CW\*(C`use\ locale\*(C'\fR is in effect. The compiled
106 pattern will use standard Unicode rules. If the runtime locale is not a
107 UTF\-8 one, a warning is raised and standard Unicode rules are used
108 anyway. No tainting is done since the outcome does not actually depend
109 on the locale.
110 .ie n .SS "Integer shift (""<<"" and "">>"") now more explicitly defined"
111 .el .SS "Integer shift (\f(CW<<\fP and \f(CW>>\fP) now more explicitly defined"
112 .IX Subsection "Integer shift (<< and >>) now more explicitly defined"
113 Negative shifts are reverse shifts: left shift becomes right shift,
114 and right shift becomes left shift.
115 .PP
116 Shifting by the number of bits in a native integer (or more) is zero,
117 except when the "overshift" is right shifting a negative value under
118 \&\f(CW\*(C`use integer\*(C'\fR, in which case the result is \-1 (arithmetic shift).
119 .PP
120 Until now negative shifting and overshifting have been undefined
121 because they have relied on whatever the C implementation happens
122 to do. For example, for the overshift a common C behavior is
123 "modulo shift":
124 .PP
125 .Vb 1
126 \& 1 >> 64 == 1 >> (64 % 64) == 1 >> 0 == 1 # Common C behavior.
127 \&
128 \& # And the same for <<, while Perl now produces 0 for both.
129 .Ve
130 .PP
131 Now these behaviors are well\-defined under Perl, regardless of what
132 the underlying C implementation does. Note, however, that you are still
133 constrained by the native integer width: you need to know how far left you
134 can go. You can use for example:
135 .PP
136 .Vb 2
137 \& use Config;
138 \& my $wordbits = $Config{uvsize} * 8; # Or $Config{uvsize} << 3.
139 .Ve
140 .PP
141 If you need a more bits on the left shift, you can use for example
142 the \f(CW\*(C`bigint\*(C'\fR pragma, or the \f(CW\*(C`Bit::Vector\*(C'\fR module from CPAN.
143 .SS "printf and sprintf now allow reordered precision arguments"
144 .IX Subsection "printf and sprintf now allow reordered precision arguments"
145 That is, \f(CW\*(C`sprintf \*(Aq|%.*2$d|\*(Aq, 2, 3\*(C'\fR now returns \f(CW\*(C`|002|\*(C'\fR. This extends
146 the existing reordering mechanism (which allows reordering for arguments
147 that are used as format fields, widths, and vector separators).
148 .ie n .SS "More fields provided to ""sigaction"" callback with ""SA_SIGINFO"""
149 .el .SS "More fields provided to \f(CWsigaction\fP callback with \f(CWSA_SIGINFO\fP"
150 .IX Subsection "More fields provided to sigaction callback with SA_SIGINFO"
151 When passing the \f(CW\*(C`SA_SIGINFO\*(C'\fR flag to sigaction, the
152 \&\f(CW\*(C`errno\*(C'\fR, \f(CW\*(C`status\*(C'\fR, \f(CW\*(C`uid\*(C'\fR, \f(CW\*(C`pid\*(C'\fR, \f(CW\*(C`addr\*(C'\fR and \f(CW\*(C`band\*(C'\fR fields are now
153 included in the hash passed to the handler, if supported by the
154 platform.
155 .SS "Hashbang redirection to Perl 6"
156 .IX Subsection "Hashbang redirection to Perl 6"
157 Previously perl would redirect to another interpreter if it found a
158 hashbang path unless the path contains "perl" (see perlrun). To improve
159 compatibility with Perl 6 this behavior has been extended to also redirect
160 if "perl" is followed by "6".
161 .SH Security
162 .IX Header "Security"
163 .ie n .SS "Set proper umask before calling mkstemp(3)"
164 .el .SS "Set proper umask before calling \f(CWmkstemp(3)\fP"
165 .IX Subsection "Set proper umask before calling mkstemp(3)"
166 In 5.22 perl started setting umask to 0600 before calling \f(CWmkstemp(3)\fR
167 and restoring it afterwards. This wrongfully tells \f(CWopen(2)\fR to strip
168 the owner read and write bits from the given mode before applying it,
169 rather than the intended negation of leaving only those bits in place.
170 .PP
171 Systems that use mode 0666 in \f(CWmkstemp(3)\fR (like old versions of
172 glibc) create a file with permissions 0066, leaving world read and
173 write permissions regardless of current umask.
174 .PP
175 This has been fixed by using umask 0177 instead. [perl #127322]
176 .SS "Fix out of boundary access in Win32 path handling"
177 .IX Subsection "Fix out of boundary access in Win32 path handling"
178 This is CVE\-2015\-8608. For more information see
179 [GH #15067] <https://github.com/Perl/perl5/issues/15067>
180 .SS "Fix loss of taint in canonpath"
181 .IX Subsection "Fix loss of taint in canonpath"
182 This is CVE\-2015\-8607. For more information see
183 [GH #15084] <https://github.com/Perl/perl5/issues/15084>
184 .ie n .SS "Avoid accessing uninitialized memory in win32 crypt()"
185 .el .SS "Avoid accessing uninitialized memory in win32 \f(CWcrypt()\fP"
186 .IX Subsection "Avoid accessing uninitialized memory in win32 crypt()"
187 Added validation that will detect both a short salt and invalid characters
188 in the salt.
189 [GH #15091] <https://github.com/Perl/perl5/issues/15091>
190 .ie n .SS "Remove duplicate environment variables from ""environ"""
191 .el .SS "Remove duplicate environment variables from \f(CWenviron\fP"
192 .IX Subsection "Remove duplicate environment variables from environ"
193 Previously, if an environment variable appeared more than once in
194 \&\f(CW\*(C`environ[]\*(C'\fR, \f(CW%ENV\fR would contain the last entry for that name,
195 while a typical \f(CWgetenv()\fR would return the first entry. We now
196 make sure \f(CW%ENV\fR contains the same as what \f(CW\*(C`getenv\*(C'\fR returns.
197 .PP
198 Second, we remove duplicates from \f(CW\*(C`environ[]\*(C'\fR, so if a setting
199 with that name is set in \f(CW%ENV\fR, we won\*(Aqt pass an unsafe value
200 to a child process.
201 .PP
202 [CVE\-2016\-2381]
203 .SH "Incompatible Changes"
204 .IX Header "Incompatible Changes"
205 .ie n .SS "The ""autoderef"" feature has been removed"
206 .el .SS "The \f(CWautoderef\fP feature has been removed"
207 .IX Subsection "The autoderef feature has been removed"
208 The experimental \f(CW\*(C`autoderef\*(C'\fR feature (which allowed calling \f(CW\*(C`push\*(C'\fR,
209 \&\f(CW\*(C`pop\*(C'\fR, \f(CW\*(C`shift\*(C'\fR, \f(CW\*(C`unshift\*(C'\fR, \f(CW\*(C`splice\*(C'\fR, \f(CW\*(C`keys\*(C'\fR, \f(CW\*(C`values\*(C'\fR, and \f(CW\*(C`each\*(C'\fR on
210 a scalar argument) has been deemed unsuccessful. It has now been removed;
211 trying to use the feature (or to disable the \f(CW\*(C`experimental::autoderef\*(C'\fR
212 warning it previously triggered) now yields an exception.
213 .ie n .SS "Lexical $_ has been removed"
214 .el .SS "Lexical \f(CW$_\fP has been removed"
215 .IX Subsection "Lexical $_ has been removed"
216 \&\f(CW\*(C`my $_\*(C'\fR was introduced in Perl 5.10, and subsequently caused much confusion
217 with no obvious solution. In Perl 5.18.0, it was made experimental on the
218 theory that it would either be removed or redesigned in a less confusing (but
219 backward\-incompatible) way. Over the following years, no alternatives were
220 proposed. The feature has now been removed and will fail to compile.
221 .ie n .SS """qr/\eb{wb}/"" is now tailored to Perl expectations"
222 .el .SS "\f(CWqr/\eb{wb}/\fP is now tailored to Perl expectations"
223 .IX Subsection "qr/b{wb}/ is now tailored to Perl expectations"
224 This is now more suited to be a drop\-in replacement for plain \f(CW\*(C`\eb\*(C'\fR, but
225 giving better results for parsing natural language. Previously it
226 strictly followed the current Unicode rules which calls for it to match
227 between each white space character. Now it doesn\*(Aqt generally match
228 within spans of white space, behaving like \f(CW\*(C`\eb\*(C'\fR does. See
229 "\eb{wb}" in perlrebackslash
230 .SS "Regular expression compilation errors"
231 .IX Subsection "Regular expression compilation errors"
232 Some regular expression patterns that had runtime errors now
233 don\*(Aqt compile at all.
234 .PP
235 Almost all Unicode properties using the \f(CW\*(C`\ep{}\*(C'\fR and \f(CW\*(C`\eP{}\*(C'\fR regular
236 expression pattern constructs are now checked for validity at pattern
237 compilation time, and invalid ones will cause the program to not
238 compile. In earlier releases, this check was often deferred until run
239 time. Whenever an error check is moved from run\- to compile time,
240 erroneous code is caught 100% of the time, whereas before it would only
241 get caught if and when the offending portion actually gets executed,
242 which for unreachable code might be never.
243 .ie n .SS """qr/\eN{}/"" now disallowed under ""use re ""strict"""""
244 .el .SS "\f(CWqr/\eN{}/\fP now disallowed under \f(CWuse re ""strict""\fP"
245 .IX Subsection "qr/N{}/ now disallowed under use re ""strict"""
246 An empty \f(CW\*(C`\eN{}\*(C'\fR makes no sense, but for backwards compatibility is
247 accepted as doing nothing, though a deprecation warning is raised by
248 default. But now this is a fatal error under the experimental feature
249 "\*(Aqstrict\*(Aq mode" in re.
250 .SS "Nested declarations are now disallowed"
251 .IX Subsection "Nested declarations are now disallowed"
252 A \f(CW\*(C`my\*(C'\fR, \f(CW\*(C`our\*(C'\fR, or \f(CW\*(C`state\*(C'\fR declaration is no longer allowed inside
253 of another \f(CW\*(C`my\*(C'\fR, \f(CW\*(C`our\*(C'\fR, or \f(CW\*(C`state\*(C'\fR declaration.
254 .PP
255 For example, these are now fatal:
256 .PP
257 .Vb 2
258 \& my ($x, my($y));
259 \& our (my $x);
260 .Ve
261 .PP
262 [GH #14799] <https://github.com/Perl/perl5/issues/14799>
263 .PP
264 [GH #13548] <https://github.com/Perl/perl5/issues/13548>
265 .ie n .SS "The ""/\eC/"" character class has been removed"
266 .el .SS "The \f(CW/\eC/\fP character class has been removed"
267 .IX Subsection "The /C/ character class has been removed"
268 This regular expression character class was deprecated in v5.20.0 and has
269 produced a deprecation warning since v5.22.0. It is now a compile\-time
270 error. If you need to examine the individual bytes that make up a
271 UTF8\-encoded character, then use \f(CWutf8::encode()\fR on the string (or a
272 copy) first.
273 .ie n .SS "chdir(\*(Aq\*(Aq) no longer chdirs home"
274 .el .SS "\f(CWchdir(\*(Aq\*(Aq)\fP no longer chdirs home"
275 .IX Subsection "chdir('') no longer chdirs home"
276 Using \f(CWchdir(\*(Aq\*(Aq)\fR or \f(CWchdir(undef)\fR to chdir home has been deprecated since
277 perl v5.8, and will now fail. Use \f(CWchdir()\fR instead.
278 .SS "ASCII characters in variable names must now be all visible"
279 .IX Subsection "ASCII characters in variable names must now be all visible"
280 It was legal until now on ASCII platforms for variable names to contain
281 non\-graphical ASCII control characters (ordinals 0 through 31, and 127,
282 which are the C0 controls and \f(CW\*(C`DELETE\*(C'\fR). This usage has been
283 deprecated since v5.20, and as of now causes a syntax error. The
284 variables these names referred to are special, reserved by Perl for
285 whatever use it may choose, now, or in the future. Each such variable
286 has an alternative way of spelling it. Instead of the single
287 non\-graphic control character, a two character sequence beginning with a
288 caret is used, like \f(CW$^]\fR and \f(CW\*(C`${^GLOBAL_PHASE}\*(C'\fR. Details are at
289 perlvar. It remains legal, though unwise and deprecated (raising a
290 deprecation warning), to use certain non\-graphic non\-ASCII characters in
291 variables names when not under \f(CW\*(C`use\ utf8\*(C'\fR. No code should do this,
292 as all such variables are reserved by Perl, and Perl doesn\*(Aqt currently
293 define any of them (but could at any time, without notice).
294 .ie n .SS "An off by one issue in $Carp::MaxArgNums has been fixed"
295 .el .SS "An off by one issue in \f(CW$Carp::MaxArgNums\fP has been fixed"
296 .IX Subsection "An off by one issue in $Carp::MaxArgNums has been fixed"
297 \&\f(CW$Carp::MaxArgNums\fR is supposed to be the number of arguments to display.
298 Prior to this version, it was instead showing \f(CW$Carp::MaxArgNums\fR + 1 arguments,
299 contrary to the documentation.
300 .ie n .SS "Only blanks and tabs are now allowed within ""[...]"" within ""(?[...])"""
301 .el .SS "Only blanks and tabs are now allowed within \f(CW[...]\fP within \f(CW(?[...])\fP"
302 .IX Subsection "Only blanks and tabs are now allowed within [...] within (?[...])"
303 The experimental Extended Bracketed Character Classes can contain regular
304 bracketed character classes within them. These differ from regular ones in
305 that white space is generally ignored, unless escaped by preceding it with a
306 backslash. The white space that is ignored is now limited to just tab \f(CW\*(C`\et\*(C'\fR
307 and SPACE characters. Previously, it was any white space. See
308 "Extended Bracketed Character Classes" in perlrecharclass.
309 .SH Deprecations
310 .IX Header "Deprecations"
311 .ie n .SS "Using code points above the platform\*(Aqs ""IV_MAX"" is now deprecated"
312 .el .SS "Using code points above the platform\*(Aqs \f(CWIV_MAX\fP is now deprecated"
313 .IX Subsection "Using code points above the platform's IV_MAX is now deprecated"
314 Unicode defines code points in the range \f(CW\*(C`0..0x10FFFF\*(C'\fR. Some standards
315 at one time defined them up to 2**31 \- 1, but Perl has allowed them to
316 be as high as anything that will fit in a word on the platform being
317 used. However, use of those above the platform\*(Aqs \f(CW\*(C`IV_MAX\*(C'\fR is broken in
318 some constructs, notably \f(CW\*(C`tr///\*(C'\fR, regular expression patterns involving
319 quantifiers, and in some arithmetic and comparison operations, such as
320 being the upper limit of a loop. Now the use of such code points raises
321 a deprecation warning, unless that warning category is turned off.
322 \&\f(CW\*(C`IV_MAX\*(C'\fR is typically 2**31 \-1 on 32\-bit platforms, and 2**63\-1 on
323 64\-bit ones.
324 .SS "Doing bitwise operations on strings containing code points above 0xFF is deprecated"
325 .IX Subsection "Doing bitwise operations on strings containing code points above 0xFF is deprecated"
326 The string bitwise operators treat their operands as strings of bytes,
327 and values beyond 0xFF are nonsensical in this context. To operate on
328 encoded bytes, first encode the strings. To operate on code points\*(Aq
329 numeric values, use \f(CW\*(C`split\*(C'\fR and \f(CW\*(C`map ord\*(C'\fR. In the future, this
330 warning will be replaced by an exception.
331 .ie n .SS "sysread(), syswrite(), recv() and send() are deprecated on :utf8 handles"
332 .el .SS "\f(CWsysread()\fP, \f(CWsyswrite()\fP, \f(CWrecv()\fP and \f(CWsend()\fP are deprecated on :utf8 handles"
333 .IX Subsection "sysread(), syswrite(), recv() and send() are deprecated on :utf8 handles"
334 The \f(CWsysread()\fR, \f(CWrecv()\fR, \f(CWsyswrite()\fR and \f(CWsend()\fR operators
335 are deprecated on handles that have the \f(CW\*(C`:utf8\*(C'\fR layer, either
336 explicitly, or implicitly, eg., with the \f(CW:encoding(UTF\-16LE)\fR layer.
337 .PP
338 Both \f(CWsysread()\fR and \f(CWrecv()\fR currently use only the \f(CW\*(C`:utf8\*(C'\fR flag for the
339 stream, ignoring the actual layers. Since \f(CWsysread()\fR and \f(CWrecv()\fR do no
340 UTF\-8 validation they can end up creating invalidly encoded scalars.
341 .PP
342 Similarly, \f(CWsyswrite()\fR and \f(CWsend()\fR use only the \f(CW\*(C`:utf8\*(C'\fR flag, otherwise
343 ignoring any layers. If the flag is set, both write the value UTF\-8
344 encoded, even if the layer is some different encoding, such as the
345 example above.
346 .PP
347 Ideally, all of these operators would completely ignore the \f(CW\*(C`:utf8\*(C'\fR
348 state, working only with bytes, but this would result in silently
349 breaking existing code. To avoid this a future version of perl will
350 throw an exception when any of \f(CWsysread()\fR, \f(CWrecv()\fR, \f(CWsyswrite()\fR or \f(CWsend()\fR
351 are called on handle with the \f(CW\*(C`:utf8\*(C'\fR layer.
352 .SH "Performance Enhancements"
353 .IX Header "Performance Enhancements"
354 .IP \(bu 4
355 The overhead of scope entry and exit has been considerably reduced, so
356 for example subroutine calls, loops and basic blocks are all faster now.
357 This empty function call now takes about a third less time to execute:
358 .Sp
359 .Vb 1
360 \& sub f{} f();
361 .Ve
362 .IP \(bu 4
363 Many languages, such as Chinese, are caseless. Perl now knows about
364 most common ones, and skips much of the work when
365 a program tries to change case in them (like \f(CWucfirst()\fR) or match
366 caselessly (\f(CW\*(C`qr//i\*(C'\fR). This will speed up a program, such as a web
367 server, that can operate on multiple languages, while it is operating on a
368 caseless one.
369 .IP \(bu 4
370 \&\f(CW\*(C`/fixed\-substr/\*(C'\fR has been made much faster.
371 .Sp
372 On platforms with a libc \f(CWmemchr()\fR implementation which makes good use of
373 underlying hardware support, patterns which include fixed substrings will now
374 often be much faster; for example with glibc on a recent x86_64 CPU, this:
375 .Sp
376 .Vb 2
377 \& $s = "a" x 1000 . "wxyz";
378 \& $s =~ /wxyz/ for 1..30000
379 .Ve
380 .Sp
381 is now about 7 times faster. On systems with slow \f(CWmemchr()\fR, e.g. 32\-bit ARM
382 Raspberry Pi, there will be a small or little speedup. Conversely, some
383 pathological cases, such as \f(CW\*(C`"ab" x 1000 =~ /aa/\*(C'\fR will be slower now; up to 3
384 times slower on the rPi, 1.5x slower on x86_64.
385 .IP \(bu 4
386 Faster addition, subtraction and multiplication.
387 .Sp
388 Since 5.8.0, arithmetic became slower due to the need to support
389 64\-bit integers. To deal with 64\-bit integers, a lot more corner
390 cases need to be checked, which adds time. We now detect common
391 cases where there is no need to check for those corner cases,
392 and special\-case them.
393 .IP \(bu 4
394 Preincrement, predecrement, postincrement, and postdecrement have been
395 made faster by internally splitting the functions which handled multiple
396 cases into different functions.
397 .IP \(bu 4
398 Creating Perl debugger data structures (see "Debugger Internals" in perldebguts)
399 for XSUBs and const subs has been removed. This removed one glob/scalar combo
400 for each unique \f(CW\*(C`.c\*(C'\fR file that XSUBs and const subs came from. On startup
401 (\f(CW\*(C`perl \-e"0"\*(C'\fR) about half a dozen glob/scalar debugger combos were created.
402 Loading XS modules created more glob/scalar combos. These things were
403 being created regardless of whether the perl debugger was being used,
404 and despite the fact that it can\*(Aqt debug C code anyway
405 .IP \(bu 4
406 On Win32, \f(CW\*(C`stat\*(C'\fRing or \f(CW\*(C`\-X\*(C'\fRing a path, if the file or directory does not
407 exist, is now 3.5x faster than before.
408 .IP \(bu 4
409 Single arguments in list assign are now slightly faster:
410 .Sp
411 .Vb 2
412 \& ($x) = (...);
413 \& (...) = ($x);
414 .Ve
415 .IP \(bu 4
416 Less peak memory is now used when compiling regular expression patterns.
417 .SH "Modules and Pragmata"
418 .IX Header "Modules and Pragmata"
419 .SS "Updated Modules and Pragmata"
420 .IX Subsection "Updated Modules and Pragmata"
421 .IP \(bu 4
422 arybase has been upgraded from version 0.10 to 0.11.
423 .IP \(bu 4
424 Attribute::Handlers has been upgraded from version 0.97 to 0.99.
425 .IP \(bu 4
426 autodie has been upgraded from version 2.26 to 2.29.
427 .IP \(bu 4
428 autouse has been upgraded from version 1.08 to 1.11.
429 .IP \(bu 4
430 B has been upgraded from version 1.58 to 1.62.
431 .IP \(bu 4
432 B::Deparse has been upgraded from version 1.35 to 1.37.
433 .IP \(bu 4
434 base has been upgraded from version 2.22 to 2.23.
435 .IP \(bu 4
436 Benchmark has been upgraded from version 1.2 to 1.22.
437 .IP \(bu 4
438 bignum has been upgraded from version 0.39 to 0.42.
439 .IP \(bu 4
440 bytes has been upgraded from version 1.04 to 1.05.
441 .IP \(bu 4
442 Carp has been upgraded from version 1.36 to 1.40.
443 .IP \(bu 4
444 Compress::Raw::Bzip2 has been upgraded from version 2.068 to 2.069.
445 .IP \(bu 4
446 Compress::Raw::Zlib has been upgraded from version 2.068 to 2.069.
447 .IP \(bu 4
448 Config::Perl::V has been upgraded from version 0.24 to 0.25.
449 .IP \(bu 4
450 CPAN::Meta has been upgraded from version 2.150001 to 2.150005.
451 .IP \(bu 4
452 CPAN::Meta::Requirements has been upgraded from version 2.132 to 2.140.
453 .IP \(bu 4
454 CPAN::Meta::YAML has been upgraded from version 0.012 to 0.018.
455 .IP \(bu 4
456 Data::Dumper has been upgraded from version 2.158 to 2.160.
457 .IP \(bu 4
458 Devel::Peek has been upgraded from version 1.22 to 1.23.
459 .IP \(bu 4
460 Devel::PPPort has been upgraded from version 3.31 to 3.32.
461 .IP \(bu 4
462 Dumpvalue has been upgraded from version 1.17 to 1.18.
463 .IP \(bu 4
464 DynaLoader has been upgraded from version 1.32 to 1.38.
465 .IP \(bu 4
466 Encode has been upgraded from version 2.72 to 2.80.
467 .IP \(bu 4
468 encoding has been upgraded from version 2.14 to 2.17.
469 .IP \(bu 4
470 encoding::warnings has been upgraded from version 0.11 to 0.12.
471 .IP \(bu 4
472 English has been upgraded from version 1.09 to 1.10.
473 .IP \(bu 4
474 Errno has been upgraded from version 1.23 to 1.25.
475 .IP \(bu 4
476 experimental has been upgraded from version 0.013 to 0.016.
477 .IP \(bu 4
478 ExtUtils::CBuilder has been upgraded from version 0.280221 to 0.280225.
479 .IP \(bu 4
480 ExtUtils::Embed has been upgraded from version 1.32 to 1.33.
481 .IP \(bu 4
482 ExtUtils::MakeMaker has been upgraded from version 7.04_01 to 7.10_01.
483 .IP \(bu 4
484 ExtUtils::ParseXS has been upgraded from version 3.28 to 3.31.
485 .IP \(bu 4
486 ExtUtils::Typemaps has been upgraded from version 3.28 to 3.31.
487 .IP \(bu 4
488 feature has been upgraded from version 1.40 to 1.42.
489 .IP \(bu 4
490 fields has been upgraded from version 2.17 to 2.23.
491 .IP \(bu 4
492 File::Find has been upgraded from version 1.29 to 1.34.
493 .IP \(bu 4
494 File::Glob has been upgraded from version 1.24 to 1.26.
495 .IP \(bu 4
496 File::Path has been upgraded from version 2.09 to 2.12_01.
497 .IP \(bu 4
498 File::Spec has been upgraded from version 3.56 to 3.63.
499 .IP \(bu 4
500 Filter::Util::Call has been upgraded from version 1.54 to 1.55.
501 .IP \(bu 4
502 Getopt::Long has been upgraded from version 2.45 to 2.48.
503 .IP \(bu 4
504 Hash::Util has been upgraded from version 0.18 to 0.19.
505 .IP \(bu 4
506 Hash::Util::FieldHash has been upgraded from version 1.15 to 1.19.
507 .IP \(bu 4
508 HTTP::Tiny has been upgraded from version 0.054 to 0.056.
509 .IP \(bu 4
510 I18N::Langinfo has been upgraded from version 0.12 to 0.13.
511 .IP \(bu 4
512 if has been upgraded from version 0.0604 to 0.0606.
513 .IP \(bu 4
514 IO has been upgraded from version 1.35 to 1.36.
515 .IP \(bu 4
516 IO\-Compress has been upgraded from version 2.068 to 2.069.
517 .IP \(bu 4
518 IPC::Open3 has been upgraded from version 1.18 to 1.20.
519 .IP \(bu 4
520 IPC::SysV has been upgraded from version 2.04 to 2.06_01.
521 .IP \(bu 4
522 List::Util has been upgraded from version 1.41 to 1.42_02.
523 .IP \(bu 4
524 locale has been upgraded from version 1.06 to 1.08.
525 .IP \(bu 4
526 Locale::Codes has been upgraded from version 3.34 to 3.37.
527 .IP \(bu 4
528 Math::BigInt has been upgraded from version 1.9997 to 1.999715.
529 .IP \(bu 4
530 Math::BigInt::FastCalc has been upgraded from version 0.31 to 0.40.
531 .IP \(bu 4
532 Math::BigRat has been upgraded from version 0.2608 to 0.260802.
533 .IP \(bu 4
534 Module::CoreList has been upgraded from version 5.20150520 to 5.20160320.
535 .IP \(bu 4
536 Module::Metadata has been upgraded from version 1.000026 to 1.000031.
537 .IP \(bu 4
538 mro has been upgraded from version 1.17 to 1.18.
539 .IP \(bu 4
540 ODBM_File has been upgraded from version 1.12 to 1.14.
541 .IP \(bu 4
542 Opcode has been upgraded from version 1.32 to 1.34.
543 .IP \(bu 4
544 parent has been upgraded from version 0.232 to 0.234.
545 .IP \(bu 4
546 Parse::CPAN::Meta has been upgraded from version 1.4414 to 1.4417.
547 .IP \(bu 4
548 Perl::OSType has been upgraded from version 1.008 to 1.009.
549 .IP \(bu 4
550 perlfaq has been upgraded from version 5.021009 to 5.021010.
551 .IP \(bu 4
552 PerlIO::encoding has been upgraded from version 0.21 to 0.24.
553 .IP \(bu 4
554 PerlIO::mmap has been upgraded from version 0.014 to 0.016.
555 .IP \(bu 4
556 PerlIO::scalar has been upgraded from version 0.22 to 0.24.
557 .IP \(bu 4
558 PerlIO::via has been upgraded from version 0.15 to 0.16.
559 .IP \(bu 4
560 Pod::Functions has been upgraded from version 1.09 to 1.10.
561 .IP \(bu 4
562 Pod::Perldoc has been upgraded from version 3.25 to 3.25_02.
563 .IP \(bu 4
564 Pod::Simple has been upgraded from version 3.29 to 3.32.
565 .IP \(bu 4
566 Pod::Usage has been upgraded from version 1.64 to 1.68.
567 .IP \(bu 4
568 POSIX has been upgraded from version 1.53 to 1.65.
569 .IP \(bu 4
570 Scalar::Util has been upgraded from version 1.41 to 1.42_02.
571 .IP \(bu 4
572 SDBM_File has been upgraded from version 1.13 to 1.14.
573 .IP \(bu 4
574 SelfLoader has been upgraded from version 1.22 to 1.23.
575 .IP \(bu 4
576 Socket has been upgraded from version 2.018 to 2.020_03.
577 .IP \(bu 4
578 Storable has been upgraded from version 2.53 to 2.56.
579 .IP \(bu 4
580 strict has been upgraded from version 1.09 to 1.11.
581 .IP \(bu 4
582 Term::ANSIColor has been upgraded from version 4.03 to 4.04.
583 .IP \(bu 4
584 Term::Cap has been upgraded from version 1.15 to 1.17.
585 .IP \(bu 4
586 Test has been upgraded from version 1.26 to 1.28.
587 .IP \(bu 4
588 Test::Harness has been upgraded from version 3.35 to 3.36.
589 .IP \(bu 4
590 Thread::Queue has been upgraded from version 3.05 to 3.08.
591 .IP \(bu 4
592 threads has been upgraded from version 2.01 to 2.06.
593 .IP \(bu 4
594 threads::shared has been upgraded from version 1.48 to 1.50.
595 .IP \(bu 4
596 Tie::File has been upgraded from version 1.01 to 1.02.
597 .IP \(bu 4
598 Tie::Scalar has been upgraded from version 1.03 to 1.04.
599 .IP \(bu 4
600 Time::HiRes has been upgraded from version 1.9726 to 1.9732.
601 .IP \(bu 4
602 Time::Piece has been upgraded from version 1.29 to 1.31.
603 .IP \(bu 4
604 Unicode::Collate has been upgraded from version 1.12 to 1.14.
605 .IP \(bu 4
606 Unicode::Normalize has been upgraded from version 1.18 to 1.25.
607 .IP \(bu 4
608 Unicode::UCD has been upgraded from version 0.61 to 0.64.
609 .IP \(bu 4
610 UNIVERSAL has been upgraded from version 1.12 to 1.13.
611 .IP \(bu 4
612 utf8 has been upgraded from version 1.17 to 1.19.
613 .IP \(bu 4
614 version has been upgraded from version 0.9909 to 0.9916.
615 .IP \(bu 4
616 warnings has been upgraded from version 1.32 to 1.36.
617 .IP \(bu 4
618 Win32 has been upgraded from version 0.51 to 0.52.
619 .IP \(bu 4
620 Win32API::File has been upgraded from version 0.1202 to 0.1203.
621 .IP \(bu 4
622 XS::Typemap has been upgraded from version 0.13 to 0.14.
623 .IP \(bu 4
624 XSLoader has been upgraded from version 0.20 to 0.21.
625 .SH Documentation
626 .IX Header "Documentation"
627 .SS "Changes to Existing Documentation"
628 .IX Subsection "Changes to Existing Documentation"
629 \fIperlapi\fR
630 .IX Subsection "perlapi"
631 .IP \(bu 4
632 The process of using undocumented globals has been documented, namely, that one
633 should send email to perl5\[email protected] <mailto:[email protected]>
634 first to get the go\-ahead for documenting and using an undocumented function or
635 global variable.
636 .PP
637 \fIperlcall\fR
638 .IX Subsection "perlcall"
639 .IP \(bu 4
640 A number of cleanups have been made to perlcall, including:
641 .RS 4
642 .IP \(bu 4
643 use \f(CW\*(C`EXTEND(SP, n)\*(C'\fR and \f(CWPUSHs()\fR instead of \f(CWXPUSHs()\fR where applicable
644 and update prose to match
645 .IP \(bu 4
646 add POPu, POPul and POPpbytex to the "complete list of POP macros"
647 and clarify the documentation for some of the existing entries, and
648 a note about side\-effects
649 .IP \(bu 4
650 add API documentation for POPu and POPul
651 .IP \(bu 4
652 use ERRSV more efficiently
653 .IP \(bu 4
654 approaches to thread\-safety storage of SVs.
655 .RE
656 .RS 4
657 .RE
658 .PP
659 \fIperlfunc\fR
660 .IX Subsection "perlfunc"
661 .IP \(bu 4
662 The documentation of \f(CW\*(C`hex\*(C'\fR has been revised to clarify valid inputs.
663 .IP \(bu 4
664 Better explain meaning of negative PIDs in \f(CW\*(C`waitpid\*(C'\fR.
665 [GH #15108] <https://github.com/Perl/perl5/issues/15108>
666 .IP \(bu 4
667 General cleanup: there\*(Aqs more consistency now (in POD usage, grammar, code
668 examples), better practices in code examples (use of \f(CW\*(C`my\*(C'\fR, removal of bareword
669 filehandles, dropped usage of \f(CW\*(C`&\*(C'\fR when calling subroutines, ...), etc.
670 .PP
671 \fIperlguts\fR
672 .IX Subsection "perlguts"
673 .IP \(bu 4
674 A new section has been added, "Dynamic Scope and the Context
675 Stack" in perlguts, which explains how the perl context stack works.
676 .PP
677 \fIperllocale\fR
678 .IX Subsection "perllocale"
679 .IP \(bu 4
680 A stronger caution about using locales in threaded applications is
681 given. Locales are not thread\-safe, and you can get wrong results or
682 even segfaults if you use them there.
683 .PP
684 \fIperlmodlib\fR
685 .IX Subsection "perlmodlib"
686 .IP \(bu 4
687 We now recommend contacting the module\-authors list or PAUSE in seeking
688 guidance on the naming of modules.
689 .PP
690 \fIperlop\fR
691 .IX Subsection "perlop"
692 .IP \(bu 4
693 The documentation of \f(CW\*(C`qx//\*(C'\fR now describes how \f(CW$?\fR is affected.
694 .PP
695 \fIperlpolicy\fR
696 .IX Subsection "perlpolicy"
697 .IP \(bu 4
698 This note has been added to perlpolicy:
699 .Sp
700 .Vb 3
701 \& While civility is required, kindness is encouraged; if you have any
702 \& doubt about whether you are being civil, simply ask yourself, "Am I
703 \& being kind?" and aspire to that.
704 .Ve
705 .PP
706 \fIperlreftut\fR
707 .IX Subsection "perlreftut"
708 .IP \(bu 4
709 Fix some examples to be strict clean.
710 .PP
711 \fIperlrebackslash\fR
712 .IX Subsection "perlrebackslash"
713 .IP \(bu 4
714 Clarify that in languages like Japanese and Thai, dictionary lookup
715 is required to determine word boundaries.
716 .PP
717 \fIperlsub\fR
718 .IX Subsection "perlsub"
719 .IP \(bu 4
720 Updated to note that anonymous subroutines can have signatures.
721 .PP
722 \fIperlsyn\fR
723 .IX Subsection "perlsyn"
724 .IP \(bu 4
725 Fixed a broken example where \f(CW\*(C`=\*(C'\fR was used instead of
726 \&\f(CW\*(C`==\*(C'\fR in conditional in do/while example.
727 .PP
728 \fIperltie\fR
729 .IX Subsection "perltie"
730 .IP \(bu 4
731 The usage of \f(CW\*(C`FIRSTKEY\*(C'\fR and \f(CW\*(C`NEXTKEY\*(C'\fR has been clarified.
732 .PP
733 \fIperlunicode\fR
734 .IX Subsection "perlunicode"
735 .IP \(bu 4
736 Discourage use of \*(AqIn\*(Aq as a prefix signifying the Unicode Block property.
737 .PP
738 \fIperlvar\fR
739 .IX Subsection "perlvar"
740 .IP \(bu 4
741 The documentation of \f(CW$@\fR was reworded to clarify that it is not just for
742 syntax errors in \f(CW\*(C`eval\*(C'\fR.
743 [GH #14572] <https://github.com/Perl/perl5/issues/14572>
744 .IP \(bu 4
745 The specific true value of \f(CW$!{E...}\fR is now documented, noting that it is
746 subject to change and not guaranteed.
747 .IP \(bu 4
748 Use of \f(CW$OLD_PERL_VERSION\fR is now discouraged.
749 .PP
750 \fIperlxs\fR
751 .IX Subsection "perlxs"
752 .IP \(bu 4
753 The documentation of \f(CW\*(C`PROTOTYPES\*(C'\fR has been corrected; they are \fIdisabled\fR
754 by default, not \fIenabled\fR.
755 .SH Diagnostics
756 .IX Header "Diagnostics"
757 The following additions or changes have been made to diagnostic output,
758 including warnings and fatal error messages. For the complete list of
759 diagnostic messages, see perldiag.
760 .SS "New Diagnostics"
761 .IX Subsection "New Diagnostics"
762 \fINew Errors\fR
763 .IX Subsection "New Errors"
764 .IP \(bu 4
765 \&\f(CW%s\fR must not be a named sequence in transliteration operator
766 .IP \(bu 4
767 Can\*(Aqt find Unicode property definition "%s" in regex;
768 .IP \(bu 4
769 Can\*(Aqt redeclare "%s" in "%s"
770 .IP \(bu 4
771 Character following \ep must be \*(Aq{\*(Aq or a single\-character Unicode property name in regex;
772 .IP \(bu 4
773 Empty \e%c in regex; marked by <\-\- HERE in m/%s/
774 .IP \(bu 4
775 Illegal user\-defined property name
776 .IP \(bu 4
777 Invalid number \*(Aq%s\*(Aq for \-C option.
778 .IP \(bu 4
779 Sequence (?... not terminated in regex; marked by <\-\-\ HERE in m/%s/
780 .IP \(bu 4
781 Sequence (?P<... not terminated in regex; marked by <\-\- HERE in m/%s/
782 .IP \(bu 4
783 Sequence (?P>... not terminated in regex; marked by <\-\- HERE in m/%s/
784 .PP
785 \fINew Warnings\fR
786 .IX Subsection "New Warnings"
787 .IP \(bu 4
788 Assuming NOT a POSIX class since \f(CW%s\fR in regex; marked by <\-\- HERE in
789 m/%s/
790 .IP \(bu 4
791 %s() is deprecated on :utf8 handles
792 .SS "Changes to Existing Diagnostics"
793 .IX Subsection "Changes to Existing Diagnostics"
794 .IP \(bu 4
795 Accessing the \f(CW\*(C`IO\*(C'\fR part of a glob as \f(CW\*(C`FILEHANDLE\*(C'\fR instead of \f(CW\*(C`IO\*(C'\fR is no
796 longer deprecated. It is discouraged to encourage uniformity (so that, for
797 example, one can grep more easily) but it will not be removed.
798 [GH #15105] <https://github.com/Perl/perl5/issues/15105>
799 .IP \(bu 4
800 The diagnostic \f(CW\*(C`Hexadecimal float: internal error\*(C'\fR has been changed to
801 \&\f(CW\*(C`Hexadecimal float: internal error (%s)\*(C'\fR to include more information.
802 .IP \(bu 4
803 Can\*(Aqt modify non\-lvalue subroutine call of &%s
804 .Sp
805 This error now reports the name of the non\-lvalue subroutine you attempted to
806 use as an lvalue.
807 .IP \(bu 4
808 When running out of memory during an attempt the increase the stack
809 size, previously, perl would die using the cryptic message
810 \&\f(CW\*(C`panic: av_extend_guts() negative count (\-9223372036854775681)\*(C'\fR.
811 This has been fixed to show the prettier message:
812 Out of memory during stack extend
813 .SH "Configuration and Compilation"
814 .IX Header "Configuration and Compilation"
815 .IP \(bu 4
816 \&\f(CW\*(C`Configure\*(C'\fR now acts as if the \f(CW\*(C`\-O\*(C'\fR option is always passed, allowing command
817 line options to override saved configuration. This should eliminate confusion
818 when command line options are ignored for no obvious reason. \f(CW\*(C`\-O\*(C'\fR is now
819 permitted, but ignored.
820 .IP \(bu 4
821 Bison 3.0 is now supported.
822 .IP \(bu 4
823 \&\fIConfigure\fR no longer probes for \fIlibnm\fR by default. Originally
824 this was the "New Math" library, but the name has been re\-used by the
825 GNOME NetworkManager.
826 [GH #15115] <https://github.com/Perl/perl5/issues/15115>
827 .IP \(bu 4
828 Added \fIConfigure\fR probes for \f(CW\*(C`newlocale\*(C'\fR, \f(CW\*(C`freelocale\*(C'\fR, and \f(CW\*(C`uselocale\*(C'\fR.
829 .IP \(bu 4
830 \&\f(CW\*(C`PPPort.so/PPPort.dll\*(C'\fR no longer get installed, as they are
831 not used by \f(CW\*(C`PPPort.pm\*(C'\fR, only by its test files.
832 .IP \(bu 4
833 It is now possible to specify which compilation date to show on
834 \&\f(CW\*(C`perl \-V\*(C'\fR output, by setting the macro \f(CW\*(C`PERL_BUILD_DATE\*(C'\fR.
835 .IP \(bu 4
836 Using the \f(CW\*(C`NO_HASH_SEED\*(C'\fR define in combination with the default hash algorithm
837 \&\f(CW\*(C`PERL_HASH_FUNC_ONE_AT_A_TIME_HARD\*(C'\fR resulted in a fatal error while compiling
838 the interpreter, since Perl 5.17.10. This has been fixed.
839 .IP \(bu 4
840 \&\fIConfigure\fR should handle spaces in paths a little better.
841 .IP \(bu 4
842 No longer generate EBCDIC POSIX\-BC tables. We don\*(Aqt believe anyone is
843 using Perl and POSIX\-BC at this time, and by not generating these tables
844 it saves time during development, and makes the resulting tar ball smaller.
845 .IP \(bu 4
846 The GNU Make makefile for Win32 now supports parallel builds. [perl #126632]
847 .IP \(bu 4
848 You can now build perl with MSVC++ on Win32 using GNU Make. [perl #126632]
849 .IP \(bu 4
850 The Win32 miniperl now has a real \f(CW\*(C`getcwd\*(C'\fR which increases build performance
851 resulting in \f(CWgetcwd()\fR being 605x faster in Win32 miniperl.
852 .IP \(bu 4
853 Configure now takes \f(CW\*(C`\-Dusequadmath\*(C'\fR into account when calculating the
854 \&\f(CW\*(C`alignbytes\*(C'\fR configuration variable. Previously the mis\-calculated
855 \&\f(CW\*(C`alignbytes\*(C'\fR could cause alignment errors on debugging builds. [perl
856 #127894]
857 .SH Testing
858 .IX Header "Testing"
859 .IP \(bu 4
860 A new test (\fIt/op/aassign.t\fR) has been added to test the list assignment operator
861 \&\f(CW\*(C`OP_AASSIGN\*(C'\fR.
862 .IP \(bu 4
863 Parallel building has been added to the dmake \f(CW\*(C`makefile.mk\*(C'\fR makefile. All
864 Win32 compilers are supported.
865 .SH "Platform Support"
866 .IX Header "Platform Support"
867 .SS "Platform\-Specific Notes"
868 .IX Subsection "Platform-Specific Notes"
869 .IP AmigaOS 4
870 .IX Item "AmigaOS"
871 .RS 4
872 .PD 0
873 .IP \(bu 4
874 .PD
875 The AmigaOS port has been reintegrated into the main tree, based off of
876 Perl 5.22.1.
877 .RE
878 .RS 4
879 .RE
880 .IP Cygwin 4
881 .IX Item "Cygwin"
882 .RS 4
883 .PD 0
884 .IP \(bu 4
885 .PD
886 Tests are more robust against unusual cygdrive prefixes.
887 [GH #15076] <https://github.com/Perl/perl5/issues/15076>
888 .RE
889 .RS 4
890 .RE
891 .IP EBCDIC 4
892 .IX Item "EBCDIC"
893 .RS 4
894 .PD 0
895 .IP "UTF\-EBCDIC extended" 4
896 .IX Item "UTF-EBCDIC extended"
897 .PD
898 UTF\-EBCDIC is like UTF\-8, but for EBCDIC platforms. It now has been
899 extended so that it can represent code points up to 2 ** 64 \- 1 on
900 platforms with 64\-bit words. This brings it into parity with UTF\-8.
901 This enhancement requires an incompatible change to the representation
902 of code points in the range 2 ** 30 to 2 ** 31 \-1 (the latter was the
903 previous maximum representable code point). This means that a file that
904 contains one of these code points, written out with previous versions of
905 perl cannot be read in, without conversion, by a perl containing this
906 change. We do not believe any such files are in existence, but if you
907 do have one, submit a ticket at [email protected] <mailto:[email protected]>,
908 and we will write a conversion script for you.
909 .ie n .IP "EBCDIC cmp() and sort() fixed for UTF\-EBCDIC strings" 4
910 .el .IP "EBCDIC \f(CWcmp()\fR and \f(CWsort()\fR fixed for UTF\-EBCDIC strings" 4
911 .IX Item "EBCDIC cmp() and sort() fixed for UTF-EBCDIC strings"
912 Comparing two strings that were both encoded in UTF\-8 (or more
913 precisely, UTF\-EBCDIC) did not work properly until now. Since \f(CWsort()\fR
914 uses \f(CWcmp()\fR, this fixes that as well.
915 .ie n .IP "EBCDIC ""tr///"" and ""y///"" fixed for ""\eN{}"", and ""use\ utf8"" ranges" 4
916 .el .IP "EBCDIC \f(CWtr///\fR and \f(CWy///\fR fixed for \f(CW\eN{}\fR, and \f(CWuse\ utf8\fR ranges" 4
917 .IX Item "EBCDIC tr/// and y/// fixed for N{}, and use utf8 ranges"
918 Perl v5.22 introduced the concept of portable ranges to regular
919 expression patterns. A portable range matches the same set of
920 characters no matter what platform is being run on. This concept is now
921 extended to \f(CW\*(C`tr///\*(C'\fR. See
922 \&\f(CW\*(C`tr///\*(C'\fR.
923 .Sp
924 There were also some problems with these operations under \f(CW\*(C`use\ utf8\*(C'\fR, which are now fixed
925 .RE
926 .RS 4
927 .RE
928 .IP FreeBSD 4
929 .IX Item "FreeBSD"
930 .RS 4
931 .PD 0
932 .IP \(bu 4
933 .PD
934 Use the \f(CWfdclose()\fR function from FreeBSD if it is available.
935 [GH #15082] <https://github.com/Perl/perl5/issues/15082>
936 .RE
937 .RS 4
938 .RE
939 .IP IRIX 4
940 .IX Item "IRIX"
941 .RS 4
942 .PD 0
943 .IP \(bu 4
944 .PD
945 Under some circumstances IRIX stdio \f(CWfgetc()\fR and \f(CWfread()\fR set the errno to
946 \&\f(CW\*(C`ENOENT\*(C'\fR, which made no sense according to either IRIX or POSIX docs. Errno
947 is now cleared in such cases.
948 [GH #14557] <https://github.com/Perl/perl5/issues/14557>
949 .IP \(bu 4
950 Problems when multiplying long doubles by infinity have been fixed.
951 [GH #14993] <https://github.com/Perl/perl5/issues/14993>
952 .RE
953 .RS 4
954 .RE
955 .IP "MacOS X" 4
956 .IX Item "MacOS X"
957 .RS 4
958 .PD 0
959 .IP \(bu 4
960 .PD
961 Until now OS X builds of perl have specified a link target of 10.3 (Panther,
962 2003) but have not specified a compiler target. From now on, builds of perl on
963 OS X 10.6 or later (Snow Leopard, 2008) by default capture the current OS X
964 version and specify that as the explicit build target in both compiler and
965 linker flags, thus preserving binary compatibility for extensions built later
966 regardless of changes in OS X, SDK, or compiler and linker versions. To
967 override the default value used in the build and preserved in the flags,
968 specify \f(CW\*(C`export MACOSX_DEPLOYMENT_TARGET=10.N\*(C'\fR before configuring and building
969 perl, where 10.N is the version of OS X you wish to target. In OS X 10.5 or
970 earlier there is no change to the behavior present when those systems were
971 current; the link target is still OS X 10.3 and there is no explicit compiler
972 target.
973 .IP \(bu 4
974 Builds with both \-DDEBUGGING and threading enabled would fail with a
975 "panic: free from wrong pool" error when built or tested from Terminal
976 on OS X. This was caused by perl\*(Aqs internal management of the
977 environment conflicting with an atfork handler using the libc
978 \&\f(CWsetenv()\fR function to update the environment.
979 .Sp
980 Perl now uses \f(CWsetenv()\fR/\f(CWunsetenv()\fR to update the environment on OS X.
981 [GH #14955] <https://github.com/Perl/perl5/issues/14955>
982 .RE
983 .RS 4
984 .RE
985 .IP Solaris 4
986 .IX Item "Solaris"
987 .RS 4
988 .PD 0
989 .IP \(bu 4
990 .PD
991 All Solaris variants now build a shared libperl
992 .Sp
993 Solaris and variants like OpenIndiana now always build with the shared
994 Perl library (Configure \-Duseshrplib). This was required for the
995 OpenIndiana builds, but this has also been the setting for Oracle/Sun
996 Perl builds for several years.
997 .RE
998 .RS 4
999 .RE
1000 .IP Tru64 4
1001 .IX Item "Tru64"
1002 .RS 4
1003 .PD 0
1004 .IP \(bu 4
1005 .PD
1006 Workaround where Tru64 balks when prototypes are listed as
1007 \&\f(CW\*(C`PERL_STATIC_INLINE\*(C'\fR, but where the test is build with
1008 \&\f(CW\*(C`\-DPERL_NO_INLINE_FUNCTIONS\*(C'\fR.
1009 .RE
1010 .RS 4
1011 .RE
1012 .IP VMS 4
1013 .IX Item "VMS"
1014 .RS 4
1015 .PD 0
1016 .IP \(bu 4
1017 .PD
1018 On VMS, the math function prototypes in \f(CW\*(C`math.h\*(C'\fR are now visible under C++.
1019 Now building the POSIX extension with C++ will no longer crash.
1020 .IP \(bu 4
1021 VMS has had \f(CW\*(C`setenv\*(C'\fR/\f(CW\*(C`unsetenv\*(C'\fR since v7.0 (released in 1996),
1022 \&\f(CW\*(C`Perl_vmssetenv\*(C'\fR now always uses \f(CW\*(C`setenv\*(C'\fR/\f(CW\*(C`unsetenv\*(C'\fR.
1023 .IP \(bu 4
1024 Perl now implements its own \f(CW\*(C`killpg\*(C'\fR by scanning for processes in the
1025 specified process group, which may not mean exactly the same thing as a Unix
1026 process group, but allows us to send a signal to a parent (or master) process
1027 and all of its sub\-processes. At the perl level, this means we can now send a
1028 negative pid like so:
1029 .Sp
1030 .Vb 1
1031 \& kill SIGKILL, \-$pid;
1032 .Ve
1033 .Sp
1034 to signal all processes in the same group as \f(CW$pid\fR.
1035 .IP \(bu 4
1036 For those \f(CW%ENV\fR elements based on the CRTL environ array, we\*(Aqve always
1037 preserved case when setting them but did look\-ups only after upcasing the
1038 key first, which made lower\- or mixed\-case entries go missing. This problem
1039 has been corrected by making \f(CW%ENV\fR elements derived from the environ array
1040 case\-sensitive on look\-up as well as case\-preserving on store.
1041 .IP \(bu 4
1042 Environment look\-ups for \f(CW\*(C`PERL5LIB\*(C'\fR and \f(CW\*(C`PERLLIB\*(C'\fR previously only
1043 considered logical names, but now consider all sources of \f(CW%ENV\fR as
1044 determined by \f(CW\*(C`PERL_ENV_TABLES\*(C'\fR and as documented in "%ENV" in perlvms.
1045 .IP \(bu 4
1046 The minimum supported version of VMS is now v7.3\-2, released in 2003. As a
1047 side effect of this change, VAX is no longer supported as the terminal
1048 release of OpenVMS VAX was v7.3 in 2001.
1049 .RE
1050 .RS 4
1051 .RE
1052 .IP Win32 4
1053 .IX Item "Win32"
1054 .RS 4
1055 .PD 0
1056 .IP \(bu 4
1057 .PD
1058 A new build option \f(CW\*(C`USE_NO_REGISTRY\*(C'\fR has been added to the makefiles. This
1059 option is off by default, meaning the default is to do Windows registry
1060 lookups. This option stops Perl from looking inside the registry for anything.
1061 For what values are looked up in the registry see perlwin32. Internally, in
1062 C, the name of this option is \f(CW\*(C`WIN32_NO_REGISTRY\*(C'\fR.
1063 .IP \(bu 4
1064 The behavior of Perl using \f(CW\*(C`HKEY_CURRENT_USER\eSoftware\ePerl\*(C'\fR and
1065 \&\f(CW\*(C`HKEY_LOCAL_MACHINE\eSoftware\ePerl\*(C'\fR to lookup certain values, including \f(CW%ENV\fR
1066 vars starting with \f(CW\*(C`PERL\*(C'\fR has changed. Previously, the 2 keys were checked
1067 for entries at all times through the perl process\*(Aqs life time even if
1068 they did not
1069 exist. For performance reasons, now, if the root key (i.e.
1070 \&\f(CW\*(C`HKEY_CURRENT_USER\eSoftware\ePerl\*(C'\fR or \f(CW\*(C`HKEY_LOCAL_MACHINE\eSoftware\ePerl\*(C'\fR) does
1071 not exist at process start time, it will not be checked again for \f(CW%ENV\fR
1072 override entries for the remainder of the perl process\*(Aqs life. This more
1073 closely matches Unix behavior in that the environment is copied or inherited
1074 on startup and changing the variable in the parent process or another process
1075 or editing \fI.bashrc\fR will not change the environmental variable in other
1076 existing, running, processes.
1077 .IP \(bu 4
1078 One glob fetch was removed for each \f(CW\*(C`\-X\*(C'\fR or \f(CW\*(C`stat\*(C'\fR call whether done from
1079 Perl code or internally from Perl\*(Aqs C code. The glob being looked up was
1080 \&\f(CW\*(C`${^WIN32_SLOPPY_STAT}\*(C'\fR which is a special variable. This makes \f(CW\*(C`\-X\*(C'\fR and
1081 \&\f(CW\*(C`stat\*(C'\fR slightly faster.
1082 .IP \(bu 4
1083 During miniperl\*(Aqs process startup, during the build process, 4 to 8 IO calls
1084 related to the process starting \fI.pl\fR and the \fIbuildcustomize.pl\fR file were
1085 removed from the code opening and executing the first 1 or 2 \fI.pl\fR files.
1086 .IP \(bu 4
1087 Builds using Microsoft Visual C++ 2003 and earlier no longer produce
1088 an "INTERNAL COMPILER ERROR" message. [perl #126045]
1089 .IP \(bu 4
1090 Visual C++ 2013 builds will now execute on XP and higher. Previously they would
1091 only execute on Vista and higher.
1092 .IP \(bu 4
1093 You can now build perl with GNU Make and GCC. [perl #123440]
1094 .IP \(bu 4
1095 \&\f(CW\*(C`truncate($filename, $size)\*(C'\fR now works for files over 4GB in size.
1096 [perl #125347]
1097 .IP \(bu 4
1098 Parallel building has been added to the dmake \f(CW\*(C`makefile.mk\*(C'\fR makefile. All
1099 Win32 compilers are supported.
1100 .IP \(bu 4
1101 Building a 64\-bit perl with a 64\-bit GCC but a 32\-bit gmake would
1102 result in an invalid \f(CW$Config{archname}\fR for the resulting perl.
1103 [perl #127584]
1104 .IP \(bu 4
1105 Errors set by Winsock functions are now put directly into \f(CW$^E\fR, and the
1106 relevant \f(CW\*(C`WSAE*\*(C'\fR error codes are now exported from the Errno and POSIX
1107 modules for testing this against.
1108 .Sp
1109 The previous behavior of putting the errors (converted to POSIX\-style \f(CW\*(C`E*\*(C'\fR
1110 error codes since Perl 5.20.0) into \f(CW$!\fR was buggy due to the non\-equivalence
1111 of like\-named Winsock and POSIX error constants, a relationship between which
1112 has unfortunately been established in one way or another since Perl 5.8.0.
1113 .Sp
1114 The new behavior provides a much more robust solution for checking Winsock
1115 errors in portable software without accidentally matching POSIX tests that were
1116 intended for other OSes and may have different meanings for Winsock.
1117 .Sp
1118 The old behavior is currently retained, warts and all, for backwards
1119 compatibility, but users are encouraged to change any code that tests \f(CW$!\fR
1120 against \f(CW\*(C`E*\*(C'\fR constants for Winsock errors to instead test \f(CW$^E\fR against
1121 \&\f(CW\*(C`WSAE*\*(C'\fR constants. After a suitable deprecation period, the old behavior may
1122 be removed, leaving \f(CW$!\fR unchanged after Winsock function calls, to avoid any
1123 possible confusion over which error variable to check.
1124 .RE
1125 .RS 4
1126 .RE
1127 .IP ppc64el 4
1128 .IX Item "ppc64el"
1129 .RS 4
1130 .PD 0
1131 .IP "floating point" 4
1132 .IX Item "floating point"
1133 .PD
1134 The floating point format of ppc64el (Debian naming for little\-endian
1135 PowerPC) is now detected correctly.
1136 .RE
1137 .RS 4
1138 .RE
1139 .SH "Internal Changes"
1140 .IX Header "Internal Changes"
1141 .IP \(bu 4
1142 The implementation of perl\*(Aqs context stack system, and its internal API,
1143 have been heavily reworked. Note that no significant changes have been
1144 made to any external APIs, but XS code which relies on such internal
1145 details may need to be fixed. The main changes are:
1146 .RS 4
1147 .IP \(bu 4
1148 The \f(CWPUSHBLOCK()\fR, \f(CWPOPSUB()\fR etc. macros have been replaced with static
1149 inline functions such as \f(CWcx_pushblock()\fR, \f(CWcx_popsub()\fR etc. These use
1150 function args rather than implicitly relying on local vars such as
1151 \&\f(CW\*(C`gimme\*(C'\fR and \f(CW\*(C`newsp\*(C'\fR being available. Also their functionality has
1152 changed: in particular, \f(CWcx_popblock()\fR no longer decrements
1153 \&\f(CW\*(C`cxstack_ix\*(C'\fR. The ordering of the steps in the \f(CW\*(C`pp_leave*\*(C'\fR functions
1154 involving \f(CWcx_popblock()\fR, \f(CWcx_popsub()\fR etc. has changed. See the new
1155 documentation, "Dynamic Scope and the Context Stack" in perlguts, for
1156 details on how to use them.
1157 .IP \(bu 4
1158 Various macros, which now consistently have a CX_ prefix, have been added:
1159 .Sp
1160 .Vb 1
1161 \& CX_CUR(), CX_LEAVE_SCOPE(), CX_POP()
1162 .Ve
1163 .Sp
1164 or renamed:
1165 .Sp
1166 .Vb 1
1167 \& CX_POP_SAVEARRAY(), CX_DEBUG(), CX_PUSHSUBST(), CX_POPSUBST()
1168 .Ve
1169 .IP \(bu 4
1170 \&\f(CWcx_pushblock()\fR now saves \f(CW\*(C`PL_savestack_ix\*(C'\fR and \f(CW\*(C`PL_tmps_floor\*(C'\fR, so
1171 \&\f(CW\*(C`pp_enter*\*(C'\fR and \f(CW\*(C`pp_leave*\*(C'\fR no longer do
1172 .Sp
1173 .Vb 1
1174 \& ENTER; SAVETMPS; ....; LEAVE
1175 .Ve
1176 .IP \(bu 4
1177 \&\f(CWcx_popblock()\fR now also restores \f(CW\*(C`PL_curpm\*(C'\fR.
1178 .IP \(bu 4
1179 In \f(CWdounwind()\fR for every context type, the current savestack frame is
1180 now processed before each context is popped; formerly this was only done
1181 for sub\-like context frames. This action has been removed from
1182 \&\f(CWcx_popsub()\fR and placed into its own macro, \f(CWCX_LEAVE_SCOPE(cx)\fR, which
1183 must be called before \f(CWcx_popsub()\fR etc.
1184 .Sp
1185 \&\f(CWdounwind()\fR now also does a \f(CWcx_popblock()\fR on the last popped frame
1186 (formerly it only did the \f(CWcx_popsub()\fR etc. actions on each frame).
1187 .IP \(bu 4
1188 The temps stack is now freed on scope exit; previously, temps created
1189 during the last statement of a block wouldn\*(Aqt be freed until the next
1190 \&\f(CW\*(C`nextstate\*(C'\fR following the block (apart from an existing hack that did
1191 this for recursive subs in scalar context); and in something like
1192 \&\f(CW\*(C`f(g())\*(C'\fR, the temps created by the last statement in \f(CWg()\fR would
1193 formerly not be freed until the statement following the return from
1194 \&\f(CWf()\fR.
1195 .IP \(bu 4
1196 Most values that were saved on the savestack on scope entry are now
1197 saved in suitable new fields in the context struct, and saved and
1198 restored directly by \f(CWcx_pushfoo()\fR and \f(CWcx_popfoo()\fR, which is much
1199 faster.
1200 .IP \(bu 4
1201 Various context struct fields have been added, removed or modified.
1202 .IP \(bu 4
1203 The handling of \f(CW@_\fR in \f(CWcx_pushsub()\fR and \f(CWcx_popsub()\fR has been
1204 considerably tidied up, including removing the \f(CW\*(C`argarray\*(C'\fR field from the
1205 context struct, and extracting out some common (but rarely used) code into
1206 a separate function, \f(CWclear_defarray()\fR. Also, useful subsets of
1207 \&\f(CWcx_popsub()\fR which had been unrolled in places like \f(CW\*(C`pp_goto\*(C'\fR have been
1208 gathered into the new functions \f(CWcx_popsub_args()\fR and
1209 \&\f(CWcx_popsub_common()\fR.
1210 .IP \(bu 4
1211 \&\f(CW\*(C`pp_leavesub\*(C'\fR and \f(CW\*(C`pp_leavesublv\*(C'\fR now use the same function as the rest
1212 of the \f(CW\*(C`pp_leave*\*(C'\fR\*(Aqs to process return args.
1213 .IP \(bu 4
1214 \&\f(CW\*(C`CXp_FOR_PAD\*(C'\fR and \f(CW\*(C`CXp_FOR_GV\*(C'\fR flags have been added, and
1215 \&\f(CW\*(C`CXt_LOOP_FOR\*(C'\fR has been split into \f(CW\*(C`CXt_LOOP_LIST\*(C'\fR, \f(CW\*(C`CXt_LOOP_ARY\*(C'\fR.
1216 .IP \(bu 4
1217 Some variables formerly declared by \f(CW\*(C`dMULTICALL\*(C'\fR (but not documented) have
1218 been removed.
1219 .RE
1220 .RS 4
1221 .RE
1222 .IP \(bu 4
1223 The obscure \f(CW\*(C`PL_timesbuf\*(C'\fR variable, effectively a vestige of Perl 1, has
1224 been removed. It was documented as deprecated in Perl 5.20, with a statement
1225 that it would be removed early in the 5.21.x series; that has now finally
1226 happened.
1227 [GH #13632] <https://github.com/Perl/perl5/issues/13632>
1228 .IP \(bu 4
1229 An unwarranted assertion in \f(CWPerl_newATTRSUB_x()\fR has been removed. If
1230 a stub subroutine
1231 definition with a prototype has been seen, then any subsequent stub (or
1232 definition) of the same subroutine with an attribute was causing an assertion
1233 failure because of a null pointer.
1234 [GH #15081] <https://github.com/Perl/perl5/issues/15081>
1235 .IP \(bu 4
1236 \&\f(CW\*(C`::\*(C'\fR has been replaced by \f(CW\*(C`_\|_\*(C'\fR in \f(CW\*(C`ExtUtils::ParseXS\*(C'\fR, like it\*(Aqs done for
1237 parameters/return values. This is more consistent, and simplifies writing XS
1238 code wrapping C++ classes into a nested Perl namespace (it requires only
1239 a typedef for \f(CW\*(C`Foo_\|_Bar\*(C'\fR rather than two, one for \f(CW\*(C`Foo_Bar\*(C'\fR and the other
1240 for \f(CW\*(C`Foo::Bar\*(C'\fR).
1241 .IP \(bu 4
1242 The \f(CWto_utf8_case()\fR function is now deprecated. Instead use
1243 \&\f(CW\*(C`toUPPER_utf8\*(C'\fR, \f(CW\*(C`toTITLE_utf8\*(C'\fR, \f(CW\*(C`toLOWER_utf8\*(C'\fR, and \f(CW\*(C`toFOLD_utf8\*(C'\fR.
1244 (See <http://nntp.perl.org/group/perl.perl5.porters/233287>.)
1245 .IP \(bu 4
1246 Perl core code and the threads extension have been annotated so that,
1247 if Perl is configured to use threads, then during compile\-time clang (3.6
1248 or later) will warn about suspicious uses of mutexes.
1249 See <http://clang.llvm.org/docs/ThreadSafetyAnalysis.html> for more
1250 information.
1251 .IP \(bu 4
1252 The \f(CWsignbit()\fR emulation has been enhanced. This will help older
1253 and/or more exotic platforms or configurations.
1254 .IP \(bu 4
1255 Most EBCDIC\-specific code in the core has been unified with non\-EBCDIC
1256 code, to avoid repetition and make maintenance easier.
1257 .IP \(bu 4
1258 MSWin32 code for \f(CW$^X\fR has been moved out of the \fIwin32\fR directory to
1259 \&\fIcaretx.c\fR, where other operating systems set that variable.
1260 .IP \(bu 4
1261 \&\f(CWsv_ref()\fR is now part of the API.
1262 .IP \(bu 4
1263 "sv_backoff" in perlapi had its return type changed from \f(CW\*(C`int\*(C'\fR to \f(CW\*(C`void\*(C'\fR. It
1264 previously has always returned \f(CW0\fR since Perl 5.000 stable but that was
1265 undocumented. Although \f(CW\*(C`sv_backoff\*(C'\fR is marked as public API, XS code is not
1266 expected to be impacted since the proper API call would be through public API
1267 \&\f(CW\*(C`sv_setsv(sv, &PL_sv_undef)\*(C'\fR, or quasi\-public \f(CW\*(C`SvOOK_off\*(C'\fR, or non\-public
1268 \&\f(CW\*(C`SvOK_off\*(C'\fR calls, and the return value of \f(CW\*(C`sv_backoff\*(C'\fR was previously a
1269 meaningless constant that can be rewritten as \f(CW\*(C`(sv_backoff(sv),0)\*(C'\fR.
1270 .IP \(bu 4
1271 The \f(CW\*(C`EXTEND\*(C'\fR and \f(CW\*(C`MEXTEND\*(C'\fR macros have been improved to avoid various issues
1272 with integer truncation and wrapping. In particular, some casts formerly used
1273 within the macros have been removed. This means for example that passing an
1274 unsigned \f(CW\*(C`nitems\*(C'\fR argument is likely to raise a compiler warning now
1275 (it\*(Aqs always been documented to require a signed value; formerly int,
1276 lately SSize_t).
1277 .IP \(bu 4
1278 \&\f(CW\*(C`PL_sawalias\*(C'\fR and \f(CW\*(C`GPf_ALIASED_SV\*(C'\fR have been removed.
1279 .IP \(bu 4
1280 \&\f(CW\*(C`GvASSIGN_GENERATION\*(C'\fR and \f(CW\*(C`GvASSIGN_GENERATION_set\*(C'\fR have been removed.
1281 .SH "Selected Bug Fixes"
1282 .IX Header "Selected Bug Fixes"
1283 .IP \(bu 4
1284 It now works properly to specify a user\-defined property, such as
1285 .Sp
1286 .Vb 1
1287 \& qr/\ep{mypkg1::IsMyProperty}/i
1288 .Ve
1289 .Sp
1290 with \f(CW\*(C`/i\*(C'\fR caseless matching, an explicit package name, and
1291 \&\fIIsMyProperty\fR not defined at the time of the pattern compilation.
1292 .IP \(bu 4
1293 Perl\*(Aqs \f(CWmemcpy()\fR, \f(CWmemmove()\fR, \f(CWmemset()\fR and \f(CWmemcmp()\fR fallbacks are now
1294 more compatible with the originals. [perl #127619]
1295 .IP \(bu 4
1296 Fixed the issue where a \f(CW\*(C`s///r\*(C'\fR) with \fB\-DPERL_NO_COW\fR attempts
1297 to modify the source SV, resulting in the program dying. [perl #127635]
1298 .IP \(bu 4
1299 Fixed an EBCDIC\-platform\-only case where a pattern could fail to match. This
1300 occurred when matching characters from the set of C1 controls when the
1301 target matched string was in UTF\-8.
1302 .IP \(bu 4
1303 Narrow the filename check in \fIstrict.pm\fR and \fIwarnings.pm\fR. Previously,
1304 it assumed that if the filename (without the \fI.pmc?\fR extension) differed
1305 from the package name, if was a misspelled use statement (i.e. \f(CW\*(C`use Strict\*(C'\fR
1306 instead of \f(CW\*(C`use strict\*(C'\fR). We now check whether there\*(Aqs really a
1307 miscapitalization happening, and not some other issue.
1308 .IP \(bu 4
1309 Turn an assertion into a more user friendly failure when parsing
1310 regexes. [perl #127599]
1311 .IP \(bu 4
1312 Correctly raise an error when trying to compile patterns with
1313 unterminated character classes while there are trailing backslashes.
1314 [perl #126141].
1315 .IP \(bu 4
1316 Line numbers larger than 2**31\-1 but less than 2**32 are no longer
1317 returned by \f(CWcaller()\fR as negative numbers. [perl #126991]
1318 .IP \(bu 4
1319 \&\f(CW\*(C`unless ( \fR\f(CIassignment\fR\f(CW )\*(C'\fR now properly warns when syntax
1320 warnings are enabled. [perl #127122]
1321 .IP \(bu 4
1322 Setting an \f(CW\*(C`ISA\*(C'\fR glob to an array reference now properly adds
1323 \&\f(CW\*(C`isaelem\*(C'\fR magic to any existing elements. Previously modifying such
1324 an element would not update the ISA cache, so method calls would call
1325 the wrong function. Perl would also crash if the \f(CW\*(C`ISA\*(C'\fR glob was
1326 destroyed, since new code added in 5.23.7 would try to release the
1327 \&\f(CW\*(C`isaelem\*(C'\fR magic from the elements. [perl #127351]
1328 .IP \(bu 4
1329 If a here\-doc was found while parsing another operator, the parser had
1330 already read end of file, and the here\-doc was not terminated, perl
1331 could produce an assertion or a segmentation fault. This now reliably
1332 complains about the unterminated here\-doc. [perl #125540]
1333 .IP \(bu 4
1334 \&\f(CWuntie()\fR would sometimes return the last value returned by the \f(CWUNTIE()\fR
1335 handler as well as its normal value, messing up the stack. [perl
1336 #126621]
1337 .IP \(bu 4
1338 Fixed an operator precedence problem when \f(CW\*(C` castflags & 2\*(C'\fR is true.
1339 [perl #127474]
1340 .IP \(bu 4
1341 Caching of DESTROY methods could result in a non\-pointer or a
1342 non\-STASH stored in the \f(CWSvSTASH()\fR slot of a stash, breaking the B
1343 \&\f(CWSTASH()\fR method. The DESTROY method is now cached in the MRO metadata
1344 for the stash. [perl #126410]
1345 .IP \(bu 4
1346 The AUTOLOAD method is now called when searching for a DESTROY method,
1347 and correctly sets \f(CW$AUTOLOAD\fR too. [perl #124387] [perl #127494]
1348 .IP \(bu 4
1349 Avoid parsing beyond the end of the buffer when processing a \f(CW\*(C`#line\*(C'\fR
1350 directive with no filename. [perl #127334]
1351 .IP \(bu 4
1352 Perl now raises a warning when a regular expression pattern looks like
1353 it was supposed to contain a POSIX class, like \f(CW\*(C`qr/[[:alpha:]]/\*(C'\fR, but
1354 there was some slight defect in its specification which causes it to
1355 instead be treated as a regular bracketed character class. An example
1356 would be missing the second colon in the above like this:
1357 \&\f(CW\*(C`qr/[[:alpha]]/\*(C'\fR. This compiles to match a sequence of two characters.
1358 The second is \f(CW"]"\fR, and the first is any of: \f(CW"["\fR, \f(CW":"\fR, \f(CW"a"\fR,
1359 \&\f(CW"h"\fR, \f(CW"l"\fR, or \f(CW"p"\fR. This is unlikely to be the intended
1360 meaning, and now a warning is raised. No warning is raised unless the
1361 specification is very close to one of the 14 legal POSIX classes. (See
1362 "POSIX Character Classes" in perlrecharclass.)
1363 [perl #8904]
1364 .IP \(bu 4
1365 Certain regex patterns involving a complemented POSIX class in an
1366 inverted bracketed character class, and matching something else
1367 optionally would improperly fail to match. An example of one that could
1368 fail is \f(CW\*(C`qr/_?[^\eWbar]\ex{100}/\*(C'\fR. This has been fixed.
1369 [perl #127537]
1370 .IP \(bu 4
1371 Perl 5.22 added support to the C99 hexadecimal floating point notation,
1372 but sometimes misparses hex floats. This has been fixed.
1373 [perl #127183]
1374 .IP \(bu 4
1375 A regression that allowed undeclared barewords in hash keys to work despite
1376 strictures has been fixed.
1377 [GH #15099] <https://github.com/Perl/perl5/issues/15099>
1378 .IP \(bu 4
1379 Calls to the placeholder \f(CW&PL_sv_yes\fR used internally when an \f(CWimport()\fR
1380 or \f(CWunimport()\fR method isn\*(Aqt found now correctly handle scalar context.
1381 [GH #14902] <https://github.com/Perl/perl5/issues/14902>
1382 .IP \(bu 4
1383 Report more context when we see an array where we expect to see an
1384 operator and avoid an assertion failure.
1385 [GH #14472] <https://github.com/Perl/perl5/issues/14472>
1386 .IP \(bu 4
1387 Modifying an array that was previously a package \f(CW@ISA\fR no longer
1388 causes assertion failures or crashes.
1389 [GH #14492] <https://github.com/Perl/perl5/issues/14492>
1390 .IP \(bu 4
1391 Retain binary compatibility across plain and DEBUGGING perl builds.
1392 [GH #15122] <https://github.com/Perl/perl5/issues/15122>
1393 .IP \(bu 4
1394 Avoid leaking memory when setting \f(CW$ENV{foo}\fR on darwin.
1395 [GH #14955] <https://github.com/Perl/perl5/issues/14955>
1396 .IP \(bu 4
1397 \&\f(CW\*(C`/...\eG/\*(C'\fR no longer crashes on utf8 strings. When \f(CW\*(C`\eG\*(C'\fR is a fixed number
1398 of characters from the start of the regex, perl needs to count back that
1399 many characters from the current \f(CWpos()\fR position and start matching from
1400 there. However, it was counting back bytes rather than characters, which
1401 could lead to panics on utf8 strings.
1402 .IP \(bu 4
1403 In some cases operators that return integers would return negative
1404 integers as large positive integers.
1405 [GH #15049] <https://github.com/Perl/perl5/issues/15049>
1406 .IP \(bu 4
1407 The \f(CWpipe()\fR operator would assert for DEBUGGING builds instead of
1408 producing the correct error message. The condition asserted on is
1409 detected and reported on correctly without the assertions, so the
1410 assertions were removed.
1411 [GH #15015] <https://github.com/Perl/perl5/issues/15015>
1412 .IP \(bu 4
1413 In some cases, failing to parse a here\-doc would attempt to use freed
1414 memory. This was caused by a pointer not being restored correctly.
1415 [GH #15009] <https://github.com/Perl/perl5/issues/15009>
1416 .IP \(bu 4
1417 \&\f(CW\*(C`@x = sort { *a = 0; $a <=> $b } 0 .. 1\*(C'\fR no longer frees the GP
1418 for *a before restoring its SV slot.
1419 [GH #14595] <https://github.com/Perl/perl5/issues/14595>
1420 .IP \(bu 4
1421 Multiple problems with the new hexadecimal floating point printf
1422 format \f(CW%a\fR were fixed:
1423 [GH #15032] <https://github.com/Perl/perl5/issues/15032>,
1424 [GH #15033] <https://github.com/Perl/perl5/issues/15033>,
1425 [GH #15074] <https://github.com/Perl/perl5/issues/15074>
1426 .IP \(bu 4
1427 Calling \f(CWmg_set()\fR in \f(CWleave_scope()\fR no longer leaks.
1428 .IP \(bu 4
1429 A regression from Perl v5.20 was fixed in which debugging output of regular
1430 expression compilation was wrong. (The pattern was correctly compiled, but
1431 what got displayed for it was wrong.)
1432 .IP \(bu 4
1433 \&\f(CW\*(C`\eb{sb}\*(C'\fR works much better. In Perl v5.22.0, this new construct didn\*(Aqt
1434 seem to give the expected results, yet passed all the tests in the
1435 extensive suite furnished by Unicode. It turns out that it was because
1436 these were short input strings, and the failures had to do with longer
1437 inputs.
1438 .IP \(bu 4
1439 Certain syntax errors in
1440 "Extended Bracketed Character Classes" in perlrecharclass caused panics
1441 instead of the proper error message. This has now been fixed. [perl
1442 #126481]
1443 .IP \(bu 4
1444 Perl 5.20 added a message when a quantifier in a regular
1445 expression was useless, but then caused the parser to skip it;
1446 this caused the surplus quantifier to be silently ignored, instead
1447 of throwing an error. This is now fixed. [perl #126253]
1448 .IP \(bu 4
1449 The switch to building non\-XS modules last in win32/makefile.mk (introduced
1450 by design as part of the changes to enable parallel building) caused the
1451 build of POSIX to break due to problems with the version module. This
1452 is now fixed.
1453 .IP \(bu 4
1454 Improved parsing of hex float constants.
1455 .IP \(bu 4
1456 Fixed an issue with \f(CW\*(C`pack\*(C'\fR where \f(CW\*(C`pack "H"\*(C'\fR (and \f(CW\*(C`pack "h"\*(C'\fR)
1457 could read past the source when given a non\-utf8 source, and a utf8 target.
1458 [perl #126325]
1459 .IP \(bu 4
1460 Fixed several cases where perl would abort due to a segmentation fault,
1461 or a C\-level assert. [perl #126615], [perl #126602], [perl #126193].
1462 .IP \(bu 4
1463 There were places in regular expression patterns where comments (\f(CW\*(C`(?#...)\*(C'\fR)
1464 weren\*(Aqt allowed, but should have been. This is now fixed.
1465 [GH #12755] <https://github.com/Perl/perl5/issues/12755>
1466 .IP \(bu 4
1467 Some regressions from Perl 5.20 have been fixed, in which some syntax errors in
1468 \&\f(CW\*(C`(?[...])\*(C'\fR constructs
1469 within regular expression patterns could cause a segfault instead of a proper
1470 error message.
1471 [GH #14933] <https://github.com/Perl/perl5/issues/14933>
1472 [GH #14996] <https://github.com/Perl/perl5/issues/14996>
1473 .IP \(bu 4
1474 Another problem with
1475 \&\f(CW\*(C`(?[...])\*(C'\fR
1476 constructs has been fixed wherein things like \f(CW\*(C`\ec]\*(C'\fR could cause panics.
1477 [GH #14934] <https://github.com/Perl/perl5/issues/14934>
1478 .IP \(bu 4
1479 Some problems with attempting to extend the perl stack to around 2G or 4G
1480 entries have been fixed. This was particularly an issue on 32\-bit perls built
1481 to use 64\-bit integers, and was easily noticeable with the list repetition
1482 operator, e.g.
1483 .Sp
1484 .Vb 1
1485 \& @a = (1) x $big_number
1486 .Ve
1487 .Sp
1488 Formerly perl may have crashed, depending on the exact value of \f(CW$big_number\fR;
1489 now it will typically raise an exception.
1490 [GH #14880] <https://github.com/Perl/perl5/issues/14880>
1491 .IP \(bu 4
1492 In a regex conditional expression \f(CW\*(C`(?(condition)yes\-pattern|no\-pattern)\*(C'\fR, if
1493 the condition is \f(CW\*(C`(?!)\*(C'\fR then perl failed the match outright instead of
1494 matching the no\-pattern. This has been fixed.
1495 [GH #14947] <https://github.com/Perl/perl5/issues/14947>
1496 .IP \(bu 4
1497 The special backtracking control verbs \f(CW\*(C`(*VERB:ARG)\*(C'\fR now all allow an optional
1498 argument and set \f(CW\*(C`REGERROR\*(C'\fR/\f(CW\*(C`REGMARK\*(C'\fR appropriately as well.
1499 [GH #14937] <https://github.com/Perl/perl5/issues/14937>
1500 .IP \(bu 4
1501 Several bugs, including a segmentation fault, have been fixed with the boundary
1502 checking constructs (introduced in Perl 5.22) \f(CW\*(C`\eb{gcb}\*(C'\fR, \f(CW\*(C`\eb{sb}\*(C'\fR, \f(CW\*(C`\eb{wb}\*(C'\fR,
1503 \&\f(CW\*(C`\eB{gcb}\*(C'\fR, \f(CW\*(C`\eB{sb}\*(C'\fR, and \f(CW\*(C`\eB{wb}\*(C'\fR. All the \f(CW\*(C`\eB{}\*(C'\fR ones now match an empty
1504 string; none of the \f(CW\*(C`\eb{}\*(C'\fR ones do.
1505 [GH #14976] <https://github.com/Perl/perl5/issues/14976>
1506 .IP \(bu 4
1507 Duplicating a closed file handle for write no longer creates a
1508 filename of the form \fIGLOB(0xXXXXXXXX)\fR. [perl #125115]
1509 .IP \(bu 4
1510 Warning fatality is now ignored when rewinding the stack. This
1511 prevents infinite recursion when the now fatal error also causes
1512 rewinding of the stack. [perl #123398]
1513 .IP \(bu 4
1514 In perl v5.22.0, the logic changed when parsing a numeric parameter to the \-C
1515 option, such that the successfully parsed number was not saved as the option
1516 value if it parsed to the end of the argument. [perl #125381]
1517 .IP \(bu 4
1518 The PadlistNAMES macro is an lvalue again.
1519 .IP \(bu 4
1520 Zero \-DPERL_TRACE_OPS memory for sub\-threads.
1521 .Sp
1522 \&\f(CWperl_clone_using()\fR was missing Zero init of PL_op_exec_cnt[]. This
1523 caused sub\-threads in threaded \-DPERL_TRACE_OPS builds to spew exceedingly
1524 large op\-counts at destruct. These counts would print \f(CW%x\fR as "ABABABAB",
1525 clearly a mem\-poison value.
1526 .IP \(bu 4
1527 A leak in the XS typemap caused one scalar to be leaked each time a \f(CW\*(C`FILE *\*(C'\fR
1528 or a \f(CW\*(C`PerlIO *\*(C'\fR was \f(CW\*(C`OUTPUT:\*(C'\fRed or imported to Perl, since perl 5.000. These
1529 particular typemap entries are thought to be extremely rarely used by XS
1530 modules. [perl #124181]
1531 .IP \(bu 4
1532 \&\f(CWalarm()\fR and \f(CWsleep()\fR will now warn if the argument is a negative number
1533 and return undef. Previously they would pass the negative value to the
1534 underlying C function which may have set up a timer with a surprising value.
1535 .IP \(bu 4
1536 Perl can again be compiled with any Unicode version. This used to
1537 (mostly) work, but was lost in v5.18 through v5.20. The property
1538 \&\f(CW\*(C`Name_Alias\*(C'\fR did not exist prior to Unicode 5.0. Unicode::UCD
1539 incorrectly said it did. This has been fixed.
1540 .IP \(bu 4
1541 Very large code\-points (beyond Unicode) in regular expressions no
1542 longer cause a buffer overflow in some cases when converted to UTF\-8.
1543 [GH #14858] <https://github.com/Perl/perl5/issues/14858>
1544 .IP \(bu 4
1545 The integer overflow check for the range operator (...) in list
1546 context now correctly handles the case where the size of the range is
1547 larger than the address space. This could happen on 32\-bits with
1548 \&\-Duse64bitint.
1549 [GH #14843] <https://github.com/Perl/perl5/issues/14843>
1550 .IP \(bu 4
1551 A crash with \f(CW\*(C`%::=(); J\->${\e"::"}\*(C'\fR has been fixed.
1552 [GH #14790] <https://github.com/Perl/perl5/issues/14790>
1553 .IP \(bu 4
1554 \&\f(CW\*(C`qr/(?[ () ])/\*(C'\fR no longer segfaults, giving a syntax error message instead.
1555 [perl #125805]
1556 .IP \(bu 4
1557 Regular expression possessive quantifier v5.20 regression now fixed.
1558 \&\f(CW\*(C`qr/\*(C'\fR\fIPAT\fR\f(CW\*(C`{\*(C'\fR\fImin\fR,\fImax\fR\f(CW\*(C`}+\*(C'\fR\f(CW\*(C`/\*(C'\fR is supposed to behave identically
1559 to \f(CW\*(C`qr/(?>\*(C'\fR\fIPAT\fR\f(CW\*(C`{\*(C'\fR\fImin\fR,\fImax\fR\f(CW\*(C`})/\*(C'\fR. Since v5.20, this didn\*(Aqt
1560 work if \fImin\fR and \fImax\fR were equal. [perl #125825]
1561 .IP \(bu 4
1562 \&\f(CW\*(C`BEGIN <>\*(C'\fR no longer segfaults and properly produces an error
1563 message. [perl #125341]
1564 .IP \(bu 4
1565 In \f(CW\*(C`tr///\*(C'\fR an illegal backwards range like \f(CW\*(C`tr/\ex{101}\-\ex{100}//\*(C'\fR was
1566 not always detected, giving incorrect results. This is now fixed.
1567 .SH Acknowledgements
1568 .IX Header "Acknowledgements"
1569 Perl 5.24.0 represents approximately 11 months of development since Perl 5.24.0
1570 and contains approximately 360,000 lines of changes across 1,800 files from 75
1571 authors.
1572 .PP
1573 Excluding auto\-generated files, documentation and release tools, there were
1574 approximately 250,000 lines of changes to 1,200 .pm, .t, .c and .h files.
1575 .PP
1576 Perl continues to flourish into its third decade thanks to a vibrant community
1577 of users and developers. The following people are known to have contributed the
1578 improvements that became Perl 5.24.0:
1579 .PP
1580 Aaron Crane, Aaron Priven, Abigail, Achim Gratz, Alexander D\*(AqArchangel, Alex
1581 Vandiver, Andreas König, Andy Broad, Andy Dougherty, Aristotle Pagaltzis,
1582 Chase Whitener, Chas. Owens, Chris \*(AqBinGOs\*(Aq Williams, Craig A. Berry, Dagfinn
1583 Ilmari Mannsåker, Dan Collins, Daniel Dragan, David Golden, David Mitchell,
1584 Doug Bell, Dr.Ruud, Ed Avis, Ed J, Father Chrysostomos, Herbert Breunung,
1585 H.Merijn Brand, Hugo van der Sanden, Ivan Pozdeev, James E Keenan, Jan Dubois,
1586 Jarkko Hietaniemi, Jerry D. Hedden, Jim Cromie, John Peacock, John SJ Anderson,
1587 Karen Etheridge, Karl Williamson, kmx, Leon Timmermans, Ludovic E. R.
1588 Tolhurst\-Cleaver, Lukas Mai, Martijn Lievaart, Matthew Horsfall, Mattia Barbon,
1589 Max Maischein, Mohammed El\-Afifi, Nicholas Clark, Nicolas R., Niko Tyni, Peter
1590 John Acklam, Peter Martini, Peter Rabbitson, Pip Cet, Rafael Garcia\-Suarez,
1591 Reini Urban, Ricardo Signes, Sawyer X, Shlomi Fish, Sisyphus, Stanislaw Pusep,
1592 Steffen Müller, Stevan Little, Steve Hay, Sullivan Beck, Thomas Sibley, Todd
1593 Rinaldo, Tom Hukins, Tony Cook, Unicode Consortium, Victor Adam, Vincent Pit,
1594 Vladimir Timofeev, Yves Orton, Zachary Storer, Zefram.
1595 .PP
1596 The list above is almost certainly incomplete as it is automatically generated
1597 from version control history. In particular, it does not include the names of
1598 the (very much appreciated) contributors who reported issues to the Perl bug
1599 tracker.
1600 .PP
1601 Many of the changes included in this version originated in the CPAN modules
1602 included in Perl\*(Aqs core. We\*(Aqre grateful to the entire CPAN community for
1603 helping Perl to flourish.
1604 .PP
1605 For a more complete list of all of Perl\*(Aqs historical contributors, please see
1606 the \fIAUTHORS\fR file in the Perl source distribution.
1607 .SH "Reporting Bugs"
1608 .IX Header "Reporting Bugs"
1609 If you find what you think is a bug, you might check the articles recently
1610 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
1611 https://rt.perl.org/ . There may also be information at
1612 http://www.perl.org/ , the Perl Home Page.
1613 .PP
1614 If you believe you have an unreported bug, please run the perlbug program
1615 included with your release. Be sure to trim your bug down to a tiny but
1616 sufficient test case. Your bug report, along with the output of \f(CW\*(C`perl \-V\*(C'\fR,
1617 will be sent off to [email protected] to be analysed by the Perl porting team.
1618 .PP
1619 If the bug you are reporting has security implications which make it
1620 inappropriate to send to a publicly archived mailing list, then see
1621 "SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec
1622 for details of how to report the issue.
1623 .SH "SEE ALSO"
1624 .IX Header "SEE ALSO"
1625 The \fIChanges\fR file for an explanation of how to view exhaustive details on
1626 what changed.
1627 .PP
1628 The \fIINSTALL\fR file for how to build Perl.
1629 .PP
1630 The \fIREADME\fR file for general stuff.
1631 .PP
1632 The \fIArtistic\fR and \fICopying\fR files for copyright information.