| 1 |
.\" -*- mode: troff; coding: utf-8 -*- |
| 2 |
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45) |
| 3 |
.\" |
| 4 |
.\" Standard preamble: |
| 5 |
.\" ======================================================================== |
| 6 |
.de Sp \" Vertical space (when we can't use .PP) |
| 7 |
.if t .sp .5v |
| 8 |
.if n .sp |
| 9 |
.. |
| 10 |
.de Vb \" Begin verbatim text |
| 11 |
.ft CW |
| 12 |
.nf |
| 13 |
.ne \\$1 |
| 14 |
.. |
| 15 |
.de Ve \" End verbatim text |
| 16 |
.ft R |
| 17 |
.fi |
| 18 |
.. |
| 19 |
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. |
| 20 |
.ie n \{\ |
| 21 |
. ds C` "" |
| 22 |
. ds C' "" |
| 23 |
'br\} |
| 24 |
.el\{\ |
| 25 |
. ds C` |
| 26 |
. ds C' |
| 27 |
'br\} |
| 28 |
.\" |
| 29 |
.\" Escape single quotes in literal strings from groff's Unicode transform. |
| 30 |
.ie \n(.g .ds Aq \(aq |
| 31 |
.el .ds Aq ' |
| 32 |
.\" |
| 33 |
.\" If the F register is >0, we'll generate index entries on stderr for |
| 34 |
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
| 35 |
.\" entries marked with X<> in POD. Of course, you'll have to process the |
| 36 |
.\" output yourself in some meaningful fashion. |
| 37 |
.\" |
| 38 |
.\" Avoid warning from groff about undefined register 'F'. |
| 39 |
.de IX |
| 40 |
.. |
| 41 |
.nr rF 0 |
| 42 |
.if \n(.g .if rF .nr rF 1 |
| 43 |
.if (\n(rF:(\n(.g==0)) \{\ |
| 44 |
. if \nF \{\ |
| 45 |
. de IX |
| 46 |
. tm Index:\\$1\t\\n%\t"\\$2" |
| 47 |
.. |
| 48 |
. if !\nF==2 \{\ |
| 49 |
. nr % 0 |
| 50 |
. nr F 2 |
| 51 |
. \} |
| 52 |
. \} |
| 53 |
.\} |
| 54 |
.rr rF |
| 55 |
.\" ======================================================================== |
| 56 |
.\" |
| 57 |
.IX Title "PERL5360DELTA 1" |
| 58 |
.TH PERL5360DELTA 1 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide" |
| 59 |
.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
| 60 |
.\" way too many mistakes in technical documents. |
| 61 |
.if n .ad l |
| 62 |
.nh |
| 63 |
.SH NAME |
| 64 |
perl5360delta \- what is new for perl v5.36.0 |
| 65 |
.SH DESCRIPTION |
| 66 |
.IX Header "DESCRIPTION" |
| 67 |
This document describes differences between the 5.34.0 release and the 5.36.0 |
| 68 |
release. |
| 69 |
.SH "Core Enhancements" |
| 70 |
.IX Header "Core Enhancements" |
| 71 |
.ie n .SS """use v5.36""" |
| 72 |
.el .SS "\f(CWuse v5.36\fP" |
| 73 |
.IX Subsection "use v5.36" |
| 74 |
As always, \f(CW\*(C`use v5.36\*(C'\fR turns on the feature bundle for that version of Perl. |
| 75 |
.PP |
| 76 |
The 5.36 bundle enables the \f(CW\*(C`signatures\*(C'\fR feature. Introduced in Perl version |
| 77 |
5.20.0, and modified several times since, the subroutine signatures feature is |
| 78 |
now no longer considered experimental. It is now considered a stable language |
| 79 |
feature and no longer prints a warning. |
| 80 |
.PP |
| 81 |
.Vb 1 |
| 82 |
\& use v5.36; |
| 83 |
\& |
| 84 |
\& sub add ($x, $y) { |
| 85 |
\& return $x + $y; |
| 86 |
\& } |
| 87 |
.Ve |
| 88 |
.PP |
| 89 |
Despite this, certain elements of signatured subroutines remain experimental; |
| 90 |
see below. |
| 91 |
.PP |
| 92 |
The 5.36 bundle enables the \f(CW\*(C`isa\*(C'\fR feature. Introduced in Perl version 5.32.0, |
| 93 |
this operator has remained unchanged since then. The operator is now considered |
| 94 |
a stable language feature. For more detail see "Class Instance |
| 95 |
Operator" in perlop. |
| 96 |
.PP |
| 97 |
The 5.36 bundle also \fIdisables\fR the features \f(CW\*(C`indirect\*(C'\fR, and |
| 98 |
\&\f(CW\*(C`multidimensional\*(C'\fR. These will forbid, respectively: the use of "indirect" |
| 99 |
method calls (like \f(CW\*(C`$x = new Class;\*(C'\fR); the use of a list expression as a hash |
| 100 |
key to simulate sparse multidimensional arrays. The specifics of these changes |
| 101 |
can be found in feature, but the short version is: this is a bit like having |
| 102 |
more \f(CW\*(C`use strict\*(C'\fR turned on, disabling features that cause more trouble than |
| 103 |
they're worth. |
| 104 |
.PP |
| 105 |
Furthermore, \f(CW\*(C`use v5.36\*(C'\fR will also enable warnings as if you'd written \f(CW\*(C`use |
| 106 |
warnings\*(C'\fR. |
| 107 |
.PP |
| 108 |
Finally, with this release, the experimental \f(CW\*(C`switch\*(C'\fR feature, present in |
| 109 |
every feature bundle since they were introduced in v5.10, has been removed from |
| 110 |
the v5.36 bundle. If you want to use it (against our advice), you'll have to |
| 111 |
enable it explicitly. |
| 112 |
.SS "\-g command-line flag" |
| 113 |
.IX Subsection "-g command-line flag" |
| 114 |
A new command-line flag, \-g, is available. It is a simpler alias for \-0777. |
| 115 |
.PP |
| 116 |
For more information, see "\-g" in perlrun. |
| 117 |
.SS "Unicode 14.0 is supported" |
| 118 |
.IX Subsection "Unicode 14.0 is supported" |
| 119 |
See <https://www.unicode.org/versions/Unicode14.0.0/> for details. |
| 120 |
.SS "regex sets are no longer considered experimental" |
| 121 |
.IX Subsection "regex sets are no longer considered experimental" |
| 122 |
Prior to this release, the regex sets feature (officially named |
| 123 |
"Extended Bracketed Character Classes") was considered experimental. |
| 124 |
Introduced in Perl version 5.18.0, and modified several times since, |
| 125 |
this is now considered a stable language feature and its use no longer |
| 126 |
prints a warning. See "Extended Bracketed Character |
| 127 |
Classes" in perlrecharclass. |
| 128 |
.SS "Variable length lookbehind is mostly no longer considered experimental" |
| 129 |
.IX Subsection "Variable length lookbehind is mostly no longer considered experimental" |
| 130 |
Prior to this release, any form of variable length lookbehind was |
| 131 |
considered experimental. With this release the experimental status has |
| 132 |
been reduced to cover only lookbehind that contains capturing parenthesis. |
| 133 |
This is because it is not clear if |
| 134 |
.PP |
| 135 |
.Vb 1 |
| 136 |
\& "aaz"=~/(?=z)(?<=(a|aa))/ |
| 137 |
.Ve |
| 138 |
.PP |
| 139 |
should match and leave \f(CW$1\fR equaling "a" or "aa". Currently it will match |
| 140 |
the longest possible alternative, "aa". While we are confident that the overall |
| 141 |
construct will now match only when it should, we are not confident that we |
| 142 |
will keep the current "longest match" behavior. |
| 143 |
.SS "SIGFPE no longer deferred" |
| 144 |
.IX Subsection "SIGFPE no longer deferred" |
| 145 |
Floating-point exceptions are now delivered immediately, in the same way |
| 146 |
as other "fault"\-like signals such as SIGSEGV. This means one has at |
| 147 |
least a chance to catch such a signal with a \f(CW$SIG{FPE}\fR handler, e.g. |
| 148 |
so that \f(CW\*(C`die\*(C'\fR can report the line in perl that triggered it. |
| 149 |
.SS "Stable boolean tracking" |
| 150 |
.IX Subsection "Stable boolean tracking" |
| 151 |
The "true" and "false" boolean values, often accessed by constructions like |
| 152 |
\&\f(CW\*(C`!!0\*(C'\fR and \f(CW\*(C`!!1\*(C'\fR, as well as being returned from many core functions and |
| 153 |
operators, now remember their boolean nature even through assignment into |
| 154 |
variables. The new function \f(CWis_bool()\fR in builtin can check whether |
| 155 |
a value has boolean nature. |
| 156 |
.PP |
| 157 |
This is likely to be useful when interoperating with other languages or |
| 158 |
data-type serialisation, among other places. |
| 159 |
.SS "iterating over multiple values at a time (experimental)" |
| 160 |
.IX Subsection "iterating over multiple values at a time (experimental)" |
| 161 |
You can now iterate over multiple values at a time by specifying a list of |
| 162 |
lexicals within parentheses. For example, |
| 163 |
.PP |
| 164 |
.Vb 2 |
| 165 |
\& for my ($key, $value) (%hash) { ... } |
| 166 |
\& for my ($left, $right, $gripping) (@moties) { ... } |
| 167 |
.Ve |
| 168 |
.PP |
| 169 |
Prior to perl v5.36, attempting to specify a list after \f(CW\*(C`for my\*(C'\fR was a syntax |
| 170 |
error. |
| 171 |
.PP |
| 172 |
This feature is currently experimental and will cause a warning of category |
| 173 |
\&\f(CW\*(C`experimental::for_list\*(C'\fR. For more detail see "Compound Statements" in perlsyn. |
| 174 |
See also "builtin::indexed" in this document, which is a handy companion to |
| 175 |
n\-at-a-time foreach. |
| 176 |
.SS "builtin functions (experimental)" |
| 177 |
.IX Subsection "builtin functions (experimental)" |
| 178 |
A new core module builtin has been added, which provides documentation for |
| 179 |
new always-present functions that are built into the interpreter. |
| 180 |
.PP |
| 181 |
.Vb 1 |
| 182 |
\& say "Reference type of arrays is ", builtin::reftype([]); |
| 183 |
.Ve |
| 184 |
.PP |
| 185 |
It also provides a lexical import mechanism for providing short name versions |
| 186 |
of these functions. |
| 187 |
.PP |
| 188 |
.Vb 2 |
| 189 |
\& use builtin \*(Aqreftype\*(Aq; |
| 190 |
\& say "Reference type of arrays is ", reftype([]); |
| 191 |
.Ve |
| 192 |
.PP |
| 193 |
This builtin function mechanism and the functions it provides are all |
| 194 |
currently \fBexperimental\fR. We expect that \f(CW\*(C`builtin\*(C'\fR itself will cease to be |
| 195 |
experimental in the near future, but that individual functions in it may become |
| 196 |
stable on an ongoing basis. Other functions will be added to \f(CW\*(C`builtin\*(C'\fR over |
| 197 |
time. |
| 198 |
.PP |
| 199 |
For details, see builtin, but here's a summary of builtin functions in |
| 200 |
v5.36: |
| 201 |
.IP builtin::trim 4 |
| 202 |
.IX Item "builtin::trim" |
| 203 |
This function treats its argument as a string, returning the result of removing |
| 204 |
all white space at its beginning and ending. |
| 205 |
.IP builtin::indexed 4 |
| 206 |
.IX Item "builtin::indexed" |
| 207 |
This function returns a list twice as big as its argument list, where each item |
| 208 |
is preceded by its index within that list. This is primarily useful for using |
| 209 |
the new \f(CW\*(C`foreach\*(C'\fR syntax with multiple iterator variables to iterate over an |
| 210 |
array or list, while also tracking the index of each item: |
| 211 |
.Sp |
| 212 |
.Vb 1 |
| 213 |
\& use builtin \*(Aqindexed\*(Aq; |
| 214 |
\& |
| 215 |
\& foreach my ($index, $val) (indexed @array) { |
| 216 |
\& ... |
| 217 |
\& } |
| 218 |
.Ve |
| 219 |
.IP "builtin::true, builtin::false, builtin::is_bool" 4 |
| 220 |
.IX Item "builtin::true, builtin::false, builtin::is_bool" |
| 221 |
\&\f(CW\*(C`true\*(C'\fR and \f(CW\*(C`false\*(C'\fR return boolean true and false values. Perl is still perl, |
| 222 |
and doesn't have strict typing of booleans, but these values will be known to |
| 223 |
have been created as booleans. \f(CW\*(C`is_bool\*(C'\fR will tell you whether a value was |
| 224 |
known to have been created as a boolean. |
| 225 |
.IP "builtin::weaken, builtin::unweaken, builtin::is_weak" 4 |
| 226 |
.IX Item "builtin::weaken, builtin::unweaken, builtin::is_weak" |
| 227 |
These functions will, respectively: weaken a reference; strengthen a reference; |
| 228 |
and return whether a reference is weak. (A weak reference is not counted for |
| 229 |
garbage collection purposes. See perlref.) These can take the place of |
| 230 |
some similar routines in Scalar::Util. |
| 231 |
.IP "builtin::blessed, builtin::refaddr, builtin::reftype" 4 |
| 232 |
.IX Item "builtin::blessed, builtin::refaddr, builtin::reftype" |
| 233 |
These functions provide more data about references (or non-references, |
| 234 |
actually!) and can take the place of similar routines found in Scalar::Util. |
| 235 |
.IP "builtin::ceil, builtin::floor" 4 |
| 236 |
.IX Item "builtin::ceil, builtin::floor" |
| 237 |
\&\f(CW\*(C`ceil\*(C'\fR returns the smallest integer greater than or equal to its argument. |
| 238 |
\&\f(CW\*(C`floor\*(C'\fR returns the largest integer less than or equal to its argument. These |
| 239 |
can take the place of similar routines found in POSIX. |
| 240 |
.ie n .SS """defer"" blocks (experimental)" |
| 241 |
.el .SS "\f(CWdefer\fP blocks (experimental)" |
| 242 |
.IX Subsection "defer blocks (experimental)" |
| 243 |
This release adds support for \f(CW\*(C`defer\*(C'\fR blocks, which are blocks of code |
| 244 |
prefixed by the \f(CW\*(C`defer\*(C'\fR modifier. They provide a section of code which runs |
| 245 |
at a later time, during scope exit. |
| 246 |
.PP |
| 247 |
In brief, when a \f(CW\*(C`defer\*(C'\fR block is reached at runtime, its body is set aside to |
| 248 |
be run when the enclosing scope is exited. It is unlike a UNITCHECK (among |
| 249 |
other reasons) in that if the block \fIcontaining\fR the \f(CW\*(C`defer\*(C'\fR block is exited |
| 250 |
before the block is reached, it will not be run. |
| 251 |
.PP |
| 252 |
\&\f(CW\*(C`defer\*(C'\fR blocks can be used to take the place of "scope guard" objects where an |
| 253 |
object is passed a code block to be run by its destructor. |
| 254 |
.PP |
| 255 |
For more information, see "defer blocks" in perlsyn. |
| 256 |
.ie n .SS "try/catch can now have a ""finally"" block (experimental)" |
| 257 |
.el .SS "try/catch can now have a \f(CWfinally\fP block (experimental)" |
| 258 |
.IX Subsection "try/catch can now have a finally block (experimental)" |
| 259 |
The experimental \f(CW\*(C`try\*(C'\fR/\f(CW\*(C`catch\*(C'\fR syntax has been extended to support an |
| 260 |
optional third block introduced by the \f(CW\*(C`finally\*(C'\fR keyword. |
| 261 |
.PP |
| 262 |
.Vb 10 |
| 263 |
\& try { |
| 264 |
\& attempt(); |
| 265 |
\& print "Success\en"; |
| 266 |
\& } |
| 267 |
\& catch ($e) { |
| 268 |
\& print "Failure\en"; |
| 269 |
\& } |
| 270 |
\& finally { |
| 271 |
\& print "This happens regardless\en"; |
| 272 |
\& } |
| 273 |
.Ve |
| 274 |
.PP |
| 275 |
This provides code which runs at the end of the \f(CW\*(C`try\*(C'\fR/\f(CW\*(C`catch\*(C'\fR construct, |
| 276 |
even if aborted by an exception or control-flow keyword. They are similar |
| 277 |
to \f(CW\*(C`defer\*(C'\fR blocks. |
| 278 |
.PP |
| 279 |
For more information, see "Try Catch Exception Handling" in perlsyn. |
| 280 |
.SS "non-ASCII delimiters for quote-like operators (experimental)" |
| 281 |
.IX Subsection "non-ASCII delimiters for quote-like operators (experimental)" |
| 282 |
Perl traditionally has allowed just four pairs of string/pattern |
| 283 |
delimiters: \f(CW\*(C`(\ )\*(C'\fR \f(CW\*(C`{\ }\*(C'\fR \f(CW\*(C`[\ ]\*(C'\fR and \f(CW\*(C`<\ >\*(C'\fR, all in the |
| 284 |
ASCII range. Unicode has hundreds more possibilities, and using this |
| 285 |
feature enables many of them. When enabled, you can say \f(CW\*(C`qr«\ »\*(C'\fR for |
| 286 |
example, or \f(CW\*(C`use\ utf8;\ q𝄃string𝄂\*(C'\fR. See "The |
| 287 |
\&'extra_paired_delimiters' feature" in feature for details. |
| 288 |
.ie n .SS "@_ is now experimental within signatured subs" |
| 289 |
.el .SS "\f(CW@_\fP is now experimental within signatured subs" |
| 290 |
.IX Subsection "@_ is now experimental within signatured subs" |
| 291 |
Even though subroutine signatures are now stable, use of the legacy arguments |
| 292 |
array (\f(CW@_\fR) with a subroutine that has a signature \fIremains\fR experimental, |
| 293 |
with its own warning category. Silencing the \f(CW\*(C`experimental::signatures\*(C'\fR |
| 294 |
warning category is not sufficient to dismiss this. The new warning is emitted |
| 295 |
with the category name \f(CW\*(C`experimental::args_array_with_signatures\*(C'\fR. |
| 296 |
.PP |
| 297 |
Any subroutine that has a signature and tries to make use of the defaults |
| 298 |
argument array or an element thereof (\f(CW@_\fR or \f(CW$_[INDEX]\fR), either |
| 299 |
explicitly or implicitly (such as \f(CW\*(C`shift\*(C'\fR or \f(CW\*(C`pop\*(C'\fR with no argument) will |
| 300 |
provoke a warning at compile-time: |
| 301 |
.PP |
| 302 |
.Vb 1 |
| 303 |
\& use v5.36; |
| 304 |
\& |
| 305 |
\& sub f ($x, $y = 123) { |
| 306 |
\& say "The first argument is $_[0]"; |
| 307 |
\& } |
| 308 |
.Ve |
| 309 |
.PP |
| 310 |
|
| 311 |
.PP |
| 312 |
.Vb 2 |
| 313 |
\& Use of @_ in array element with signatured subroutine is experimental |
| 314 |
\& at file.pl line 4. |
| 315 |
.Ve |
| 316 |
.PP |
| 317 |
The behaviour of code which attempts to do this is no longer specified, and |
| 318 |
may be subject to change in a future version. |
| 319 |
.SH "Incompatible Changes" |
| 320 |
.IX Header "Incompatible Changes" |
| 321 |
.SS "A physically empty sort is now a compile-time error" |
| 322 |
.IX Subsection "A physically empty sort is now a compile-time error" |
| 323 |
.Vb 3 |
| 324 |
\& @a = sort @empty; # unaffected |
| 325 |
\& @a = sort; # now a compile\-time error |
| 326 |
\& @a = sort (); # also a compile\-time error |
| 327 |
.Ve |
| 328 |
.PP |
| 329 |
A bare sort used to be a weird way to create an empty list; now it croaks |
| 330 |
at compile time. This change is intended to free up some of the syntax space |
| 331 |
for possible future enhancements to \f(CW\*(C`sort\*(C'\fR. |
| 332 |
.SH Deprecations |
| 333 |
.IX Header "Deprecations" |
| 334 |
.ie n .SS """use VERSION"" (where VERSION is below v5.11) after ""use v5.11"" is deprecated" |
| 335 |
.el .SS "\f(CWuse VERSION\fP (where VERSION is below v5.11) after \f(CWuse v5.11\fP is deprecated" |
| 336 |
.IX Subsection "use VERSION (where VERSION is below v5.11) after use v5.11 is deprecated" |
| 337 |
When in the scope of \f(CW\*(C`use v5.11\*(C'\fR or later, a \f(CW\*(C`use vX\*(C'\fR line where \fIX\fR is |
| 338 |
lower than v5.11 will now issue a warning: |
| 339 |
.PP |
| 340 |
.Vb 1 |
| 341 |
\& Downgrading a use VERSION declaration to below v5.11 is deprecated |
| 342 |
.Ve |
| 343 |
.PP |
| 344 |
For example: |
| 345 |
.PP |
| 346 |
.Vb 4 |
| 347 |
\& use v5.14; |
| 348 |
\& say "The say statement is permitted"; |
| 349 |
\& use v5.8; # This will print a warning |
| 350 |
\& print "We must use print\en"; |
| 351 |
.Ve |
| 352 |
.PP |
| 353 |
This is because the Perl team plans to change the behavior in this case. Since |
| 354 |
Perl v5.12 (and parts of v5.11), strict is enabled \fIunless it had previously |
| 355 |
been disabled\fR. In other words: |
| 356 |
.PP |
| 357 |
.Vb 3 |
| 358 |
\& no strict; |
| 359 |
\& use v5.12; # will not enable strict, because "no strict" preceded it |
| 360 |
\& $x = 1; # permitted, despite no "my" declaration |
| 361 |
.Ve |
| 362 |
.PP |
| 363 |
In the future, this behavior will be eliminated and \f(CW\*(C`use VERSION\*(C'\fR will |
| 364 |
\&\fIalways\fR enable strict for versions v5.12 and later. |
| 365 |
.PP |
| 366 |
Code which wishes to mix versions in this manner should use lexical scoping |
| 367 |
with block syntax to ensure that the differently versioned regions remain |
| 368 |
lexically isolated. |
| 369 |
.PP |
| 370 |
.Vb 4 |
| 371 |
\& { |
| 372 |
\& use v5.14; |
| 373 |
\& say "The say statement is permitted"; |
| 374 |
\& } |
| 375 |
\& |
| 376 |
\& { |
| 377 |
\& use v5.8; # No warning is emitted |
| 378 |
\& print "We must use print\en"; |
| 379 |
\& } |
| 380 |
.Ve |
| 381 |
.PP |
| 382 |
Of course, this is probably not something you ever need to do! If the first |
| 383 |
block compiles, it means you're using perl v5.14.0 or later. |
| 384 |
.SH "Performance Enhancements" |
| 385 |
.IX Header "Performance Enhancements" |
| 386 |
.IP \(bu 4 |
| 387 |
We now probe for compiler support for C11 thread local storage, and where |
| 388 |
available use this for "implicit context" for XS extensions making API calls for |
| 389 |
a threaded Perl build. This requires fewer function calls at the C level than |
| 390 |
POSIX thread specific storage. We continue to use the pthreads approach if |
| 391 |
the C11 approach is not available. |
| 392 |
.Sp |
| 393 |
\&\fIConfigure\fR run with the defaults will build an unthreaded Perl (which is |
| 394 |
slightly faster), but most operating systems ship a threaded Perl. |
| 395 |
.IP \(bu 4 |
| 396 |
Perl can now be configured to no longer allocate keys for large hashes |
| 397 |
from the shared string table. |
| 398 |
.Sp |
| 399 |
The same internal datatype (\f(CW\*(C`PVHV\*(C'\fR) is used for all of |
| 400 |
.RS 4 |
| 401 |
.IP \(bu 4 |
| 402 |
Symbol tables |
| 403 |
.IP \(bu 4 |
| 404 |
Objects (by default) |
| 405 |
.IP \(bu 4 |
| 406 |
Associative arrays |
| 407 |
.RE |
| 408 |
.RS 4 |
| 409 |
.Sp |
| 410 |
The shared string table was originally added to improve performance for blessed |
| 411 |
hashes used as objects, because every object instance has the same keys, so it |
| 412 |
is an optimisation to share memory between them. It also makes sense for symbol |
| 413 |
tables, where derived classes will have the same keys (typically method names), |
| 414 |
and the OP trees built for method calls can also share memory. The shared |
| 415 |
string table behaves roughly like a cache for hash keys. |
| 416 |
.Sp |
| 417 |
But for hashes actually used as associative arrays \- mapping keys to values \- |
| 418 |
typically the keys are not re-used in other hashes. For example, "seen" hashes |
| 419 |
are keyed by object IDs (or addresses), and logically these keys won't repeat |
| 420 |
in other hashes. |
| 421 |
.Sp |
| 422 |
Storing these "used just once" keys in the shared string table increases CPU |
| 423 |
and RAM use for no gain. For such keys the shared string table behaves as a |
| 424 |
cache with a 0% hit rate. Storing all the keys there increases the total size |
| 425 |
of the shared string table, as well as increasing the number of times it is |
| 426 |
resized as it grows. \fBWorse\fR \- in any environment that has "copy on write" |
| 427 |
memory for child process (such as a pre-forking server), the memory pages used |
| 428 |
for the shared string table rapidly need to be copied as the child process |
| 429 |
manipulates hashes. Hence if most of the shared string table is such that keys |
| 430 |
are used only in one place, there is no benefit from re-use within the perl |
| 431 |
interpreter, but a high cost due to more pages for the OS to copy. |
| 432 |
.Sp |
| 433 |
The perl interpreter can now be Configured to disable shared hash keys |
| 434 |
for "large" hashes (that are neither objects nor symbol tables). To do |
| 435 |
so, add \f(CW\*(C`\-Accflags=\*(Aq\-DPERL_USE_UNSHARED_KEYS_IN_LARGE_HASHES\*(Aq\*(C'\fR to |
| 436 |
your \fIConfigure\fR options. "Large" is a heuristic \-\- currently the |
| 437 |
heuristic is that sharing is disabled when adding a key to a hash |
| 438 |
triggers allocation of more storage, and the hash has more than 42 keys. |
| 439 |
.Sp |
| 440 |
This \fBmight\fR cause slightly increased memory usage for programs that create |
| 441 |
(unblessed) data structures that contain multiple large hashes that share the |
| 442 |
same keys. But generally our testing suggests that for the specific cases |
| 443 |
described it is a win, and other code is unaffected. |
| 444 |
.RE |
| 445 |
.IP \(bu 4 |
| 446 |
In certain scenarios, creation of new scalars is now noticeably faster. |
| 447 |
.Sp |
| 448 |
For example, the following code is now executing ~30% faster: |
| 449 |
.Sp |
| 450 |
.Vb 4 |
| 451 |
\& $str = "A" x 64; |
| 452 |
\& for (0..1_000_000) { |
| 453 |
\& @svs = split //, $str |
| 454 |
\& } |
| 455 |
.Ve |
| 456 |
.Sp |
| 457 |
(You can read more about this one in [perl |
| 458 |
#19414] <https://github.com/Perl/perl5/pull/19414>.) |
| 459 |
.SH "Modules and Pragmata" |
| 460 |
.IX Header "Modules and Pragmata" |
| 461 |
.SS "Updated Modules and Pragmata" |
| 462 |
.IX Subsection "Updated Modules and Pragmata" |
| 463 |
.IP \(bu 4 |
| 464 |
Archive::Tar has been upgraded from version 2.38 to 2.40. |
| 465 |
.IP \(bu 4 |
| 466 |
Attribute::Handlers has been upgraded from version 1.01 to 1.02. |
| 467 |
.IP \(bu 4 |
| 468 |
attributes has been upgraded from version 0.33 to 0.34. |
| 469 |
.IP \(bu 4 |
| 470 |
B has been upgraded from version 1.82 to 1.83. |
| 471 |
.IP \(bu 4 |
| 472 |
B::Concise has been upgraded from version 1.004 to 1.006. |
| 473 |
.IP \(bu 4 |
| 474 |
B::Deparse has been upgraded from version 1.56 to 1.64. |
| 475 |
.IP \(bu 4 |
| 476 |
bignum has been upgraded from version 0.51 to 0.65. |
| 477 |
.IP \(bu 4 |
| 478 |
charnames has been upgraded from version 1.48 to 1.50. |
| 479 |
.IP \(bu 4 |
| 480 |
Compress::Raw::Bzip2 has been upgraded from version 2.101 to 2.103. |
| 481 |
.IP \(bu 4 |
| 482 |
Compress::Raw::Zlib has been upgraded from version 2.101 to 2.105. |
| 483 |
.IP \(bu 4 |
| 484 |
CPAN has been upgraded from version 2.28 to 2.33. |
| 485 |
.IP \(bu 4 |
| 486 |
Data::Dumper has been upgraded from version 2.179 to 2.184. |
| 487 |
.IP \(bu 4 |
| 488 |
DB_File has been upgraded from version 1.855 to 1.857. |
| 489 |
.IP \(bu 4 |
| 490 |
Devel::Peek has been upgraded from version 1.30 to 1.32. |
| 491 |
.IP \(bu 4 |
| 492 |
Devel::PPPort has been upgraded from version 3.62 to 3.68. |
| 493 |
.IP \(bu 4 |
| 494 |
diagnostics has been upgraded from version 1.37 to 1.39. |
| 495 |
.IP \(bu 4 |
| 496 |
Digest has been upgraded from version 1.19 to 1.20. |
| 497 |
.IP \(bu 4 |
| 498 |
DynaLoader has been upgraded from version 1.50 to 1.52. |
| 499 |
.IP \(bu 4 |
| 500 |
Encode has been upgraded from version 3.08 to 3.17. |
| 501 |
.IP \(bu 4 |
| 502 |
Errno has been upgraded from version 1.33 to 1.36. |
| 503 |
.IP \(bu 4 |
| 504 |
experimental has been upgraded from version 0.024 to 0.028. |
| 505 |
.IP \(bu 4 |
| 506 |
Exporter has been upgraded from version 5.76 to 5.77. |
| 507 |
.IP \(bu 4 |
| 508 |
ExtUtils::MakeMaker has been upgraded from version 7.62 to 7.64. |
| 509 |
.IP \(bu 4 |
| 510 |
ExtUtils::Miniperl has been upgraded from version 1.10 to 1.11. |
| 511 |
.IP \(bu 4 |
| 512 |
ExtUtils::ParseXS has been upgraded from version 3.43 to 3.45. |
| 513 |
.IP \(bu 4 |
| 514 |
ExtUtils::Typemaps has been upgraded from version 3.43 to 3.45. |
| 515 |
.IP \(bu 4 |
| 516 |
Fcntl has been upgraded from version 1.14 to 1.15. |
| 517 |
.IP \(bu 4 |
| 518 |
feature has been upgraded from version 1.64 to 1.72. |
| 519 |
.IP \(bu 4 |
| 520 |
File::Compare has been upgraded from version 1.1006 to 1.1007. |
| 521 |
.IP \(bu 4 |
| 522 |
File::Copy has been upgraded from version 2.35 to 2.39. |
| 523 |
.IP \(bu 4 |
| 524 |
File::Fetch has been upgraded from version 1.00 to 1.04. |
| 525 |
.IP \(bu 4 |
| 526 |
File::Find has been upgraded from version 1.39 to 1.40. |
| 527 |
.IP \(bu 4 |
| 528 |
File::Glob has been upgraded from version 1.33 to 1.37. |
| 529 |
.IP \(bu 4 |
| 530 |
File::Spec has been upgraded from version 3.80 to 3.84. |
| 531 |
.IP \(bu 4 |
| 532 |
File::stat has been upgraded from version 1.09 to 1.12. |
| 533 |
.IP \(bu 4 |
| 534 |
FindBin has been upgraded from version 1.52 to 1.53. |
| 535 |
.IP \(bu 4 |
| 536 |
GDBM_File has been upgraded from version 1.19 to 1.23. |
| 537 |
.IP \(bu 4 |
| 538 |
Hash::Util has been upgraded from version 0.25 to 0.28. |
| 539 |
.IP \(bu 4 |
| 540 |
Hash::Util::FieldHash has been upgraded from version 1.21 to 1.26. |
| 541 |
.IP \(bu 4 |
| 542 |
HTTP::Tiny has been upgraded from version 0.076 to 0.080. |
| 543 |
.IP \(bu 4 |
| 544 |
I18N::Langinfo has been upgraded from version 0.19 to 0.21. |
| 545 |
.IP \(bu 4 |
| 546 |
if has been upgraded from version 0.0609 to 0.0610. |
| 547 |
.IP \(bu 4 |
| 548 |
IO has been upgraded from version 1.46 to 1.50. |
| 549 |
.IP \(bu 4 |
| 550 |
IO-Compress has been upgraded from version 2.102 to 2.106. |
| 551 |
.IP \(bu 4 |
| 552 |
IPC::Open3 has been upgraded from version 1.21 to 1.22. |
| 553 |
.IP \(bu 4 |
| 554 |
JSON::PP has been upgraded from version 4.06 to 4.07. |
| 555 |
.IP \(bu 4 |
| 556 |
libnet has been upgraded from version 3.13 to 3.14. |
| 557 |
.IP \(bu 4 |
| 558 |
Locale::Maketext has been upgraded from version 1.29 to 1.31. |
| 559 |
.IP \(bu 4 |
| 560 |
Math::BigInt has been upgraded from version 1.999818 to 1.999830. |
| 561 |
.IP \(bu 4 |
| 562 |
Math::BigInt::FastCalc has been upgraded from version 0.5009 to 0.5012. |
| 563 |
.IP \(bu 4 |
| 564 |
Math::BigRat has been upgraded from version 0.2614 to 0.2621. |
| 565 |
.IP \(bu 4 |
| 566 |
Module::CoreList has been upgraded from version 5.20210520 to 5.20220520. |
| 567 |
.IP \(bu 4 |
| 568 |
mro has been upgraded from version 1.25_001 to 1.26. |
| 569 |
.IP \(bu 4 |
| 570 |
NEXT has been upgraded from version 0.68 to 0.69. |
| 571 |
.IP \(bu 4 |
| 572 |
Opcode has been upgraded from version 1.50 to 1.57. |
| 573 |
.IP \(bu 4 |
| 574 |
open has been upgraded from version 1.12 to 1.13. |
| 575 |
.IP \(bu 4 |
| 576 |
overload has been upgraded from version 1.33 to 1.35. |
| 577 |
.IP \(bu 4 |
| 578 |
perlfaq has been upgraded from version 5.20210411 to 5.20210520. |
| 579 |
.IP \(bu 4 |
| 580 |
PerlIO has been upgraded from version 1.11 to 1.12. |
| 581 |
.IP \(bu 4 |
| 582 |
Pod::Functions has been upgraded from version 1.13 to 1.14. |
| 583 |
.IP \(bu 4 |
| 584 |
Pod::Html has been upgraded from version 1.27 to 1.33. |
| 585 |
.IP \(bu 4 |
| 586 |
Pod::Simple has been upgraded from version 3.42 to 3.43. |
| 587 |
.IP \(bu 4 |
| 588 |
POSIX has been upgraded from version 1.97 to 2.03. |
| 589 |
.IP \(bu 4 |
| 590 |
re has been upgraded from version 0.41 to 0.43. |
| 591 |
.IP \(bu 4 |
| 592 |
Scalar::Util has been upgraded from version 1.55 to 1.62. |
| 593 |
.IP \(bu 4 |
| 594 |
sigtrap has been upgraded from version 1.09 to 1.10. |
| 595 |
.IP \(bu 4 |
| 596 |
Socket has been upgraded from version 2.031 to 2.033. |
| 597 |
.IP \(bu 4 |
| 598 |
sort has been upgraded from version 2.04 to 2.05. |
| 599 |
.IP \(bu 4 |
| 600 |
Storable has been upgraded from version 3.23 to 3.26. |
| 601 |
.IP \(bu 4 |
| 602 |
Sys::Hostname has been upgraded from version 1.23 to 1.24. |
| 603 |
.IP \(bu 4 |
| 604 |
Test::Harness has been upgraded from version 3.43 to 3.44. |
| 605 |
.IP \(bu 4 |
| 606 |
Test::Simple has been upgraded from version 1.302183 to 1.302190. |
| 607 |
.IP \(bu 4 |
| 608 |
Text::ParseWords has been upgraded from version 3.30 to 3.31. |
| 609 |
.IP \(bu 4 |
| 610 |
Text::Tabs has been upgraded from version 2013.0523 to 2021.0814. |
| 611 |
.IP \(bu 4 |
| 612 |
Text::Wrap has been upgraded from version 2013.0523 to 2021.0814. |
| 613 |
.IP \(bu 4 |
| 614 |
threads has been upgraded from version 2.26 to 2.27. |
| 615 |
.IP \(bu 4 |
| 616 |
threads::shared has been upgraded from version 1.62 to 1.64. |
| 617 |
.IP \(bu 4 |
| 618 |
Tie::Handle has been upgraded from version 4.2 to 4.3. |
| 619 |
.IP \(bu 4 |
| 620 |
Tie::Hash has been upgraded from version 1.05 to 1.06. |
| 621 |
.IP \(bu 4 |
| 622 |
Tie::Scalar has been upgraded from version 1.05 to 1.06. |
| 623 |
.IP \(bu 4 |
| 624 |
Tie::SubstrHash has been upgraded from version 1.00 to 1.01. |
| 625 |
.IP \(bu 4 |
| 626 |
Time::HiRes has been upgraded from version 1.9767 to 1.9770. |
| 627 |
.IP \(bu 4 |
| 628 |
Unicode::Collate has been upgraded from version 1.29 to 1.31. |
| 629 |
.IP \(bu 4 |
| 630 |
Unicode::Normalize has been upgraded from version 1.28 to 1.31. |
| 631 |
.IP \(bu 4 |
| 632 |
Unicode::UCD has been upgraded from version 0.75 to 0.78. |
| 633 |
.IP \(bu 4 |
| 634 |
UNIVERSAL has been upgraded from version 1.13 to 1.14. |
| 635 |
.IP \(bu 4 |
| 636 |
version has been upgraded from version 0.9928 to 0.9929. |
| 637 |
.IP \(bu 4 |
| 638 |
VMS::Filespec has been upgraded from version 1.12 to 1.13. |
| 639 |
.IP \(bu 4 |
| 640 |
VMS::Stdio has been upgraded from version 2.45 to 2.46. |
| 641 |
.IP \(bu 4 |
| 642 |
warnings has been upgraded from version 1.51 to 1.58. |
| 643 |
.IP \(bu 4 |
| 644 |
Win32 has been upgraded from version 0.57 to 0.59. |
| 645 |
.IP \(bu 4 |
| 646 |
XS::APItest has been upgraded from version 1.16 to 1.22. |
| 647 |
.IP \(bu 4 |
| 648 |
XS::Typemap has been upgraded from version 0.18 to 0.19. |
| 649 |
.IP \(bu 4 |
| 650 |
XSLoader has been upgraded from version 0.30 to 0.31. |
| 651 |
.SH Documentation |
| 652 |
.IX Header "Documentation" |
| 653 |
.SS "New Documentation" |
| 654 |
.IX Subsection "New Documentation" |
| 655 |
\fIPorting/vote_admin_guide.pod\fR |
| 656 |
.IX Subsection "Porting/vote_admin_guide.pod" |
| 657 |
.PP |
| 658 |
This document provides the process for administering an election or vote |
| 659 |
within the Perl Core Team. |
| 660 |
.SS "Changes to Existing Documentation" |
| 661 |
.IX Subsection "Changes to Existing Documentation" |
| 662 |
We have attempted to update the documentation to reflect the changes |
| 663 |
listed in this document. If you find any we have missed, open an issue |
| 664 |
at <https://github.com/Perl/perl5/issues>. |
| 665 |
.PP |
| 666 |
Additionally, the following selected changes have been made: |
| 667 |
.PP |
| 668 |
\fIperlapi\fR |
| 669 |
.IX Subsection "perlapi" |
| 670 |
.IP \(bu 4 |
| 671 |
This has been cleaned up some, and more than 80% of the (previously |
| 672 |
many) undocumented functions have now either been documented or deemed |
| 673 |
to have been inappropriately marked as API. |
| 674 |
.Sp |
| 675 |
As always, Patches Welcome! |
| 676 |
.PP |
| 677 |
\fIperldeprecation\fR |
| 678 |
.IX Subsection "perldeprecation" |
| 679 |
.IP \(bu 4 |
| 680 |
notes the new location for functions moved from Pod::Html to |
| 681 |
Pod::Html::Util that are no longer intended to be used outside of core. |
| 682 |
.PP |
| 683 |
\fIperlexperiment\fR |
| 684 |
.IX Subsection "perlexperiment" |
| 685 |
.IP \(bu 4 |
| 686 |
notes the \f(CW\*(C`:win32\*(C'\fR IO pseudolayer is removed (this happened in 5.35.2). |
| 687 |
.PP |
| 688 |
\fIperlgov\fR |
| 689 |
.IX Subsection "perlgov" |
| 690 |
.IP \(bu 4 |
| 691 |
The election process has been finetuned to allow the vote to be skipped if there |
| 692 |
are no more candidates than open seats. |
| 693 |
.IP \(bu 4 |
| 694 |
A special election is now allowed to be postponed for up to twelve weeks, for |
| 695 |
example until a normal election. |
| 696 |
.PP |
| 697 |
\fIperlop\fR |
| 698 |
.IX Subsection "perlop" |
| 699 |
.IP \(bu 4 |
| 700 |
now notes that an invocant only needs to be an object or class name |
| 701 |
for method calls, not for subroutine references. |
| 702 |
.PP |
| 703 |
\fIperlre\fR |
| 704 |
.IX Subsection "perlre" |
| 705 |
.IP \(bu 4 |
| 706 |
Updated to discourage the use of the /d regexp modifier. |
| 707 |
.PP |
| 708 |
\fIperlrun\fR |
| 709 |
.IX Subsection "perlrun" |
| 710 |
.IP \(bu 4 |
| 711 |
\&\fB\-?\fR is now a synonym for \fB\-h\fR |
| 712 |
.IP \(bu 4 |
| 713 |
\&\fB\-g\fR is now a synonym for \fB\-0777\fR |
| 714 |
.SH Diagnostics |
| 715 |
.IX Header "Diagnostics" |
| 716 |
The following additions or changes have been made to diagnostic output, |
| 717 |
including warnings and fatal error messages. For the complete list of |
| 718 |
diagnostic messages, see perldiag. |
| 719 |
.SS "New Diagnostics" |
| 720 |
.IX Subsection "New Diagnostics" |
| 721 |
\fINew Errors\fR |
| 722 |
.IX Subsection "New Errors" |
| 723 |
.IP \(bu 4 |
| 724 |
Can't "%s" out of a "defer" block |
| 725 |
.Sp |
| 726 |
(F) An attempt was made to jump out of the scope of a defer block by using |
| 727 |
a control-flow statement such as \f(CW\*(C`return\*(C'\fR, \f(CW\*(C`goto\*(C'\fR or a loop control. This is |
| 728 |
not permitted. |
| 729 |
.IP \(bu 4 |
| 730 |
Can't modify \f(CW%s\fR in \f(CW%s\fR (for scalar |
| 731 |
assignment to \f(CW\*(C`undef\*(C'\fR) |
| 732 |
.Sp |
| 733 |
Attempting to perform a scalar assignment to \f(CW\*(C`undef\*(C'\fR, for example via |
| 734 |
\&\f(CW\*(C`undef = $foo;\*(C'\fR, previously triggered a fatal runtime error with the |
| 735 |
message "Modification of a read-only value attempted." |
| 736 |
It is more helpful to detect such attempted assignments prior to runtime, so |
| 737 |
they are now compile time errors, resulting in the message "Can't modify undef |
| 738 |
operator in scalar assignment". |
| 739 |
.IP \(bu 4 |
| 740 |
panic: newFORLOOP, \f(CW%s\fR |
| 741 |
.Sp |
| 742 |
The parser failed an internal consistency check while trying to parse |
| 743 |
a \f(CW\*(C`foreach\*(C'\fR loop. |
| 744 |
.PP |
| 745 |
\fINew Warnings\fR |
| 746 |
.IX Subsection "New Warnings" |
| 747 |
.IP \(bu 4 |
| 748 |
Built-in function '%s' is experimental |
| 749 |
.Sp |
| 750 |
A call is being made to a function in the \f(CW\*(C`builtin::\*(C'\fR namespace, which is |
| 751 |
currently experimental. |
| 752 |
.IP \(bu 4 |
| 753 |
defer is experimental |
| 754 |
.Sp |
| 755 |
The \f(CW\*(C`defer\*(C'\fR block modifier is experimental. If you want to use the feature, |
| 756 |
disable the warning with \f(CW\*(C`no warnings \*(Aqexperimental::defer\*(Aq\*(C'\fR, but know that in |
| 757 |
doing so you are taking the risk that your code may break in a future Perl |
| 758 |
version. |
| 759 |
.IP \(bu 4 |
| 760 |
Downgrading a use VERSION declaration to below v5.11 is deprecated |
| 761 |
.Sp |
| 762 |
This warning is emitted on a \f(CW\*(C`use VERSION\*(C'\fR statement that |
| 763 |
requests a version below v5.11 (when the effects of \f(CW\*(C`use strict\*(C'\fR would be |
| 764 |
disabled), after a previous declaration of one having a larger number (which |
| 765 |
would have enabled these effects) |
| 766 |
.IP \(bu 4 |
| 767 |
for my (...) is experimental |
| 768 |
.Sp |
| 769 |
This warning is emitted if you use \f(CW\*(C`for\*(C'\fR to iterate multiple values at |
| 770 |
a time. This syntax is currently experimental and its behaviour may |
| 771 |
change in future releases of Perl. |
| 772 |
.IP \(bu 4 |
| 773 |
Implicit use of \f(CW@_\fR in \f(CW%s\fR with signatured subroutine is experimental |
| 774 |
.Sp |
| 775 |
An expression that implicitly involves the \f(CW@_\fR arguments array was found in |
| 776 |
a subroutine that uses a signature. |
| 777 |
.IP \(bu 4 |
| 778 |
Use of \f(CW@_\fR in \f(CW%s\fR with signatured subroutine is experimental |
| 779 |
.Sp |
| 780 |
An expression involving the \f(CW@_\fR arguments array was found in a subroutine that uses a signature. |
| 781 |
.IP \(bu 4 |
| 782 |
Wide character in \f(CW$0\fR |
| 783 |
.Sp |
| 784 |
Attempts to put wide characters into the program name (\f(CW$0\fR) now provoke this |
| 785 |
warning. |
| 786 |
.SS "Changes to Existing Diagnostics" |
| 787 |
.IX Subsection "Changes to Existing Diagnostics" |
| 788 |
.IP \(bu 4 |
| 789 |
\&'/' does not take a repeat count in \f(CW%s\fR |
| 790 |
.Sp |
| 791 |
This warning used to not include the \f(CW\*(C`in %s\*(C'\fR. |
| 792 |
.IP \(bu 4 |
| 793 |
Subroutine \f(CW%s\fR redefined |
| 794 |
.Sp |
| 795 |
Localized subroutine redefinitions no longer trigger this warning. |
| 796 |
.IP \(bu 4 |
| 797 |
unexpected constant lvalue entersub entry via type/targ \f(CW%d:\fR%d" now has a panic prefix |
| 798 |
.Sp |
| 799 |
This makes it consistent with other checks of internal consistency when |
| 800 |
compiling a subroutine. |
| 801 |
.IP \(bu 4 |
| 802 |
Useless use of sort in scalar context is now in the new \f(CW\*(C`scalar\*(C'\fR category. |
| 803 |
.Sp |
| 804 |
When \f(CW\*(C`sort\*(C'\fR is used in scalar context, it provokes a warning that doing this |
| 805 |
is not useful. This warning used to be in the \f(CW\*(C`void\*(C'\fR category. A new category |
| 806 |
for warnings about scalar context has now been added, called \f(CW\*(C`scalar\*(C'\fR. |
| 807 |
.IP \(bu 4 |
| 808 |
Removed a number of diagnostics |
| 809 |
.Sp |
| 810 |
Many diagnostics that have been removed from the perl core across many years |
| 811 |
have now \fIalso\fR been removed from the documentation. |
| 812 |
.SH "Configuration and Compilation" |
| 813 |
.IX Header "Configuration and Compilation" |
| 814 |
.IP \(bu 4 |
| 815 |
The Perl C source code now uses some C99 features, which we have verified are |
| 816 |
supported by all compilers we target. This means that Perl's headers now |
| 817 |
contain some code that is legal in C99 but not C89. |
| 818 |
.Sp |
| 819 |
This may cause problems for some XS modules that unconditionally add |
| 820 |
\&\f(CW\*(C`\-Werror=declaration\-after\-statement\*(C'\fR to their C compiler flags if compiling |
| 821 |
with gcc or clang. Earlier versions of Perl support long obsolete compilers |
| 822 |
that are strict in rejecting certain C99 features, particularly mixed |
| 823 |
declarations and code, and hence it makes sense for XS module authors to audit |
| 824 |
that their code does not violate this. However, doing this is now only |
| 825 |
possible on these earlier versions of Perl, hence these modules need to be |
| 826 |
changed to only add this flag for \f(CW\*(C`$] < 5.035005\*(C'\fR. |
| 827 |
.IP \(bu 4 |
| 828 |
The makedepend step is now run in parallel by using make |
| 829 |
.Sp |
| 830 |
When using MAKEFLAGS=\-j8, this significantly reduces the time required for: |
| 831 |
.Sp |
| 832 |
.Vb 1 |
| 833 |
\& sh ./makedepend MAKE=make cflags |
| 834 |
.Ve |
| 835 |
.IP \(bu 4 |
| 836 |
\&\fIConfigure\fR now tests whether \f(CW\*(C`#include <xlocale.h>\*(C'\fR is required |
| 837 |
to use the POSIX 1003 thread-safe locale functions or some related |
| 838 |
extensions. This prevents problems where a non-public \fIxlocale.h\fR is |
| 839 |
removed in a library update, or \fIxlocale.h\fR isn't intended for public |
| 840 |
use. (github #18936 <https://github.com/Perl/perl5/pull/18936>) |
| 841 |
.SH Testing |
| 842 |
.IX Header "Testing" |
| 843 |
Tests were added and changed to reflect the other additions and changes |
| 844 |
in this release. |
| 845 |
.SH "Platform Support" |
| 846 |
.IX Header "Platform Support" |
| 847 |
.SS Windows |
| 848 |
.IX Subsection "Windows" |
| 849 |
.IP \(bu 4 |
| 850 |
Support for old MSVC++ (pre\-VC12) has been removed |
| 851 |
.Sp |
| 852 |
These did not support C99 and hence can no longer be used to compile perl. |
| 853 |
.IP \(bu 4 |
| 854 |
Support for compiling perl on Windows using Microsoft Visual Studio 2022 |
| 855 |
(containing Visual C++ 14.3) has been added. |
| 856 |
.IP \(bu 4 |
| 857 |
The :win32 IO layer has been removed. This experimental replacement for the |
| 858 |
:unix layer never reached maturity in its nearly two decades of existence. |
| 859 |
.SS VMS |
| 860 |
.IX Subsection "VMS" |
| 861 |
.ie n .IP """keys %ENV"" on VMS returns consistent results" 4 |
| 862 |
.el .IP "\f(CWkeys %ENV\fR on VMS returns consistent results" 4 |
| 863 |
.IX Item "keys %ENV on VMS returns consistent results" |
| 864 |
On VMS entries in the \f(CW%ENV\fR hash are loaded from the OS environment on |
| 865 |
first access, hence the first iteration of \f(CW%ENV\fR requires the entire |
| 866 |
environment to be scanned to find all possible keys. This initialisation had |
| 867 |
always been done correctly for full iteration, but previously was not |
| 868 |
happening for \f(CW%ENV\fR in scalar context, meaning that \f(CW\*(C`scalar %ENV\*(C'\fR would |
| 869 |
return 0 if called before any other \f(CW%ENV\fR access, or would only return the |
| 870 |
count of keys accessed if there had been no iteration. |
| 871 |
.Sp |
| 872 |
These bugs are now fixed \- \f(CW%ENV\fR and \f(CW\*(C`keys %ENV\*(C'\fR in scalar context now |
| 873 |
return the correct result \- the count of all keys in the environment. |
| 874 |
.SS "Discontinued Platforms" |
| 875 |
.IX Subsection "Discontinued Platforms" |
| 876 |
.IP "AT&T UWIN" 4 |
| 877 |
.IX Item "AT&T UWIN" |
| 878 |
UWIN is a UNIX compatibility layer for Windows. It was last released |
| 879 |
in 2012 and has been superseded by Cygwin these days. |
| 880 |
.IP DOS/DJGPP 4 |
| 881 |
.IX Item "DOS/DJGPP" |
| 882 |
DJGPP is a port of the GNU toolchain to 32\-bit x86 systems running |
| 883 |
DOS. The last known attempt to build Perl on it was on 5.20, which |
| 884 |
only got as far as building miniperl. |
| 885 |
.IP NetWare 4 |
| 886 |
.IX Item "NetWare" |
| 887 |
Support code for Novell NetWare has been removed. NetWare was a |
| 888 |
server operating system by Novell. The port was last updated in July |
| 889 |
2002, and the platform itself in May 2009. |
| 890 |
.Sp |
| 891 |
Unrelated changes accidentally broke the build for the NetWare port in |
| 892 |
September 2009, and in 12 years no-one has reported this. |
| 893 |
.SS "Platform-Specific Notes" |
| 894 |
.IX Subsection "Platform-Specific Notes" |
| 895 |
.IP z/OS 4 |
| 896 |
.IX Item "z/OS" |
| 897 |
This update enables us to build EBCDIC static/dynamic and 31\-bit/64\-bit |
| 898 |
addressing mode Perl. The number of tests that pass is consistent with the |
| 899 |
baseline before these updates. |
| 900 |
.Sp |
| 901 |
These changes also provide the base support to be able to provide ASCII |
| 902 |
static/dynamic and 31\-bit/64\-bit addressing mode Perl. |
| 903 |
.Sp |
| 904 |
The z/OS (previously called OS/390) README was updated to describe ASCII and |
| 905 |
EBCDIC builds. |
| 906 |
.SH "Internal Changes" |
| 907 |
.IX Header "Internal Changes" |
| 908 |
.IP \(bu 4 |
| 909 |
Since the removal of PERL_OBJECT in Perl 5.8, PERL_IMPLICIT_CONTEXT and |
| 910 |
MULTIPLICITY have been synonymous and they were being used interchangeably. |
| 911 |
To simplify the code, all instances of PERL_IMPLICIT_CONTEXT have been |
| 912 |
replaced with MULTIPLICITY. |
| 913 |
.Sp |
| 914 |
PERL_IMPLICIT_CONTEXT will remain defined for compatibility with XS modules. |
| 915 |
.IP \(bu 4 |
| 916 |
The API constant formerly named \f(CW\*(C`G_ARRAY\*(C'\fR, indicating list context, has now |
| 917 |
been renamed to a more accurate \f(CW\*(C`G_LIST\*(C'\fR. A compatibilty macro \f(CW\*(C`G_ARRAY\*(C'\fR has |
| 918 |
been added to allow existing code to work unaffected. New code should be |
| 919 |
written using the new constant instead. This is supported by \f(CW\*(C`Devel::PPPort\*(C'\fR |
| 920 |
version 3.63. |
| 921 |
.IP \(bu 4 |
| 922 |
Macros have been added to \fIperl.h\fR to facilitate version comparisons: |
| 923 |
\&\f(CW\*(C`PERL_GCC_VERSION_GE\*(C'\fR, \f(CW\*(C`PERL_GCC_VERSION_GT\*(C'\fR, \f(CW\*(C`PERL_GCC_VERSION_LE\*(C'\fR and |
| 924 |
\&\f(CW\*(C`PERL_GCC_VERSION_LT\*(C'\fR. |
| 925 |
.Sp |
| 926 |
Inline functions have been added to \fIembed.h\fR to determine the position of |
| 927 |
the least significant 1 bit in a word: \f(CW\*(C`lsbit_pos32\*(C'\fR and \f(CW\*(C`lsbit_pos64\*(C'\fR. |
| 928 |
.IP \(bu 4 |
| 929 |
\&\f(CW\*(C`Perl_ptr_table_clear\*(C'\fR has been deleted. This has been marked as deprecated |
| 930 |
since v5.14.0 (released in 2011), and is not used by any code on CPAN. |
| 931 |
.IP \(bu 4 |
| 932 |
Added new boolean macros and functions. See "Stable boolean tracking" for |
| 933 |
related information and perlapi for documentation. |
| 934 |
.RS 4 |
| 935 |
.IP \(bu 4 |
| 936 |
sv_setbool |
| 937 |
.IP \(bu 4 |
| 938 |
sv_setbool_mg |
| 939 |
.IP \(bu 4 |
| 940 |
SvIsBOOL |
| 941 |
.RE |
| 942 |
.RS 4 |
| 943 |
.RE |
| 944 |
.IP \(bu 4 |
| 945 |
Added 4 missing functions for dealing with RVs: |
| 946 |
.RS 4 |
| 947 |
.IP \(bu 4 |
| 948 |
sv_setrv_noinc |
| 949 |
.IP \(bu 4 |
| 950 |
sv_setrv_noinc_mg |
| 951 |
.IP \(bu 4 |
| 952 |
sv_setrv_inc |
| 953 |
.IP \(bu 4 |
| 954 |
sv_setrv_inc_mg |
| 955 |
.RE |
| 956 |
.RS 4 |
| 957 |
.RE |
| 958 |
.IP \(bu 4 |
| 959 |
\&\f(CWxs_handshake()\fR's two failure modes now provide distinct messages. |
| 960 |
.IP \(bu 4 |
| 961 |
Memory for hash iterator state (\f(CW\*(C`struct xpvhv_aux\*(C'\fR) is now allocated as part |
| 962 |
of the hash body, instead of as part of the block of memory allocated for the |
| 963 |
main hash array. |
| 964 |
.IP \(bu 4 |
| 965 |
A new \fBphase_name()\fR interface provides access to the name for each interpreter |
| 966 |
phase (i.e., PL_phase value). |
| 967 |
.IP \(bu 4 |
| 968 |
The \f(CW\*(C`pack\*(C'\fR behavior of \f(CW\*(C`U\*(C'\fR has changed for EBCDIC. |
| 969 |
.IP \(bu 4 |
| 970 |
New equality-test functions \f(CW\*(C`sv_numeq\*(C'\fR and \f(CW\*(C`sv_streq\*(C'\fR have been added, along |
| 971 |
with \f(CW\*(C`..._flags\*(C'\fR\-suffixed variants. These expose a simple and consistent API |
| 972 |
to perform numerical or string comparison which is aware of operator |
| 973 |
overloading. |
| 974 |
.IP \(bu 4 |
| 975 |
Reading the string form of an integer value no longer sets the flag \f(CW\*(C`SVf_POK\*(C'\fR. |
| 976 |
The string form is still cached internally, and still re-read directly by the |
| 977 |
macros \f(CWSvPV(sv)\fR \fIetc\fR (inline, without calling a C function). XS code that |
| 978 |
already calls the APIs to get values will not be affected by this change. XS |
| 979 |
code that accesses flags directly instead of using API calls to express its |
| 980 |
intent \fImight\fR break, but such code likely is already buggy if passed some |
| 981 |
other values, such as floating point values or objects with string overloading. |
| 982 |
.Sp |
| 983 |
This small change permits code (such as JSON serializers) to reliably determine |
| 984 |
between |
| 985 |
.RS 4 |
| 986 |
.IP \(bu 4 |
| 987 |
a value that was initially \fBwritten\fR as an integer, but then \fBread\fR as a string |
| 988 |
.Sp |
| 989 |
.Vb 2 |
| 990 |
\& my $answer = 42; |
| 991 |
\& print "The answer is $answer\en"; |
| 992 |
.Ve |
| 993 |
.IP \(bu 4 |
| 994 |
that same value that was initially \fBwritten\fR as a string, but then \fBread\fR as an integer |
| 995 |
.Sp |
| 996 |
.Vb 3 |
| 997 |
\& my $answer = "42"; |
| 998 |
\& print "That doesn\*(Aqt look right\en" |
| 999 |
\& unless $answer == 6 * 9; |
| 1000 |
.Ve |
| 1001 |
.RE |
| 1002 |
.RS 4 |
| 1003 |
.Sp |
| 1004 |
For the first case (originally written as an integer), we now have: |
| 1005 |
.Sp |
| 1006 |
.Vb 6 |
| 1007 |
\& use Devel::Peek; |
| 1008 |
\& my $answer = 42; |
| 1009 |
\& Dump ($answer); |
| 1010 |
\& my $void = "$answer"; |
| 1011 |
\& print STDERR "\en"; |
| 1012 |
\& Dump($answer) |
| 1013 |
\& |
| 1014 |
\& |
| 1015 |
\& SV = IV(0x562538925778) at 0x562538925788 |
| 1016 |
\& REFCNT = 1 |
| 1017 |
\& FLAGS = (IOK,pIOK) |
| 1018 |
\& IV = 42 |
| 1019 |
\& |
| 1020 |
\& SV = PVIV(0x5625389263c0) at 0x562538925788 |
| 1021 |
\& REFCNT = 1 |
| 1022 |
\& FLAGS = (IOK,pIOK,pPOK) |
| 1023 |
\& IV = 42 |
| 1024 |
\& PV = 0x562538919b50 "42"\e0 |
| 1025 |
\& CUR = 2 |
| 1026 |
\& LEN = 10 |
| 1027 |
.Ve |
| 1028 |
.Sp |
| 1029 |
For the second (originally written as a string), we now have: |
| 1030 |
.Sp |
| 1031 |
.Vb 6 |
| 1032 |
\& use Devel::Peek; |
| 1033 |
\& my $answer = "42"; |
| 1034 |
\& Dump ($answer); |
| 1035 |
\& my $void = $answer == 6 * 9; |
| 1036 |
\& print STDERR "\en"; |
| 1037 |
\& Dump($answer)\*(Aq |
| 1038 |
\& |
| 1039 |
\& |
| 1040 |
\& SV = PV(0x5586ffe9bfb0) at 0x5586ffec0788 |
| 1041 |
\& REFCNT = 1 |
| 1042 |
\& FLAGS = (POK,IsCOW,pPOK) |
| 1043 |
\& PV = 0x5586ffee7fd0 "42"\e0 |
| 1044 |
\& CUR = 2 |
| 1045 |
\& LEN = 10 |
| 1046 |
\& COW_REFCNT = 1 |
| 1047 |
\& |
| 1048 |
\& SV = PVIV(0x5586ffec13c0) at 0x5586ffec0788 |
| 1049 |
\& REFCNT = 1 |
| 1050 |
\& FLAGS = (IOK,POK,IsCOW,pIOK,pPOK) |
| 1051 |
\& IV = 42 |
| 1052 |
\& PV = 0x5586ffee7fd0 "42"\e0 |
| 1053 |
\& CUR = 2 |
| 1054 |
\& LEN = 10 |
| 1055 |
\& COW_REFCNT = 1 |
| 1056 |
.Ve |
| 1057 |
.Sp |
| 1058 |
(One can't rely on the presence or absence of the flag \f(CW\*(C`SVf_IsCOW\*(C'\fR to |
| 1059 |
determine the history of operations on a scalar.) |
| 1060 |
.Sp |
| 1061 |
Previously both cases would be indistinguishable, with all 4 flags set: |
| 1062 |
.Sp |
| 1063 |
.Vb 7 |
| 1064 |
\& SV = PVIV(0x55d4d62edaf0) at 0x55d4d62f0930 |
| 1065 |
\& REFCNT = 1 |
| 1066 |
\& FLAGS = (IOK,POK,pIOK,pPOK) |
| 1067 |
\& IV = 42 |
| 1068 |
\& PV = 0x55d4d62e1740 "42"\e0 |
| 1069 |
\& CUR = 2 |
| 1070 |
\& LEN = 10 |
| 1071 |
.Ve |
| 1072 |
.Sp |
| 1073 |
(and possibly \f(CW\*(C`SVf_IsCOW\*(C'\fR, but not always) |
| 1074 |
.Sp |
| 1075 |
This now means that if XS code \fIreally\fR needs to determine which form a value |
| 1076 |
was first written as, it should implement logic roughly |
| 1077 |
.Sp |
| 1078 |
.Vb 6 |
| 1079 |
\& if (flags & SVf_IOK|SVf_NOK) && !(flags & SVf_POK) |
| 1080 |
\& serialize as number |
| 1081 |
\& else if (flags & SVf_POK) |
| 1082 |
\& serialize as string |
| 1083 |
\& else |
| 1084 |
\& the existing guesswork ... |
| 1085 |
.Ve |
| 1086 |
.Sp |
| 1087 |
Note that this doesn't cover "dualvars" \- scalars that report different |
| 1088 |
values when asked for their string form or number form (such as \f(CW$!\fR). |
| 1089 |
Most serialization formats cannot represent such duplicity. |
| 1090 |
.Sp |
| 1091 |
\&\fIThe existing guesswork\fR remains because as well as dualvars, values might |
| 1092 |
be \f(CW\*(C`undef\*(C'\fR, references, overloaded references, typeglobs and other things that |
| 1093 |
Perl itself can represent but do not map one-to-one into external formats, so |
| 1094 |
need some amount of approximation or encapsulation. |
| 1095 |
.RE |
| 1096 |
.IP \(bu 4 |
| 1097 |
\&\f(CW\*(C`sv_dump\*(C'\fR (and Devel::Peek’s \f(CW\*(C`Dump\*(C'\fR function) now escapes high-bit |
| 1098 |
octets in the PV as hex rather than octal. Since most folks understand hex |
| 1099 |
more readily than octal, this should make these dumps a bit more legible. |
| 1100 |
This does \fBnot\fR affect any other diagnostic interfaces like \f(CW\*(C`pv_display\*(C'\fR. |
| 1101 |
.SH "Selected Bug Fixes" |
| 1102 |
.IX Header "Selected Bug Fixes" |
| 1103 |
.IP \(bu 4 |
| 1104 |
\&\fButime()\fR now correctly sets errno/\f(CW$!\fR when called on a closed handle. |
| 1105 |
.IP \(bu 4 |
| 1106 |
The flags on the OPTVAL parameter to \fBsetsockopt()\fR were previously |
| 1107 |
checked before magic was called, possibly treating a numeric value as |
| 1108 |
a packed buffer or vice versa. It also ignored the UTF\-8 flag, |
| 1109 |
potentially treating the internal representation of an upgraded SV as |
| 1110 |
the bytes to supply to the \fBsetsockopt()\fR system call. (github #18660 <https://github.com/Perl/perl5/issues/18660>) |
| 1111 |
.IP \(bu 4 |
| 1112 |
Only set IOKp, not IOK on $) and $(. |
| 1113 |
This was issue #18955 <https://github.com/Perl/perl5/issues/18955>: This will prevent serializers from serializing these |
| 1114 |
variables as numbers (which loses the additional groups). |
| 1115 |
This restores behaviour from 5.16 |
| 1116 |
.IP \(bu 4 |
| 1117 |
Use of the \f(CW\*(C`mktables\*(C'\fR debugging facility would cause perl to croak since |
| 1118 |
v5.31.10; this problem has now been fixed. |
| 1119 |
.IP \(bu 4 |
| 1120 |
\&\f(CW\*(C`makedepend\*(C'\fR logic is now compatible with BSD make (fixes |
| 1121 |
GH #19046 <https://github.com/Perl/perl5/issues/19046>). |
| 1122 |
.IP \(bu 4 |
| 1123 |
Calling \f(CW\*(C`untie\*(C'\fR on a tied hash that is partway through iteration now frees the |
| 1124 |
iteration state immediately. |
| 1125 |
.Sp |
| 1126 |
Iterating a tied hash causes perl to store a copy of the current hash key to |
| 1127 |
track the iteration state, with this stored copy passed as the second parameter |
| 1128 |
to \f(CW\*(C`NEXTKEY\*(C'\fR. This internal state is freed immediately when tie hash iteration |
| 1129 |
completes, or if the hash is destroyed, but due to an implementation oversight, |
| 1130 |
it was not freed if the hash was untied. In that case, the internal copy of the |
| 1131 |
key would persist until the earliest of |
| 1132 |
.RS 4 |
| 1133 |
.IP 1. 4 |
| 1134 |
\&\f(CW\*(C`tie\*(C'\fR was called again on the same hash |
| 1135 |
.IP 2. 4 |
| 1136 |
The (now untied) hash was iterated (ie passed to any of \f(CW\*(C`keys\*(C'\fR, \f(CW\*(C`values\*(C'\fR or |
| 1137 |
\&\f(CW\*(C`each\*(C'\fR) |
| 1138 |
.IP 3. 4 |
| 1139 |
The hash was destroyed. |
| 1140 |
.RE |
| 1141 |
.RS 4 |
| 1142 |
.Sp |
| 1143 |
This inconsistency is now fixed \- the internal state is now freed immediately by |
| 1144 |
\&\f(CW\*(C`untie\*(C'\fR. |
| 1145 |
.Sp |
| 1146 |
As the precise timing of this behaviour can be observed with pure Perl code |
| 1147 |
(the timing of \f(CW\*(C`DESTROY\*(C'\fR on objects returned from \f(CW\*(C`FIRSTKEY\*(C'\fR and \f(CW\*(C`NEXTKEY\*(C'\fR) |
| 1148 |
it's just possible that some code is sensitive to it. |
| 1149 |
.RE |
| 1150 |
.IP \(bu 4 |
| 1151 |
The \f(CWInternals::getcwd()\fR function added for bootstrapping miniperl |
| 1152 |
in perl 5.30.0 is now only available in miniperl. [github #19122] |
| 1153 |
.IP \(bu 4 |
| 1154 |
Setting a breakpoint on a BEGIN or equivalently a \f(CW\*(C`use\*(C'\fR statement |
| 1155 |
could cause a memory write to a freed \f(CW\*(C`dbstate\*(C'\fR op. |
| 1156 |
[GH #19198 <https://github.com/Perl/perl5/issues/19198>] |
| 1157 |
.IP \(bu 4 |
| 1158 |
When bareword filehandles are disabled, the parser was interpreting |
| 1159 |
any bareword as a filehandle, even when immediatey followed by parens. |
| 1160 |
.SH "Errata From Previous Releases" |
| 1161 |
.IX Header "Errata From Previous Releases" |
| 1162 |
.IP \(bu 4 |
| 1163 |
perl5300delta mistakenly identified a CVE whose correct identification is |
| 1164 |
CVE\-2015\-1592. |
| 1165 |
.SH Obituaries |
| 1166 |
.IX Header "Obituaries" |
| 1167 |
Raun "Spider" Boardman (SPIDB on CPAN), author of at least 66 commits to the |
| 1168 |
Perl 5 core distribution between 1996 and 2002, passed away May 24, 2021 from |
| 1169 |
complications of COVID. He will be missed. |
| 1170 |
.PP |
| 1171 |
David H. Adler (DHA) passed away on November 16, 2021. In 1997, David |
| 1172 |
co-founded NY.pm, the first Perl user group, and in 1998 co-founded Perl |
| 1173 |
Mongers to help establish other user groups across the globe. He was a |
| 1174 |
frequent attendee at Perl conferences in both North America and Europe and well |
| 1175 |
known for his role in organizing \fIBad Movie Night\fR celebrations at those |
| 1176 |
conferences. He also contributed to the work of the Perl Foundation, including |
| 1177 |
administering the White Camel awards for community service. He will be missed. |
| 1178 |
.SH Acknowledgements |
| 1179 |
.IX Header "Acknowledgements" |
| 1180 |
Perl 5.36.0 represents approximately a year of development since Perl |
| 1181 |
5.34.0 and contains approximately 250,000 lines of changes across 2,000 |
| 1182 |
files from 82 authors. |
| 1183 |
.PP |
| 1184 |
Excluding auto-generated files, documentation and release tools, there were |
| 1185 |
approximately 190,000 lines of changes to 1,300 .pm, .t, .c and .h files. |
| 1186 |
.PP |
| 1187 |
Perl continues to flourish into its fourth decade thanks to a vibrant |
| 1188 |
community of users and developers. The following people are known to have |
| 1189 |
contributed the improvements that became Perl 5.36.0: |
| 1190 |
.PP |
| 1191 |
Alyssa Ross, Andrew Fresh, Aristotle Pagaltzis, Asher Mancinelli, Atsushi |
| 1192 |
Sugawara, Ben Cornett, Bernd, Biswapriyo Nath, Brad Barden, Bram, Branislav |
| 1193 |
Zahradník, brian d foy, Chad Granum, Chris 'BinGOs' Williams, Christian |
| 1194 |
Walde (Mithaldu), Christopher Yeleighton, Craig A. Berry, cuishuang, Curtis |
| 1195 |
Poe, Dagfinn Ilmari Mannsåker, Dan Book, Daniel Laügt, Dan Jacobson, Dan |
| 1196 |
Kogai, Dave Cross, Dave Lambley, David Cantrell, David Golden, David |
| 1197 |
Marshall, David Mitchell, E. Choroba, Eugen Konkov, Felipe Gasper, François |
| 1198 |
Perrad, Graham Knop, H.Merijn Brand, Hugo van der Sanden, Ilya Sashcheka, |
| 1199 |
Ivan Panchenko, Jakub Wilk, James E Keenan, James Raspass, Karen Etheridge, |
| 1200 |
Karl Williamson, Leam Hall, Leon Timmermans, Magnus Woldrich, Matthew |
| 1201 |
Horsfall, Max Maischein, Michael G Schwern, Michiel Beijen, Mike Fulton, |
| 1202 |
Neil Bowers, Nicholas Clark, Nicolas R, Niyas Sait, Olaf Alders, Paul Evans, |
| 1203 |
Paul Marquess, Petar-Kaleychev, Pete Houston, Renee Baecker, Ricardo Signes, |
| 1204 |
Richard Leach, Robert Rothenberg, Sawyer X, Scott Baker, Sergey Poznyakoff, |
| 1205 |
Sergey Zhmylove, Sisyphus, Slaven Rezic, Steve Hay, Sven Kirmess, TAKAI |
| 1206 |
Kousuke, Thibault Duponchelle, Todd Rinaldo, Tomasz Konojacki, Tomoyuki |
| 1207 |
Sadahiro, Tony Cook, Unicode Consortium, Yves Orton, Михаил |
| 1208 |
Козачков. |
| 1209 |
.PP |
| 1210 |
The list above is almost certainly incomplete as it is automatically |
| 1211 |
generated from version control history. In particular, it does not include |
| 1212 |
the names of the (very much appreciated) contributors who reported issues to |
| 1213 |
the Perl bug tracker. |
| 1214 |
.PP |
| 1215 |
Many of the changes included in this version originated in the CPAN modules |
| 1216 |
included in Perl's core. We're grateful to the entire CPAN community for |
| 1217 |
helping Perl to flourish. |
| 1218 |
.PP |
| 1219 |
For a more complete list of all of Perl's historical contributors, please |
| 1220 |
see the AUTHORS file in the Perl source distribution. |
| 1221 |
.SH "Reporting Bugs" |
| 1222 |
.IX Header "Reporting Bugs" |
| 1223 |
If you find what you think is a bug, you might check the perl bug database |
| 1224 |
at <https://github.com/Perl/perl5/issues>. There may also be information at |
| 1225 |
<http://www.perl.org/>, the Perl Home Page. |
| 1226 |
.PP |
| 1227 |
If you believe you have an unreported bug, please open an issue at |
| 1228 |
<https://github.com/Perl/perl5/issues>. Be sure to trim your bug down to a |
| 1229 |
tiny but sufficient test case. |
| 1230 |
.PP |
| 1231 |
If the bug you are reporting has security implications which make it |
| 1232 |
inappropriate to send to a public issue tracker, then see |
| 1233 |
"SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec |
| 1234 |
for details of how to report the issue. |
| 1235 |
.SH "Give Thanks" |
| 1236 |
.IX Header "Give Thanks" |
| 1237 |
If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, |
| 1238 |
you can do so by running the \f(CW\*(C`perlthanks\*(C'\fR program: |
| 1239 |
.PP |
| 1240 |
.Vb 1 |
| 1241 |
\& perlthanks |
| 1242 |
.Ve |
| 1243 |
.PP |
| 1244 |
This will send an email to the Perl 5 Porters list with your show of thanks. |
| 1245 |
.SH "SEE ALSO" |
| 1246 |
.IX Header "SEE ALSO" |
| 1247 |
The \fIChanges\fR file for an explanation of how to view exhaustive details on |
| 1248 |
what changed. |
| 1249 |
.PP |
| 1250 |
The \fIINSTALL\fR file for how to build Perl. |
| 1251 |
.PP |
| 1252 |
The \fIREADME\fR file for general stuff. |
| 1253 |
.PP |
| 1254 |
The \fIArtistic\fR and \fICopying\fR files for copyright information. |