This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Document eba98284740b799def26803ebac340aaa8930437
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
af8a293f
SL
5[ this is a template for a new perldelta file. Any text flagged as XXX needs
6to be processed before release. ]
7
8perldelta - what is new for perl v5.23.8
eabfc7bc 9
2cfe9b50 10=head1 DESCRIPTION
eabfc7bc 11
af8a293f 12This document describes differences between the 5.23.7 release and the 5.23.8
2cfe9b50 13release.
eabfc7bc 14
af8a293f
SL
15If you are upgrading from an earlier release such as 5.23.6, first read
16L<perl5237delta>, which describes differences between 5.23.6 and 5.23.7.
394609a5 17
af8a293f 18=head1 Notice
6b659339 19
af8a293f 20XXX Any important notices here
6b659339 21
af8a293f 22=head1 Core Enhancements
a8c28920 23
af8a293f
SL
24XXX New core language features go here. Summarize user-visible core language
25enhancements. Particularly prominent performance optimisations could go
26here, but most should go in the L</Performance Enhancements> section.
7feb15ec 27
af8a293f 28[ List each enhancement as a =head2 entry ]
7feb15ec 29
cdfe2e65
DIM
30=head2 More fields provided to C<sigaction> callback with C<SA_SIGINFO>
31
32When passing the C<SA_SIGINFO> flag to L<sigaction|POSIX/sigaction>, the
33C<errno>, C<status>, C<uid>, C<pid>, C<addr> and C<band> fields are now
34included in the hash passed to the handler, if supported by the
35platform.
36
af8a293f 37=head1 Security
a8c28920 38
af8a293f
SL
39XXX Any security-related notices go here. In particular, any security
40vulnerabilities closed should be noted here rather than in the
41L</Selected Bug Fixes> section.
a8c28920 42
af8a293f 43[ List each security issue as a =head2 entry ]
a8c28920 44
c0883d63 45=head1 Incompatible Changes
a8c28920 46
af8a293f 47XXX For a release on a stable branch, this section aspires to be:
f1f6961f 48
af8a293f
SL
49 There are no changes intentionally incompatible with 5.XXX.XXX
50 If any exist, they are bugs, and we request that you submit a
51 report. See L</Reporting Bugs> below.
f1f6961f 52
af8a293f 53[ List each incompatible change as a =head2 entry ]
1257ab89 54
fe0a3646
KW
55=head2 C<qr/\N{}/> now disallowed under C<use re "strict">
56
57An empty C<\N{}> makes no sense, but for backwards compatibility is
58silently accepted as doing nothing. But now this is a fatal error under
59the experimental feature L<re/'strict' mode>.
60
af8a293f 61=head1 Deprecations
d9d208b8 62
af8a293f 63XXX Any deprecated features, syntax, modules etc. should be listed here.
d9d208b8 64
af8a293f 65=head2 Module removals
a7e63acd 66
af8a293f 67XXX Remove this section if inapplicable.
a7e63acd 68
af8a293f
SL
69The following modules will be removed from the core distribution in a
70future release, and will at that time need to be installed from CPAN.
71Distributions on CPAN which require these modules will need to list them as
72prerequisites.
a7e63acd 73
af8a293f
SL
74The core versions of these modules will now issue C<"deprecated">-category
75warnings to alert you to this fact. To silence these deprecation warnings,
76install the modules in question from CPAN.
a7e63acd 77
af8a293f
SL
78Note that these are (with rare exceptions) fine modules that you are encouraged
79to continue to use. Their disinclusion from core primarily hinges on their
80necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
81not usually on concerns over their design.
a7e63acd 82
af8a293f 83=over
a7e63acd 84
af8a293f 85=item XXX
a7e63acd 86
af8a293f
SL
87XXX Note that deprecated modules should be listed here even if they are listed
88as an updated module in the L</Modules and Pragmata> section.
a7e63acd 89
af8a293f 90=back
a7e63acd 91
af8a293f 92[ List each other deprecation as a =head2 entry ]
a7e63acd 93
af8a293f 94=head1 Performance Enhancements
a7e63acd 95
af8a293f
SL
96XXX Changes which enhance performance without changing behaviour go here.
97There may well be none in a stable release.
a7e63acd 98
af8a293f 99[ List each enhancement as a =item entry ]
a7e63acd 100
af8a293f 101=over 4
a7e63acd
SL
102
103=item *
104
d7745c5b
DM
105The overhead of scope entry and exit has been considerably reduced, so
106for example subroutine calls, loops and basic blocks are all faster now.
107This empty function call now takes about a third less time to execute:
108
109 sub f{} f();
a7e63acd 110
d7a7ed74
DD
111=item *
112
df539208
S
113On Win32, C<stat>ing or C<-X>ing a path, if the file or directory does not
114exist, is now 3.5x faster on a SSD (or any drive) than before.
d7a7ed74 115
af8a293f 116=back
a7e63acd 117
af8a293f 118=head1 Modules and Pragmata
a7e63acd 119
af8a293f
SL
120XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
121go here. If Module::CoreList is updated, generate an initial draft of the
122following sections using F<Porting/corelist-perldelta.pl>. A paragraph summary
123for important changes should then be added by hand. In an ideal world,
124dual-life modules would have a F<Changes> file that could be cribbed.
a7e63acd 125
af8a293f 126[ Within each section, list entries as a =item entry ]
a7e63acd 127
af8a293f 128=head2 New Modules and Pragmata
a7e63acd 129
af8a293f 130=over 4
a7e63acd
SL
131
132=item *
133
af8a293f 134XXX
a7e63acd 135
af8a293f 136=back
fd12b912 137
af8a293f 138=head2 Updated Modules and Pragmata
f909f9f7 139
af8a293f 140=over 4
a7e63acd
SL
141
142=item *
143
9b88cb2a 144F<cpan/podlators/> has been upgraded from version 4.04 to 4.06.
a7e63acd 145
34e79b75
DIM
146=item *
147
df539208 148L<POSIX> has been upgraded from version 1.59 to 1.63.
34e79b75
DIM
149
150It can now export constants for the C<code> value in the hash passed to the
151L<sigaction|POSIX/sigaction> handler when using the C<SA_SIGINFO> flag.
152
df539208
S
153These previously deprecated functions are now removed: C<isalnum>,
154C<isalpha>, C<iscntrl>, C<isdigit>, C<isgraph>, C<islower>, C<isprint>,
155C<ispunct>, C<isspace>, C<isupper>, and C<isxdigit>.
156
157=item *
158
159L<Encode> has been upgraded from version 2.78 to 2.80.
160
161=item *
162
163L<Storable> has been upgraded from version 2.54 to 2.55.
164
165=item *
166
167L<Time::HiRes> has been upgraded from version 1.9728 to 1.9730.
168
169It can now export Linux-specific and FreeBSD-specific C<clock_gettime()>
170constants. It also now has emulation for OS X C<clock_nanosleep()>,
171C<clock_gettime()>, and C<clock_getres()>.
172
173=item *
174
175L<DynaLoader> has been upgraded from version 1.37 to 1.38.
176
177DynaLoader now always looks for bootstrap files having the same base name as
178the module for which the bootstrap code is being run. Previously, and only on
179platforms that use C<mod2fname> to produce unique loadable library names,
180L<DynaLoader> would look for the bootstrap file using a base name that matched
181the loadable library and not find it.
182
183=item *
184
185L<PerlIO::encoding> has been upgraded from version 0.23 to 0.24.
186
187=item *
188
189The PathTools module collection has been upgraded from version 3.62
190to 3.63.
191
af8a293f 192=back
a7e63acd 193
af8a293f 194=head2 Removed Modules and Pragmata
a7e63acd 195
af8a293f 196=over 4
a7e63acd
SL
197
198=item *
199
af8a293f 200XXX
f909f9f7 201
054383b6 202=back
d9d208b8 203
c0883d63
SL
204=head1 Documentation
205
af8a293f
SL
206XXX Changes to files in F<pod/> go here. Consider grouping entries by
207file and be sure to link to the appropriate page, e.g. L<perlfunc>.
c0883d63 208
af8a293f 209=head2 New Documentation
d9d208b8 210
af8a293f 211XXX Changes which create B<new> files in F<pod/> go here.
d9d208b8 212
af8a293f 213=head3 L<XXX>
d9d208b8 214
af8a293f 215XXX Description of the purpose of the new file here
523c5db4 216
af8a293f 217=head2 Changes to Existing Documentation
d9d208b8 218
af8a293f
SL
219XXX Changes which significantly change existing files in F<pod/> go here.
220However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
221section.
222
d7745c5b 223=head3 L<perlguts>
d9d208b8 224
c0883d63 225=over 4
fd12b912 226
c0883d63 227=item *
fd12b912 228
d7745c5b
DM
229A new section has been added, L<perlguts/"Dynamic Scope and the Context
230Stack">, which explains how the perl context stack works.
fd12b912 231
c0883d63 232=back
d9d208b8 233
986b8b49
JK
234=head3 L<perlmodlib>
235
236=over 4
237
238=item *
239
240We now recommend contacting the module-authors list or PAUSE in seeking
241guidance on the naming of modules.
242
243=back
244
af8a293f 245=head1 Diagnostics
d9d208b8 246
af8a293f
SL
247The following additions or changes have been made to diagnostic output,
248including warnings and fatal error messages. For the complete list of
249diagnostic messages, see L<perldiag>.
d9d208b8 250
af8a293f
SL
251XXX New or changed warnings emitted by the core's C<C> code go here. Also
252include any changes in L<perldiag> that reconcile it to the C<C> code.
fd12b912 253
af8a293f 254=head2 New Diagnostics
fd12b912 255
af8a293f
SL
256XXX Newly added diagnostic messages go under here, separated into New Errors
257and New Warnings
fd12b912 258
af8a293f 259=head3 New Errors
c0883d63 260
af8a293f 261=over 4
fd12b912 262
c0883d63 263=item *
d9d208b8 264
cfbef7dc
KW
265L<Sequence (?PE<lt>... not terminated in regex; marked by S<<-- HERE> in mE<sol>%sE<sol>
266|perldiag/"Sequence (?PE<lt>... not terminated in regex; marked by <-- HERE in mE<sol>%sE<sol>">
267
268=item *
269
270L<Sequence (?PE<gt>... not terminated in regex; marked by S<<-- HERE> in mE<sol>%sE<sol>
271|perldiag/Sequence (?PE<gt>... not terminated in regex; marked by <-- HERE in mE<sol>%sE<sol>>
d9d208b8 272
df539208
S
273=item *
274
275L<Empty \%c in regex; marked by S<<-- HERE> in mE<sol>%sE<sol>
276|perldiag/Empty \%c in regex; marked by <-- HERE in mE<sol>%sE<sol>>
277
c0883d63 278=back
fd12b912 279
af8a293f 280=head3 New Warnings
fd12b912 281
054383b6 282=over 4
fd12b912
DG
283
284=item *
285
46d34d0e
KW
286L<Assuming NOT a POSIX class since %s in regex; marked by E<lt>-- HERE in mE<sol>%sE<sol>|
287perldiag/Assuming NOT a POSIX class since %s in regex; marked by <-- HERE in mE<sol>%sE<sol>>
a8c28920 288
6c83150b 289=back
a8c28920 290
af8a293f
SL
291=head2 Changes to Existing Diagnostics
292
293XXX Changes (i.e. rewording) of diagnostic messages go here
d9d208b8
DG
294
295=over 4
296
297=item *
298
af8a293f 299XXX Describe change here
d9d208b8
DG
300
301=back
302
af8a293f 303=head1 Utility Changes
c0883d63 304
af8a293f
SL
305XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
306Most of these are built within the directory F<utils>.
054383b6 307
af8a293f
SL
308[ List utility changes as a =head2 entry for each utility and =item
309entries for each change
310Use L<XXX> with program names to get proper documentation linking. ]
311
312=head2 L<XXX>
a8c28920 313
6c83150b 314=over 4
a8c28920
A
315
316=item *
317
af8a293f 318XXX
d9d208b8
DG
319
320=back
321
054383b6 322=head1 Configuration and Compilation
a8c28920 323
af8a293f
SL
324XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
325go here. Any other changes to the Perl build process should be listed here.
326However, any platform-specific changes should be listed in the
327L</Platform Support> section, instead.
328
329[ List changes as a =item entry ].
330
6c83150b 331=over 4
a8c28920 332
6c83150b 333=item *
a8c28920 334
c5b0f62d
TC
335The GNU Make makefile for Win32 now supports parallel builds. [perl #126632]
336
337=item *
338
339You can now build perl with MSVC++ on Win32 using GNU Make. [perl #126632]
054383b6 340
df539208
S
341=item *
342
343Bison 3.0 is now supported.
344
af8a293f
SL
345=back
346
347=head1 Testing
348
349XXX Any significant changes to the testing of a freshly built perl should be
350listed here. Changes which create B<new> files in F<t/> go here as do any
351large changes to the testing harness (e.g. when parallel testing was added).
352Changes to existing files in F<t/> aren't worth summarizing, although the bugs
353that they represent may be covered elsewhere.
f83db990 354
af8a293f
SL
355[ List each test improvement as a =item entry ]
356
357=over 4
eabfc7bc 358
0dafb1ce 359=item *
eabfc7bc 360
af8a293f 361XXX
5ea25977 362
b26bd9b0 363=back
5ea25977 364
6c83150b
A
365=head1 Platform Support
366
02dd1325
CB
367=head2 Platform-Specific Notes
368
369=over 4
370
371=item VMS
372
373=over
374
375=item *
af8a293f 376
02dd1325
CB
377For those C<%ENV> elements based on the CRTL environ array, we've always
378preserved case when setting them but did look-ups only after upcasing the
379key first, which made lower- or mixed-case entries go missing. This problem
380has been corrected by making C<%ENV> elements derived from the environ array
381case-sensitive on look-up as well as case-preserving on store.
382
383=item *
384
385Environment look-ups for C<PERL5LIB> and C<PERLLIB> previously only
386considered logical names, but now consider all sources of C<%ENV> as
387determined by C<PERL_ENV_TABLES> and as documented in L<perlvms/%ENV>.
388
389=back
390
391=back
af8a293f
SL
392
393=head2 New Platforms
394
395XXX List any platforms that this version of perl compiles on, that previous
396versions did not. These will either be enabled by new files in the F<hints/>
397directories, or new subdirectories and F<README> files at the top level of the
398source tree.
0517ed38 399
6c83150b 400=over 4
0517ed38 401
af8a293f 402=item XXX-some-platform
b3d7d865 403
af8a293f 404XXX
b3d7d865 405
af8a293f 406=back
d9d208b8 407
af8a293f 408=head2 Discontinued Platforms
48fbd301 409
af8a293f 410XXX List any platforms that this version of perl no longer compiles on.
48fbd301 411
af8a293f 412=over 4
f4240379 413
af8a293f 414=item XXX-some-platform
f4240379 415
af8a293f 416XXX
6c83150b 417
1d6d94ad
DG
418=back
419
af8a293f
SL
420=head2 Platform-Specific Notes
421
422XXX List any changes for specific platforms. This could include configuration
423and compilation changes or changes in portability/compatibility. However,
424changes within modules for platforms should generally be listed in the
425L</Modules and Pragmata> section.
d89ea360 426
054383b6 427=over 4
0efe3111 428
022b5ce0 429=item Win32
0efe3111 430
022b5ce0
TC
431Builds using Microsoft Visual C++ 2003 and earlier no longer produce
432an "INTERNAL COMPILER ERROR" message. [perl #126045]
206e921d 433
af8a293f 434=back
206e921d 435
af8a293f 436=head1 Internal Changes
d9d208b8 437
af8a293f
SL
438XXX Changes which affect the interface available to C<XS> code go here. Other
439significant internal changes for future core maintainers should be noted as
440well.
441
442[ List each change as a =item entry ]
d9d208b8 443
af8a293f 444=over 4
d9d208b8
DG
445
446=item *
447
d7745c5b
DM
448The implementation of perl's context stack system, and its internal API,
449have been heavily reworked. Note that no significant changes have been
d7c7f8cb 450made to any external APIs, but XS code which relies on such internal
d7745c5b
DM
451details may need to be fixed. The main changes are:
452
453=over 4
454
455=item *
456
457The C<PUSHBLOCK()>, C<POPSUB()> etc. macros have been replaced with static
458inline functions such as C<cx_pushblock()>, C<cx_popsub()> etc. These use
459function args rather than implicitly relying on local vars such as
460C<gimme> and C<newsp> being available. Also their functionality has
461changed: in particular, C<cx_popblock()> no longer decrements
462C<cxstack_ix>. The ordering of the steps in the C<pp_leave*> functions
463involving C<cx_popblock()>, C<cx_popsub()> etc. has changed. See the new
464documentation, L<perlguts/"Dynamic Scope and the Context Stack">, for
465details on how to use them.
466
467=item *
468
469Various macros, which now consistently have a CX_ prefix, have been added:
470
df539208 471 CX_CUR(), CX_LEAVE_SCOPE(), CX_POP()
d7745c5b
DM
472
473or renamed:
474
df539208 475 CX_POP_SAVEARRAY(), CX_DEBUG(), CX_PUSHSUBST(), CX_POPSUBST()
d7745c5b
DM
476
477=item *
478
479C<cx_pushblock()> now saves C<PL_savestack_ix> and C<PL_tmps_floor>, so
480CMpp_enter*> and C<pp_leave*> no longer do
481
482 ENTER; SAVETMPS; ....; LEAVE
483
484=item *
485
486C<cx_popblock()> now also restores C<PL_curpm>.
487
488=item *
489
490In C<dounwind()> for every context type, the current savestack frame is
d7c7f8cb 491now processed before each context is popped; formerly this was only done
d7745c5b
DM
492for sub-like context frames. This action has been removed from
493C<cx_popsub()> and placed into its own macro, C<CX_LEAVE_SCOPE(cx)>, which
494must be called before C<cx_popsub()> etc.
495
496C<dounwind()> now also does a C<cx_popblock()> on the last popped frame
497(formerly it only did the C<cx_popsub()> etc. actions on each frame).
498
499=item *
500
501The temps stack is now freed on scope exit; previously, temps created
502during the last statement of a block wouldn't be freed until the next
503C<nextstate> following the block (apart from an existing hack that did
504this for recursive subs in scalar context); and in something like
505C<f(g())>, the temps created by the last statement in C<g()> would
506formerly not be freed until the statement following the return from
507C<f()>.
508
509=item *
510
511Most values that were saved on the savestack on scope entry are now
512saved in suitable new fields in the context struct, and saved and
513restored directly by C<cx_pushfoo()> and C<cx_popfoo()>, which is much
514faster.
515
516=item *
517
518Various context struct fields have been added, removed or modified.
519
520=item *
521
522The handling of C<@_> in C<cx_pushsub()> and C<cx_popsub()> has been
523considerably tidied up, including removing the C<argarray> field from the
524context struct, and extracting out some common (but rarely used) code into
525a separate function, C<clear_defarray()>. Also, useful subsets of
526C<cx_popsub()> which had been unrolled in places like C<pp_goto> have been
527gathered into the new functions C<cx_popsub_args()> and
528C<cx_popsub_common()>.
529
530=item *
531
532C<pp_leavesub> and C<pp_leavesublv> now use the same function as the rest
533of the C<pp_leave*>'s to process return args.
534
535=item *
536
537C<CXp_FOR_PAD> and C<CXp_FOR_GV> flags have been added, and
538C<CXt_LOOP_FOR> has been split into C<CXt_LOOP_LIST>, C<CXt_LOOP_ARY>.
539
540=item *
541
542Some variables formerly declared by C<dMULTICALL> (but not documented) have
543been removed.
544
545=back
546
d9d208b8 547
d89ea360
DD
548=back
549
b26bd9b0 550=head1 Selected Bug Fixes
eabfc7bc 551
af8a293f
SL
552XXX Important bug fixes in the core language are summarized here. Bug fixes in
553files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
acedda6e 554
af8a293f 555[ List each fix as a =item entry ]
bc5be890 556
af8a293f 557=over 4
acedda6e 558
c7052e96
TC
559=item *
560
2ff6ae51 561Line numbers larger than 2**31-1 but less than 2**32 are no longer
d15ad02e 562returned by caller() as negative numbers. [perl #126991]
c7052e96 563
2ff6ae51
TC
564=item *
565
566C<< unless ( I<assignment> ) >> now properly warns when syntax
567warnings are enabled. [perl #127122]
568
42d92f4a
TC
569=item *
570
571Setting an C<ISA> glob to an array reference now properly adds
572C<isaelem> magic to any existing elements. Previously modifying such
573an element would not update the ISA cache, so method calls would call
574the wrong function. Perl would also crash if the C<ISA> glob was
575destroyed, since new code added in 5.23.7 would try to release the
576C<isaelem> magic from the elements. [perl #127351]
577
19b46ab5
TC
578=item *
579
580If a here-doc was found while parsing another operator, the parser had
581already read end of file, and the here-doc was not terminated, perl
582could produce an assertion or a segmentation fault. This now reliably
583complains about the unterminated here-doc. [perl #125540]
584
23b4d8d6
TC
585=item *
586
587untie() would sometimes return the last value returned by the UNTIE()
588handler as well as it's normal value, messing up the stack. [perl
589#126621]
590
002a7765
TC
591=item *
592
593Fixed an operator precedence problem when C< castflags & 2> is true.
594[perl #127474]
595
84279daf
TC
596=item *
597
598Caching of DESTROY methods could result in a non-pointer or a
599non-STASH stored in the SvSTASH() slot of a stash, breaking the B
600STASH() method. The DESTROY method is now cached in the MRO metadata
601for the stash. [perl #126410]
602
603=item *
604
0000ba0d
TC
605The AUTOLOAD method is now called when searching for a DESTROY method,
606and correctly sets C<$AUTOLOAD> too. [perl #124387] [perl #127494]
84279daf 607
54e70d91
TC
608=item *
609
610Avoid parsing beyond the end of the buffer when processing a C<#line>
611directive with no filename. [perl #127334]
612
46d34d0e
KW
613=item *
614
615Perl now raises a warning when a regular expression pattern looks like
616it was supposed to contain a POSIX class, like C<qr/[[:alpha:]]/>, but
617there was some slight defect in its specification which causes it to
618instead be treated as a regular bracketed character class. An example
619would be missing the second colon in the above like this:
620C<qr/[[:alpha]]/>. This compiles to match a sequence of two characters.
621The second is C<"]">, and the first is any of: C<"[">, C<":">, C<"a">,
622C<"h">, C<"l">, or C<"p">. This is unlikely to be the intended
623meaning, and now a warning is raised. No warning is raised unless the
624specification is very close to one of the 14 legal POSIX classes. (See
625L<perlrecharclass/POSIX Character Classes>.)
626[perl #8904]
627
ac33c516
KW
628=item *
629
9857cc20 630Certain regex patterns involving a complemented POSIX class in an
ac33c516
KW
631inverted bracketed character class, and matching something else
632optionally would improperly fail to match. An example of one that could
633fail is C</qr/_?[^\Wbar]\x{100}/>. This has been fixed.
634[perl #127537]
635
9857cc20
S
636=item *
637
638Perl 5.22 added support to the C99 hexadecimal floating point notation,
639but sometimes misparses hex floats. This had been fixed.
640[perl #127183]
641
af8a293f 642=back
3c84cb84 643
af8a293f 644=head1 Known Problems
d005d3c3 645
af8a293f
SL
646XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
647tests that had to be C<TODO>ed for the release would be noted here. Unfixed
648platform specific bugs also go here.
d43e55a3 649
af8a293f 650[ List each fix as a =item entry ]
e685831a 651
af8a293f 652=over 4
e685831a 653
0701ff00
JH
654=item *
655
af8a293f 656XXX
0701ff00 657
054383b6 658=back
d9d208b8 659
af8a293f 660=head1 Errata From Previous Releases
0057cacf
SL
661
662=over 4
663
664=item *
665
af8a293f
SL
666XXX Add anything here that we forgot to add, or were mistaken about, in
667the perldelta of a previous release.
0057cacf
SL
668
669=back
670
af8a293f 671=head1 Obituary
5a74572e 672
af8a293f
SL
673XXX If any significant core contributor has died, we've added a short obituary
674here.
5a74572e 675
af8a293f 676=head1 Acknowledgements
e1ad135d 677
af8a293f 678XXX Generate this with:
e1ad135d 679
af8a293f 680 perl Porting/acknowledgements.pl v5.23.7..HEAD
f5b73711 681
44691e6f
AB
682=head1 Reporting Bugs
683
e08634c5
SH
684If you find what you think is a bug, you might check the articles recently
685posted to the comp.lang.perl.misc newsgroup and the perl bug database at
fc4c3cec
RS
686L<https://rt.perl.org/> . There may also be information at
687L<http://www.perl.org/> , the Perl Home Page.
44691e6f 688
e08634c5
SH
689If you believe you have an unreported bug, please run the L<perlbug> program
690included with your release. Be sure to trim your bug down to a tiny but
691sufficient test case. Your bug report, along with the output of C<perl -V>,
692will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
693
694If the bug you are reporting has security implications, which make it
e08634c5
SH
695inappropriate to send to a publicly archived mailing list, then please send it
696to perl5-security-report@perl.org. This points to a closed subscription
697unarchived mailing list, which includes all the core committers, who will be
698able to help assess the impact of issues, figure out a resolution, and help
f9001595 699co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
700platforms on which Perl is supported. Please only use this address for
701security issues in the Perl core, not for modules independently distributed on
702CPAN.
44691e6f
AB
703
704=head1 SEE ALSO
705
e08634c5
SH
706The F<Changes> file for an explanation of how to view exhaustive details on
707what changed.
44691e6f
AB
708
709The F<INSTALL> file for how to build Perl.
710
711The F<README> file for general stuff.
712
713The F<Artistic> and F<Copying> files for copyright information.
714
715=cut