This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add epigraph for v5.21.6
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
86372193 5perldelta - what is new for perl v5.21.6
c68523cb 6
238894db 7=head1 DESCRIPTION
c68523cb 8
86372193 9This document describes differences between the 5.21.5 release and the 5.21.6
238894db 10release.
c68523cb 11
86372193
A
12If you are upgrading from an earlier release such as 5.21.4, first read
13L<perl5215delta>, which describes differences between 5.21.4 and 5.21.5.
8435afd1 14
86372193 15=head1 Core Enhancements
4cad5dc8 16
518159a1
TC
17=head2 List form of pipe open implemented for Win32
18
19The list form of pipe:
20
21 open my $fh, "-|", "program", @arguments;
22
23is now implemented on Win32. It has the same limitations as C<system
24LIST> on Win32, since the Win32 API doesn't accept program arguments
25as a list.
26
fe609065
FC
27=head2 Assignment to list repetition
28
29C<(...) x ...> can now be used within a list that is assigned to, as long
30as the left-hand side is a valid lvalue. This allows C<(undef,undef,$foo)
31= that_function()> to be written as C<((undef)x2, $foo) = that_function()>.
32
295f7815
FC
33=head2 C<close> now sets C<$!>
34
35When an I/O error occurs, the fact that there has been an error is recorded
36in the handle. C<close> returns false for such a handle. Previously, the
37value of C<$!> would be untouched by C<close>, so the common convention of
38writing C<close $fh or die $!> did not work reliably. Now the handle
39records the value of C<$!>, too, and C<close> restores it.
40
86372193 41=head1 Deprecations
bb8c7e27 42
4475d0d2
KW
43=head2 Use of non-graphic characters in single-character variable names
44
45The syntax for single-character variable names is more lenient than
46for longer variable names, allowing the one-character name to be a
47punctuation character or even invisible (a non-graphic). Perl v5.20
48deprecated the ASCII-range controls as such a name. Now, all
49non-graphic characters that formerly were allowed are deprecated.
50The practical effect of this occurs only when not under C<S<"use
51utf8">>, and affects just the C1 controls (code points 0x80 through
520xFF), NO-BREAK SPACE, and SOFT HYPHEN.
53
9f122eef
FC
54=head2 Inlining of C<sub () { $var }> with observable side-effects
55
56In many cases Perl makes sub () { $var } into an inlinable constant
57subroutine, capturing the value of $var at the time the C<sub> expression
58is evaluated. This can break the closure behaviour in those cases where
59$var is subsequently modified. The subroutine won't return the new value.
60
61This usage is now deprecated in those cases where the variable could be
62modified elsewhere. Perl detects those cases and emits a deprecation
63warning. Such code will likely change in the future and stop producing a
64constant.
65
66If your variable is only modified in the place where it is declared, then
67Perl will continue to make the sub inlinable with no warnings.
68
69 sub make_constant {
70 my $var = shift;
71 return sub () { $var }; # fine
72 }
73
74 sub make_constant_deprecated {
75 my $var;
76 $var = shift;
96d11ca8 77 return sub () { $var }; # deprecated
9f122eef
FC
78 }
79
80 sub make_constant_deprecated2 {
81 my $var = shift;
82 log_that_value($var); # could modify $var
96d11ca8 83 return sub () { $var }; # deprecated
9f122eef
FC
84 }
85
86In the second example above, detecting that $var is assigned to only once
87is too hard to detect. That it happens in a spot other than the C<my>
88declaration is enough for Perl to find it suspicious.
89
90This deprecation warning happens only for a simple variable for the body of
91the sub. (A C<BEGIN> block or C<use> statement inside the sub is ignored,
92because it does not become part of the sub's body.) For more complex
93cases, such as C<sub () { do_something() if 0; $var }> the behaviour has
94changed such that inlining does not happen if the variable is modifiable
95elsewhere. Such cases should be rare.
96
8c8d6154 97=head1 Performance Enhancements
5cfa0642 98
86372193 99=over 4
5cfa0642 100
5b306eef
DD
101=item *
102
25a8e2be
FC
103C<(...)x1>, C<("constant")x0> and C<($scalar)x0> are now optimised in list
104context. If the right-hand argument is a constant 1, the repetition
105operator disappears. If the right-hand argument is a constant 0, the whole
106expressions is optimised to the empty list, so long as the left-hand
107argument is a simple scalar or constant. C<(foo())x0> is not optimised.
5b306eef 108
ef7051ba
FC
109=item *
110
111C<substr> assignment is now optimised into 4-argument C<substr> at the end
112of a subroutine (or as the argument to C<return>). Previously, this
113optimisation only happened in void context.
114
b450ee68
FC
115=item *
116
117Assignment to lexical variables is often optimised away. For instance, in
118C<$lexical = chr $foo>, the C<chr> operator writes directly to the lexical
119variable instead of returning a value that gets copied. This optimisation
120has been extended to C<split>, C<x> and C<vec> on the right-hand side. It
121has also been made to work with state variable initialization.
122
1e461e16
FC
123=item *
124
125In "\L...", "\Q...", etc., the extra "stringify" op is now optimised away,
126making these just as fast as C<lcfirst>, C<quotemeta>, etc.
127
aa95859b
FC
128=item *
129
130Assignment to an empty list is now sometimes faster. In particular, it
131never calls C<FETCH> on tied arguments on the right-hand side, whereas it
132used to sometimes.
133
86372193 134=back
357205d5 135
86372193 136=head1 Modules and Pragmata
357205d5 137
6ed80d55 138=head2 Updated Modules and Pragmata
0cb3abac 139
86372193 140=over 4
0cb3abac 141
deec1830
FC
142=item *
143
6ed80d55 144L<B> has been upgraded from version 1.52 to 1.53.
deec1830 145
6ed80d55 146=item *
d0ab07ee 147
6ed80d55 148L<B::Concise> has been upgraded from version 0.994 to 0.995.
d99849ae 149
ff433f2d
PM
150=item *
151
15d464c4
FC
152L<B::Deparse> has been upgraded from version 1.29 to 1.30.
153
154It now deparses C<+sub : attr { ... }> correctly at the start of a
155statement. Without the initial C<+>, C<sub> would be a statement label.
156
16752205
FC
157C<BEGIN> blocks are now emitted in the right place most of the time, but
158the change unfortunately introduced a regression, in that C<BEGIN> blocks
159occurring just before the end of the enclosing block may appear below it
160instead. So this change may need to be reverted if it cannot be fixed
161before Perl 5.22. [perl #77452]
162
80b0bb91
FC
163B::Deparse no longer puts erroneous C<local> here and there, such as for
164C<LIST = tr/a//d>. [perl #119815]
165
697c5991
FC
166Adjacent C<use> statements are no longer accidentally nested if one
167contains a C<do> block. [perl #115066]
168
15d464c4
FC
169=item *
170
d8fc3586
FC
171L<B::Op_private> has been upgraded from version 5.021005 to 5.021006.
172
173It now includes a hash named C<%ops_using>, list all op types that use a
174particular private flag.
175
176=item *
177
6ed80d55
CBW
178L<CPAN::Meta> has been upgraded from version 2.142690 to 2.143240.
179
180=item *
181
182L<CPAN::Meta::Requirements> has been upgraded from version 2.128 to 2.130.
183
184=item *
185
186L<Devel::Peek> has been upgraded from version 1.18 to 1.19.
187
188=item *
189
190L<Digest::SHA> has been upgraded from version 5.92 to 5.93.
191
192=item *
193
f4e81f96 194L<DynaLoader> has been upgraded from version 1.27 to 1.28.
cbfcbc14 195
bb6a367a
DD
196=item *
197
6ed80d55
CBW
198L<Encode> has been upgraded from version 2.62 to 2.64.
199
200=item *
201
202L<experimental> has been upgraded from version 0.012 to 0.013.
203
204=item *
205
206L<Exporter> has been upgraded from version 5.71 to 5.72.
207
208=item *
209
210L<ExtUtils::MakeMaker> has been upgraded from version 6.98 to 7.02.
211
212=item *
213
214L<ExtUtils::Manifest> has been upgraded from version 1.68 to 1.69.
215
216=item *
217
218L<ExtUtils::ParseXS> has been upgraded from version 3.25 to 3.26.
219
220=item *
221
222L<HTTP::Tiny> has been upgraded from version 0.050 to 0.051.
223
224=item *
225
226L<I18N::Langinfo> has been upgraded from version 0.11 to 0.12.
227
228=item *
229
f4e81f96
FC
230L<IO::Socket> has been upgraded from version 1.37 to 1.38.
231
232Document the limitations of the isconnected() method. [perl #123096]
bb6a367a 233
6ed80d55 234=item *
f348c3d8 235
6ed80d55 236L<locale> has been upgraded from version 1.04 to 1.05.
f348c3d8 237
6ed80d55
CBW
238=item *
239
240L<Module::CoreList> has been upgraded from version 5.20141020 to 5.20141120.
f348c3d8
A
241
242=item *
243
6ed80d55 244L<overload> has been upgraded from version 1.23 to 1.24.
f348c3d8 245
6ed80d55 246=item *
7635ad4d 247
6ed80d55 248L<PerlIO::encoding> has been upgraded from version 0.19 to 0.20.
7635ad4d 249
6ed80d55 250=item *
7635ad4d 251
6ed80d55 252L<PerlIO::scalar> has been upgraded from version 0.19 to 0.20.
f348c3d8 253
6ed80d55 254=item *
f348c3d8 255
6ed80d55 256L<POSIX> has been upgraded from version 1.45 to 1.46.
f4eedc6b 257
6ed80d55 258=item *
f4eedc6b 259
6ed80d55 260L<re> has been upgraded from version 0.27 to 0.28.
f4eedc6b 261
6ed80d55 262=item *
f348c3d8 263
6ed80d55 264L<Test::Harness> has been upgraded from version 3.33 to 3.34.
f348c3d8 265
6ed80d55
CBW
266=item *
267
268L<Test::Simple> has been upgraded from version 1.001008 to 1.301001_075.
f348c3d8
A
269
270=item *
271
6ed80d55 272L<Unicode::UCD> has been upgraded from version 0.58 to 0.59.
f348c3d8 273
6ed80d55 274=item *
f348c3d8 275
6ed80d55 276L<warnings> has been upgraded from version 1.28 to 1.29.
f348c3d8 277
6ed80d55 278=item *
f348c3d8 279
6ed80d55 280L<XSLoader> has been upgraded from version 0.18 to 0.19.
f348c3d8 281
6ed80d55
CBW
282=back
283
284=head1 Documentation
f348c3d8 285
6ed80d55 286=head2 Changes to Existing Documentation
f348c3d8 287
6ed80d55 288=head3 L<perldata/Identifier parsing>
84d03adf 289
86372193 290=over 4
ff433f2d 291
4cd408ba
TC
292=item *
293
6ed80d55
CBW
294The syntax of single-character variable names has been brought
295up-to-date and more fully explained.
f348c3d8 296
86372193 297=back
f348c3d8 298
6ed80d55
CBW
299=head1 Diagnostics
300
301The following additions or changes have been made to diagnostic output,
302including warnings and fatal error messages. For the complete list of
303diagnostic messages, see L<perldiag>.
304
305=head2 New Diagnostics
306
86372193 307=head3 New Warnings
f4eedc6b 308
86372193 309=over 4
f4eedc6b
DD
310
311=item *
312
4475d0d2 313L<Use of literal non-graphic characters in variable names is deprecated|perldiag/"Use of literal non-graphic characters in variable names is deprecated">
f348c3d8 314
ab0b796c
KW
315=item *
316
8c6180a9
KW
317A new C<locale> warning category has been created, with the following warning
318messages currently in it:
319
320=over 4
321
322=item *
323
324L<Locale '%s' may not work well.%s|perldiag/Locale '%s' may not work well.%s>
325
326=item *
327
ab0b796c
KW
328L<Can't do %s("%s") on non-UTF-8 locale; resolved to "%s".|perldiag/Can't do %s("%s") on non-UTF-8 locale; resolved to "%s".>
329
86372193 330=back
0561e60b 331
dd200dff
FC
332=item *
333
334L<Warning: unable to close filehandle %s properly: %s|perldiag/"Warning: unable to close filehandle %s properly: %s">
335
73e793fc
FC
336=item *
337
338The following two warnings for C<tr///> used to be skipped if the
339transliteration contained wide characters, but now they occur regardless of
340whether there are wide characters or not:
341
342L<Useless use of E<sol>d modifier in transliteration operator|perldiag/"Useless use of /d modifier in transliteration operator">
343
344L<Replacement list is longer than search list|perldiag/Replacement list is longer than search list>
345
8c6180a9
KW
346=back
347
86372193 348=head2 Changes to Existing Diagnostics
0561e60b 349
86372193 350=over 4
4cd408ba 351
f348c3d8
A
352=item *
353
cb3bb329 354L<Quantifier unexpected on zero-length expression in regex mE<sol>%sE<sol>|perldiag/"Quantifier unexpected on zero-length expression in regex m/%s/">.
4a328228
FC
355
356This message has had the S<"<-- HERE"> marker removed, as it was always
357placed at the end of the regular expression, regardless of where the
358problem actually occurred. [perl #122680]
4cd408ba 359
1861205d
FC
360=item *
361
362L<Setting $E<sol> to a reference to %s as a form of slurp is deprecated, treating as undef|perldiag/"Setting $/ to a reference to %s as a form of slurp is deprecated, treating as undef">
363
364This warning is now a default warning, like other deprecation warnings.
365
86372193 366=back
40a81b59 367
86372193 368=head1 Configuration and Compilation
2a395b86 369
8435afd1 370=over 4
2a395b86 371
12d22d1f
JK
372=item *
373
c517e197 374F<Configure> with C<-Dmksymlinks> should now be faster. [perl #122002]
12d22d1f 375
2a395b86
PM
376=back
377
8c8d6154 378=over 4
2a395b86
PM
379
380=item *
381
6ed80d55 382As well as the gzip and bzip2 tarballs, this release has been made available as an xz utils compressed tarball.
bb8c7e27 383
86372193 384=back
bb8c7e27 385
86372193 386=head1 Platform Support
bb8c7e27 387
8c8d6154 388=head2 Platform-Specific Notes
aa292ef2 389
83b69bfd
DD
390=head3 Win32
391
392=over 4
393
394=item *
395
396In the experimental C<:win32> layer, a crash in C<open> was fixed. Also
397opening C</dev/null>, which works the Win32 Perl's normal C<:unix> layer, was
398implemented for C<:win32>.
399L<[perl #122224]|https://rt.perl.org/Ticket/Display.html?id=122224>
400
13adb056
SH
401=item *
402
403A new makefile option, C<USE_LONG_DOUBLE>, has been added to the Windows
404dmake makefile for gcc builds only. Set this to "define" if you want perl to
405use long doubles to give more accuracy and range for floating point numbers.
406
83b69bfd
DD
407=back
408
8c8d6154 409=head1 Internal Changes
7d15b1a8 410
86372193 411=over 4
28482d6c 412
28a42920
A
413=item *
414
f8d5a522
DD
415C<screaminstr> has been removed. Although marked as public API, it is
416undocumented and has no usage in modern perl versions on CPAN Grep. Calling it
417has been fatal since 5.17.0.
28a42920 418
d109137e
FC
419=item *
420
76acbf4f
FC
421C<newDEFSVOP>, C<block_start>, C<block_end> and C<intro_my> have been added
422to the API.
d109137e 423
cff8e04e
FC
424=item *
425
426The internal C<convert> function in F<op.c> has been renamed
427C<op_convert_list> and added to the API.
428
391823f2
FC
429=item *
430
431C<sv_magic> no longer forbids "ext" magic on read-only values. After all,
432perl can't know whether the custom magic will modify the SV or not.
433[perl #123103]
434
8c8d6154 435=back
6ff8f256 436
8c8d6154 437=head1 Selected Bug Fixes
80cc3290 438
86372193 439=over 4
db98db4e 440
8818afe8
TC
441=item *
442
2ad9844a
TC
443fchmod() and futimes() now set C<$!> when they fail due to being
444passed a closed file handle. [perl #122703]
bb8c7e27 445
9ee757be
KW
446=item *
447
448Perl now comes with a corrected Unicode 7.0 for the erratum issued on
449October 21, 2014 (see L<http://www.unicode.org/errata/#current_errata>),
450dealing with glyph shaping in Arabic.
451
c93d2ba1
TC
452=item *
453
454op_free() no longer crashes due to a stack overflow when freeing a
455deeply recursive op tree. [perl #108276]
456
53795ef8
FC
457=item *
458
9d22ccf6
TC
459scalarvoid() would crash due to a stack overflow when processing a
460deeply recursive op tree. [perl #108276]
461
462=item *
463
53795ef8
FC
464In Perl 5.20.0, C<$^N> accidentally had the internal UTF8 flag turned off
465if accessed from a code block within a regular expression, effectively
466UTF8-encoding the value. This has been fixed. [perl #123135]
467
b7cd8332
FC
468=item *
469
470A failed C<semctl> call no longer overwrites existing items on the stack,
471causing C<(semctl(-1,0,0,0))[0]> to give an "uninitialized" warning.
472
480961b6
FC
473=item *
474
475C<else{foo()}> with no space before C<foo> is now better at assigning the
476right line number to that statement. [perl #122695]
477
94c9bf90
FC
478=item *
479
480Sometimes the assignment in C<@array = split> gets optimised and C<split>
481itself writes directly to the array. This caused a bug, preventing this
482assignment from being used in lvalue context. So
483C<(@a=split//,"foo")=bar()> was an error. (This bug probably goes back to
484Perl 3, when the optimisation was added.) This optimisation, and the bug,
485started to happen in more cases in 5.21.5. It has now been fixed.
486[perl #123057]
487
8af808bf
FC
488=item *
489
490When argument lists that fail the checks installed by subroutine
491signatures, the resulting error messages now give the file and line number
492of the caller, not of the called subroutine. [perl #121374]
493
fdcaecb7
FC
494=item *
495
496Flip-flop operators (C<..> and C<...> in scalar context) used to maintain
497a separate state for each recursion level (the number of times the
498enclosing sub was called recursively), contrary to the documentation. Now
499each closure has one internal state for each flip-flop. [perl #122829]
500
2af7c6b6
FC
501=item *
502
503C<use>, C<no>, statement labels, special blocks (C<BEGIN>) and pod are now
504permitted as the first thing in a C<map> or C<grep> block, the block after
505C<print> or C<say> (or other functions) returning a handle, and within
506C<${...}>, C<@{...}>, etc. [perl #122782]
507
c0b32823
FC
508=item *
509
510The repetition operator C<x> now propagates lvalue context to its left-hand
511argument when used in contexts like C<foreach>. That allows
512C<for(($#that_array)x2) { ... }> to work as expected if the loop modifies
513$_.
514
b1a4e8b3
FC
515=item *
516
517C<(...) x ...> in scalar context used to corrupt the stack if one operand
518were an object with "x" overloading, causing erratic behaviour.
519[perl #121827]
520
9e26817d
FC
521=item *
522
523Assignment to a lexical scalar is often optimised away (as mentioned under
179c70e5 524L</Performance Enhancements>). Various bugs related to this optimisation
9e26817d
FC
525have been fixed. Certain operators on the right-hand side would sometimes
526fail to assign the value at all or assign the wrong value, or would call
527STORE twice or not at all on tied variables. The operators affected were
528C<$foo++>, C<$foo-->, and C<-$foo> under C<use integer>, C<chomp>, C<chr>
529and C<setpgrp>.
530
70cee83f
FC
531=item *
532
533List assignments were sometimes buggy if the same scalar ended up on both
534sides of the assignment due to used of C<tied>, C<values> or C<each>. The
535result would be the wrong value getting assigned.
536
e5fbfbc1
FC
537=item *
538
539C<setpgrp($nonzero)> (with one argument) was accidentally changed in 5.16
540to mean C<setpgrp(0)>. This has been fixed.
541
353075a0
FC
542=item *
543
544C<__SUB__> could return the wrong value or even corrupt memory under the
545debugger (the B<-d> switch) and in subs containing C<eval $string>.
546
9f122eef
FC
547=item *
548
549When C<sub () { $var }> becomes inlinable, it now returns a different
550scalar each time, just as a non-inlinable sub would, though Perl still
551optimises the copy away in cases where it would make no observable
552difference.
553
554=item *
555
556C<my sub f () { $var }> and C<sub () : attr { $var }> are no longer
557eligible for inlining. The former would crash; the latter would just
558throw the attributes away. An exception is made for the little-known
559":method" attribute, which does nothing much.
560
561=item *
562
563Inlining of subs with an empty prototype is now more consistent than
564before. Previously, a sub with multiple statements, all but the last
565optimised away, would be inlinable only if it were an anonymous sub
566containing a string C<eval> or C<state> declaration or closing over an
567outer lexical variable (or any anonymous sub under the debugger). Now any
568sub that gets folded to a single constant after statements have been
569optimised away is eligible for inlining. This applies to things like C<sub
570() { jabber() if DEBUG; 42 }>.
571
572Some subroutines with an explicit C<return> were being made inlinable,
573contrary to the documentation, Now C<return> always prevents inlining.
574
c7f058f0
FC
575=item *
576
577On some systems, such as VMS, C<crypt> can return a non-ASCII string. If a
578scalar assigned to had contained a UTF8 string previously, then C<crypt>
579would not turn off the UTF8 flag, thus corrupting the return value. This
6ed80d55 580would happen with C<$lexical = crypt ...>.
c7f058f0 581
0ef4323a
FC
582=item *
583
584C<crypt> no longer calls C<FETCH> twice on a tied first argument.
585
c263379c
FC
586=item *
587
588An unterminated here-doc on the last line of a quote-like operator
589(C<qq[${ <<END }]>, C</(?{ <<END })/>) no longer causes a double free. It
590started doing so in 5.18.
591
ff90be78
TC
592=item *
593
594Fixed two assertion failures introduced into C<-DPERL_OP_PARENT>
595builds. [perl #108276]
596
86372193 597=back
bb8c7e27 598
86372193 599=head1 Known Problems
bb8c7e27 600
86372193 601=over 4
bb8c7e27 602
74f9f9ed
A
603=item *
604
eacbb379
DD
605Starting in 5.21.6, accessing L<perlapi/CvPADLIST> in an XSUB is forbidden.
606CvPADLIST has be reused for a different internal purpose for XSUBs. Guard all
607CvPADLIST expressions with C<CvISXSUB()> if your code doesn't already block
608XSUB CV*s from going through optree CV* expecting code.
28a42920 609
86372193 610=back
28a42920 611
6ed80d55
CBW
612=over 4
613
614=item *
615
616Builds on FreeBSD 10.x currently fail when compiling L<POSIX>. A workaround is
617to specify C<-Ui_fenv> when running C<Configure>.
618
619=back
620
86372193 621=head1 Errata From Previous Releases
28a42920 622
86372193 623=over 4
28a42920
A
624
625=item *
626
857f4fb1
FC
627Due to a mistake in the string-copying logic, copying the value of a state
628variable could instead steal the value and undefine the variable. This
629bug, introduced in 5.20, would happen mostly for long strings (1250 chars
630or more), but could happen for any strings under builds with copy-on-write
631disabled. [perl #123029]
632
633This bug was actually fixed in 5.21.5, but it was not until after that
634release that this bug, and the fact that it had been fixed, were
635discovered.
28a42920 636
f5630681
FC
637=item *
638
639If a named sub tries to access a scalar declared in an outer anonymous sub,
640the variable is not available, so the named sub gets its own undefined
641scalar. In 5.10, attempts to take a reference to the variable
642(C<\$that_variable>) began returning a reference to a I<copy> of it
643instead. This was accidentally fixed in 5.21.4, but the bug and its fix
644were not noticed till now.
645
8c8d6154 646=back
3a085d00 647
6ed80d55 648=head1 Acknowledgements
01d42a22 649
6ed80d55
CBW
650Perl 5.21.6 represents approximately 4 weeks of development since Perl 5.21.5
651and contains approximately 60,000 lines of changes across 920 files from 25
652authors.
01d42a22 653
6ed80d55
CBW
654Excluding auto-generated files, documentation and release tools, there were
655approximately 48,000 lines of changes to 630 .pm, .t, .c and .h files.
656
657Perl continues to flourish into its third decade thanks to a vibrant community
658of users and developers. The following people are known to have contributed the
659improvements that became Perl 5.21.6:
660
661Aaron Crane, Abigail, Andrew Fresh, Andy Dougherty, Brian Fraser, Chad Granum,
662Chris 'BinGOs' Williams, Craig A. Berry, Daniel Dragan, David Mitchell, Doug
663Bell, Father Chrysostomos, Glenn D. Golden, James E Keenan, Jarkko Hietaniemi,
664Jim Cromie, Karen Etheridge, Karl Williamson, Lukas Mai, Ricardo Signes, Shlomi
665Fish, Slaven Rezic, Steve Hay, Tony Cook, Yaroslav Kuzmin.
666
667The list above is almost certainly incomplete as it is automatically generated
668from version control history. In particular, it does not include the names of
669the (very much appreciated) contributors who reported issues to the Perl bug
670tracker.
01d42a22 671
6ed80d55
CBW
672Many of the changes included in this version originated in the CPAN modules
673included in Perl's core. We're grateful to the entire CPAN community for
674helping Perl to flourish.
01d42a22 675
6ed80d55
CBW
676For a more complete list of all of Perl's historical contributors, please see
677the F<AUTHORS> file in the Perl source distribution.
f5b73711 678
44691e6f
AB
679=head1 Reporting Bugs
680
e08634c5
SH
681If you find what you think is a bug, you might check the articles recently
682posted to the comp.lang.perl.misc newsgroup and the perl bug database at
238894db 683https://rt.perl.org/ . There may also be information at
7ef8b31d 684http://www.perl.org/ , the Perl Home Page.
44691e6f 685
e08634c5
SH
686If you believe you have an unreported bug, please run the L<perlbug> program
687included with your release. Be sure to trim your bug down to a tiny but
688sufficient test case. Your bug report, along with the output of C<perl -V>,
689will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
690
691If the bug you are reporting has security implications, which make it
e08634c5
SH
692inappropriate to send to a publicly archived mailing list, then please send it
693to perl5-security-report@perl.org. This points to a closed subscription
694unarchived mailing list, which includes all the core committers, who will be
695able to help assess the impact of issues, figure out a resolution, and help
f9001595 696co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
697platforms on which Perl is supported. Please only use this address for
698security issues in the Perl core, not for modules independently distributed on
699CPAN.
44691e6f
AB
700
701=head1 SEE ALSO
702
e08634c5
SH
703The F<Changes> file for an explanation of how to view exhaustive details on
704what changed.
44691e6f
AB
705
706The F<INSTALL> file for how to build Perl.
707
708The F<README> file for general stuff.
709
710The F<Artistic> and F<Copying> files for copyright information.
711
712=cut