This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
PATCH: [perl #119601] Bleadperl breaks ETHER/Devel-Declare
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
ba03bc34
SH
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.19.4
e128ab2c 9
4eabcf70 10=head1 DESCRIPTION
6db9054f 11
ba03bc34 12This document describes differences between the 5.19.3 release and the 5.19.4
e08634c5 13release.
6db9054f 14
ba03bc34
SH
15If you are upgrading from an earlier release such as 5.19.2, first read
16L<perl5193delta>, which describes differences between 5.19.2 and 5.19.3.
a3fb66a4 17
ba03bc34 18=head1 Notice
a3fb66a4 19
ba03bc34 20XXX Any important notices here
a3fb66a4 21
ba03bc34 22=head1 Core Enhancements
a3fb66a4 23
ba03bc34
SH
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.
a3fb66a4 27
ba03bc34 28[ List each enhancement as a =head2 entry ]
a3fb66a4 29
ba03bc34 30=head1 Security
a3fb66a4 31
ba03bc34
SH
32XXX Any security-related notices go here. In particular, any security
33vulnerabilities closed should be noted here rather than in the
34L</Selected Bug Fixes> section.
4725e868 35
ba03bc34 36[ List each security issue as a =head2 entry ]
a3fb66a4 37
ba03bc34 38=head1 Incompatible Changes
a3fb66a4 39
e1c60bf3
SH
40=head2 Locale decimal point character no longer leaks outside of
41S<C<use locale>> scope (with the exception of C<$!>)
e46375fa 42
e1c60bf3
SH
43This is actually a bug fix, but some code has come to rely on the bug being
44present, so this change is listed here. The current locale that the program is
45running under is not supposed to be visible to Perl code except within the
46scope of a S<C<use locale>>. However, until now under certain circumstances,
47the character used for a decimal point (often a comma) leaked outside the
48scope.
e46375fa 49
e1c60bf3
SH
50This continues the work released in Perl 5.19.1. It turns out that that did
51not catch all the leaks, including C<printf> and C<sprintf> not respecting
52S<C<use locale>>. If your code is affected by this change, simply add a
53S<C<use locale>>.
e46375fa 54
e1c60bf3
SH
55Now, the only known place where C<'use locale'> is not respected is in the
56stringification of L<$!|perlvar/$!>.
a3fb66a4 57
ba03bc34 58=head1 Deprecations
a3fb66a4 59
ba03bc34 60XXX Any deprecated features, syntax, modules etc. should be listed here.
a3fb66a4 61
ba03bc34 62=head2 Module removals
4725e868 63
ba03bc34 64XXX Remove this section if inapplicable.
669d990b 65
ba03bc34
SH
66The following modules will be removed from the core distribution in a
67future release, and will at that time need to be installed from CPAN.
68Distributions on CPAN which require these modules will need to list them as
69prerequisites.
669d990b 70
ba03bc34
SH
71The core versions of these modules will now issue C<"deprecated">-category
72warnings to alert you to this fact. To silence these deprecation warnings,
73install the modules in question from CPAN.
669d990b 74
ba03bc34
SH
75Note that these are (with rare exceptions) fine modules that you are encouraged
76to continue to use. Their disinclusion from core primarily hinges on their
77necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
78not usually on concerns over their design.
2cf99697 79
ba03bc34 80=over
2cf99697 81
ba03bc34
SH
82XXX Note that deprecated modules should be listed here even if they are listed
83as an updated module in the L</Modules and Pragmata> section.
21d55435 84
ba03bc34 85=back
0f0eae2c 86
ba03bc34 87[ List each other deprecation as a =head2 entry ]
21d55435 88
ba03bc34 89=head1 Performance Enhancements
a3fb66a4 90
ba03bc34 91=over 4
a3fb66a4 92
2c99af42
SH
93=item *
94
e1c60bf3
SH
95The trie performance enhancement for regular expressions has now been extended
96to those compiled under C</iaa>.
2c99af42 97
c0ca71c9 98=back
42bff0d9 99
ba03bc34 100=head1 Modules and Pragmata
195e3ea0 101
ba03bc34
SH
102XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
103go here. If Module::CoreList is updated, generate an initial draft of the
104following sections using F<Porting/corelist-perldelta.pl>, which prints stub
105entries to STDOUT. Results can be pasted in place of the '=head2' entries
106below. A paragraph summary for important changes should then be added by hand.
107In an ideal world, dual-life modules would have a F<Changes> file that could be
108cribbed.
195e3ea0 109
ba03bc34 110[ Within each section, list entries as a =item entry ]
195e3ea0 111
ba03bc34 112=head2 New Modules and Pragmata
195e3ea0
SH
113
114=over 4
115
116=item *
117
ba03bc34 118XXX
195e3ea0
SH
119
120=back
121
ba03bc34 122=head2 Updated Modules and Pragmata
42bff0d9 123
38663f11 124=over 4
42bff0d9
DG
125
126=item *
127
8c24c1f7 128L<B> has been upgraded from version 1.45 to 1.46.
00c5962f
TC
129
130The fix for [perl #118525] introduced a regression in the behaviour of
e1c60bf3
SH
131C<B::CV::GV>, changing the return value from a C<B::SPECIAL> object on a
132C<NULL> C<CvGV> to C<undef>. C<B::CV::GV> again returns a C<B::SPECIAL>
133object in this case. [perl #119351]
00c5962f
TC
134
135=item *
136
8c24c1f7
SH
137L<B::Concise> has been upgraded from version 0.98 to 0.99.
138
5b903226 139The handling of the C<glob> operator, broken since Perl 5.17.6, has been fixed.
8c24c1f7
SH
140
141=item *
142
d5dcec3a
Z
143L<Carp> has been upgraded from version 1.31 to 1.32.
144
6ffbec2c
Z
145=over 4
146
147=item *
148
e1c60bf3
SH
149In stack traces, subroutine arguments that are strings are now quoted in a
150consistent manner, regardless of what characters they contain and how they're
151internally represented.
6ffbec2c
Z
152
153=item *
154
bf4588d0 155C<Carp> now won't vivify the C<overload::StrVal> glob or subroutine or the
bd098b9a 156C<overload> stash.
6ffbec2c
Z
157
158=item *
159
e1c60bf3
SH
160C<Carp> now avoids some unwanted Unicode warnings on older Perls. This doesn't
161affect behaviour with current Perl.
6ffbec2c
Z
162
163=item *
164
e1c60bf3
SH
165C<Carp::Heavy> detects version mismatch with C<Carp>, to give a good error
166message if a current (stub) C<Carp::Heavy> gets loaded by an old C<Carp> that
167expects C<Carp::Heavy> to provide subroutines.
d5dcec3a 168
6ffbec2c
Z
169=back
170
c963f488
SH
171=item *
172
202c41cb
SH
173L<CPAN::Meta::Requirements> has been upgraded from version 2.122 to 2.123.
174
e1c60bf3
SH
175No changes have been made to the installed code other than the version bump to
176keep in sync with the latest CPAN release.
202c41cb
SH
177
178=item *
179
8c24c1f7
SH
180L<Data::Dumper> has been upgraded from version 2.148 to 2.149.
181
5b903226
SH
182This upgrade is part of a larger change to make the array interface 64-bit safe
183by using SSize_t instead of I32 for array indices.
8c24c1f7
SH
184
185=item *
186
187L<Devel::Peek> has been upgraded from version 1.13 to 1.14.
188
5b903226
SH
189This upgrade is part of a larger change to preserve referential identity when
190passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
191nonexistent array elements.
8c24c1f7
SH
192
193=item *
194
195L<DynaLoader> has been upgraded from version 1.19 to 1.20.
196
5b903226
SH
197The documentation now makes it clear, as has always been the case, that
198C<dl_unload_file> is only called automatically to unload all loaded shared
199objects if the perl interpreter was built with the C macro
b228daaa 200DL_UNLOAD_ALL_AT_EXIT defined. Support for GNU DLD has also been removed.
5b903226
SH
201
202=item *
203
f2c09143
SH
204L<Encode> has been upgraded from version 2.52 to 2.54.
205
206An erroneous early return in C<decode_utf8> has been removed, and a bug in
207C<_utf8_on> under COW has been fixed.
208
209=item *
210
5b903226
SH
211L<ExtUtils::MakeMaker> has been upgraded from version 6.72 to 6.74.
212
213Numerous updates and bug fixes are incorporated. See the F<Changes> file for
214full details.
8c24c1f7
SH
215
216=item *
217
f2c09143
SH
218L<ExtUtils::ParseXS> has been upgraded from version 3.21 to 3.22.
219
220No changes have been made other than the version bump to keep in sync with the
221latest CPAN release.
222
223=item *
224
610ee5e3
TC
225L<File::Glob> has been upgraded from version 1.20 to 1.21.
226
e1c60bf3
SH
227C<glob()> now warns in the context of C<use warnings "syscalls";> if the
228supplied pattern has an internal NUL (C<"\0">) character.
610ee5e3 229
d5dcec3a
Z
230=item *
231
e1c60bf3 232L<IPC::Open3> has been upgraded from version 1.15 to 1.16.
8c24c1f7 233
5b903226
SH
234This upgrade is part of a larger change to preserve referential identity when
235passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
236nonexistent array elements.
8c24c1f7
SH
237
238=item *
239
a0109759
SH
240L<Locale::Codes> has been upgraded from version 3.26 to 3.27.
241
242New codes have been added and the (deprecated) set of FIPS-10 country codes has
243been removed.
244
245=item *
246
a8479f0e
TC
247L<Math::BigInt> has been upgraded from version 1.9992 to 1.9993.
248
e1c60bf3
SH
249Cleaned up the L<Math::BigInt> and L<Math::BigFloat> documentation to be more
250consistent with other perl documentation. [perl #86686]
a8479f0e
TC
251
252Added a bint() method for rounding towards zero. [perl #85296]
253
254=item *
255
8c24c1f7
SH
256L<Math::BigInt::FastCalc> has been upgraded from version 0.30 to 0.31.
257
5b903226
SH
258This upgrade is part of a larger change to make the array interface 64-bit safe
259by using SSize_t instead of I32 for array indices.
8c24c1f7
SH
260
261=item *
262
37287258
SH
263L<Module::CoreList> has been upgraded from version 2.97 to 2.98.
264
265The list of Perl versions covered has been updated.
1fdd5e53 266
68cdd4b5
SH
267=item *
268
6c52f6c9 269L<Module::Load::Conditional> has been upgraded from version 0.54 to 0.58.
0022aab5
SH
270
271C<requires> has been made more robust. [cpan #83728]
272
273=item *
274
68cdd4b5
SH
275L<Module::Metadata> has been upgraded from version 1.000014 to 1.000016.
276
277The module's DESCRIPTION has been re-worded regarding safety/security to
278satisfy CVE-2013-1437.
279
93f72154
SH
280=item *
281
e1c60bf3 282L<mro> has been upgraded from version 1.13 to 1.14.
8c24c1f7 283
5b903226
SH
284This upgrade is part of a larger change to make the array interface 64-bit safe
285by using SSize_t instead of I32 for array indices.
8c24c1f7
SH
286
287=item *
288
e1c60bf3
SH
289L<parent> has been upgraded from version 0.226 to 0.227.
290
291No changes have been made to the installed code other than the version bump to
292keep in sync with the latest CPAN release.
293
294=item *
295
8c24c1f7 296L<Perl::OSType> has been upgraded from version 1.003 to 1.004.
93f72154
SH
297
298The Unix OSType 'bitrig' has been added.
299
8c24c1f7
SH
300=item *
301
302L<re> has been upgraded from version 0.25 to 0.26.
303
5b903226 304A function signature has been corrected in the XS implementation.
8c24c1f7
SH
305
306=item *
307
e1c60bf3
SH
308L<Scalar::Util> has been upgraded from version 1.31 to 1.32.
309
310The documentation of C<blessed> has been improved to mention the fact that
311package "0" is defined but false.
312
313=item *
314
406cccc2
SH
315L<Socket> has been upgraded from version 2.011 to 2.012.
316
317Syntax errors when building on the WinCE platform have been fixed. [cpan #87389]
318
319=item *
320
8c24c1f7
SH
321L<Storable> has been upgraded from version 2.46 to 2.47.
322
5b903226
SH
323This upgrade is part of a larger change to preserve referential identity when
324passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
325nonexistent array elements.
8c24c1f7
SH
326
327=item *
328
60f577e0
SH
329L<Unicode::Collate> has been upgraded from version 0.98 to 0.99.
330
e1c60bf3
SH
331By default, out-of-range values are replaced with C<U+FFFD> (REPLACEMENT
332CHARACTER) when C<UCA_Version> E<gt>= 22, or ignored when C<UCA_Version> E<lt>=
33320. When C<UCA_Version> E<gt>= 22, the weights of out-of-range values can be
334overridden.
60f577e0
SH
335
336=item *
337
5565c738
SH
338L<version> has been upgraded from version 0.9903 to 0.9904.
339
340No changes have been made to the installed code other than the version bump to
341keep in sync with the latest CPAN release.
342
343=item *
344
8c24c1f7
SH
345L<warnings> has been upgraded from version 1.18 to 1.19.
346
5b903226 347The C<syscalls> warnings category has been added to check for embedded NUL
b8f07b9f 348(C<"\0">) characters in pathnames and string arguments to other system calls.
8c24c1f7
SH
349
350=item *
351
352L<XS::Typemap> has been upgraded from version 0.10 to 0.11.
353
583aa5c2
RS
354=back
355
ba03bc34 356=head2 Removed Modules and Pragmata
a3fb66a4
SH
357
358=over 4
359
360=item *
361
ba03bc34 362XXX
a3fb66a4
SH
363
364=back
365
ba03bc34 366=head1 Documentation
8fecfff0 367
ba03bc34
SH
368XXX Changes to files in F<pod/> go here. Consider grouping entries by
369file and be sure to link to the appropriate page, e.g. L<perlfunc>.
8fecfff0 370
ba03bc34 371=head2 New Documentation
8fecfff0 372
ba03bc34 373XXX Changes which create B<new> files in F<pod/> go here.
195e3ea0 374
ba03bc34 375=head3 L<XXX>
195e3ea0 376
ba03bc34 377XXX Description of the purpose of the new file here
195e3ea0 378
ba03bc34 379=head2 Changes to Existing Documentation
195e3ea0 380
ba03bc34
SH
381XXX Changes which significantly change existing files in F<pod/> go here.
382However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
383section.
195e3ea0 384
ba03bc34 385=head3 L<XXX>
a3fb66a4
SH
386
387=over 4
388
389=item *
390
ba03bc34 391XXX Description of the change here
a3fb66a4
SH
392
393=back
394
c0ca71c9
AP
395=head1 Diagnostics
396
397The following additions or changes have been made to diagnostic output,
398including warnings and fatal error messages. For the complete list of
399diagnostic messages, see L<perldiag>.
400
ba03bc34
SH
401XXX New or changed warnings emitted by the core's C<C> code go here. Also
402include any changes in L<perldiag> that reconcile it to the C<C> code.
403
c0ca71c9
AP
404=head2 New Diagnostics
405
ba03bc34
SH
406XXX Newly added diagnostic messages go under here, separated into New Errors
407and New Warnings
408
12dcbffb 409=head3 New Errors
583aa5c2 410
38663f11 411=over 4
583aa5c2 412
b8a02ff1 413=item *
583aa5c2 414
ba03bc34 415XXX L<message|perldiag/"message">
583aa5c2 416
b8a02ff1 417=back
583aa5c2 418
12dcbffb 419=head3 New Warnings
96d496e4 420
38663f11 421=over 4
b8a02ff1
DG
422
423=item *
424
610ee5e3
TC
425L<Invalid \0 character in %s for %s: %s\0%s|perldiag/"Invalid \0 character in %s for %s: %s\0%s">
426
b8f07b9f
SH
427(W syscalls) Embedded \0 characters in pathnames or other system call arguments
428produce a warning as of 5.20. The parts after the \0 were formerly ignored by
429system calls.
487a71ff 430
12dcbffb 431=back
1310e590 432
ba03bc34
SH
433=head2 Changes to Existing Diagnostics
434
435XXX Changes (i.e. rewording) of diagnostic messages go here
e727f86a 436
12dcbffb 437=over 4
e727f86a 438
81ca6d44
FC
439=item *
440
ba03bc34 441XXX Describe change here
e38fc308 442
ba03bc34 443=back
a34da6c4 444
ba03bc34 445=head1 Utility Changes
a34da6c4 446
ba03bc34
SH
447XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
448Most of these are built within the directories F<utils> and F<x2p>.
558673e6 449
ba03bc34
SH
450[ List utility changes as a =head3 entry for each utility and =item
451entries for each change
452Use L<XXX> with program names to get proper documentation linking. ]
558673e6 453
b2d74da6 454=head3 L<find2perl>
47a7c93d 455
12dcbffb 456=over 4
b5a80c26 457
7f1d4316
FC
458=item *
459
f1c106f5 460L<find2perl> now handles C<?> wildcards correctly. [perl #113054]
7f1d4316 461
ba03bc34 462=back
ef947715 463
ba03bc34 464=head1 Configuration and Compilation
ef947715 465
ba03bc34
SH
466XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
467go here. Any other changes to the Perl build process should be listed here.
468However, any platform-specific changes should be listed in the
469L</Platform Support> section, instead.
02bef66e 470
ba03bc34 471[ List changes as a =item entry ].
d30fb844 472
12dcbffb 473=over 4
21c01741 474
467582e8
FC
475=item *
476
e1c60bf3
SH
477The F<Makefile.PL> for C<SDBM_File> now generates a better F<Makefile>, which
478avoids a race condition during parallel makes, which could cause the build to
479fail. This is the last known parallel make problem (on *nix platforms), and
480therefore we believe that a parallel make should now always be error free.
4d106cc5
NC
481
482=for comment
483
484Strictly only for a build where build files such as F<Makefile.SH> have not
485been updated by C<git> in an already configured and built tree.
467582e8 486
ba03bc34 487=back
64da853d 488
ba03bc34 489=head1 Testing
8847717e 490
ba03bc34
SH
491XXX Any significant changes to the testing of a freshly built perl should be
492listed here. Changes which create B<new> files in F<t/> go here as do any
493large changes to the testing harness (e.g. when parallel testing was added).
494Changes to existing files in F<t/> aren't worth summarizing, although the bugs
495that they represent may be covered elsewhere.
8847717e 496
ba03bc34 497[ List each test improvement as a =item entry ]
f1b856da 498
ba03bc34 499=over 4
f1b856da 500
eaed284b
FC
501=item *
502
5b903226 503The test script F<t/bigmem/regexp.t> has been added to test that regular
28f52e64 504expression matches on very large strings now succeed as expected.
8c24c1f7
SH
505
506=item *
507
5b903226
SH
508Various cases of C<die>, C<last>, C<goto> and C<exit> triggering C<DESTROY> are
509now tested by the new test script F<t/op/rt119311.t>.
8c24c1f7
SH
510
511=item *
512
5b903226
SH
513The new test script F<t/win32/signal.t> tests that C<$!> and C<$^E> are now
514preserved across signal handlers by the Win32 signal emulation code.
8c24c1f7
SH
515
516=item *
517
5b903226
SH
518The test script F<t/x2p/find2perl.t> has been added to test the F<find2perl>
519program on platforms where it is practical to do so.
eaed284b 520
ba03bc34 521=back
0335212c 522
ba03bc34 523=head1 Platform Support
0335212c 524
ba03bc34 525XXX Any changes to platform support should be listed in the sections below.
c3e455cf 526
ba03bc34
SH
527[ Within the sections, list each platform as a =item entry with specific
528changes as paragraphs below it. ]
c3e455cf 529
ba03bc34 530=head2 New Platforms
019705bc 531
ba03bc34
SH
532XXX List any platforms that this version of perl compiles on, that previous
533versions did not. These will either be enabled by new files in the F<hints/>
534directories, or new subdirectories and F<README> files at the top level of the
535source tree.
019705bc 536
ba03bc34 537=over 4
25921d77 538
44d412d1 539=item Bitrig
25921d77 540
44d412d1 541Compile support has been added for Bitrig, a fork of OpenBSD
28ea507e 542
ba03bc34 543=back
28ea507e 544
ba03bc34 545=head2 Discontinued Platforms
28ea507e 546
ba03bc34 547XXX List any platforms that this version of perl no longer compiles on.
28ea507e 548
7b0e9f13
AD
549Configure hints and conditional code for several very old platforms
550has been removed. We have not received reports for these in many years,
551typically not since perl-5.6.0.
552
ba03bc34 553=over 4
074d6753 554
7b0e9f13 555=item AT&T 3b1
074d6753 556
7b0e9f13
AD
557Configure support for the 3b1, also known as the AT&T Unix PC (and the
558similar AT&T 7300), has been removed.
4e5b563d 559
ba03bc34 560=back
4e5b563d 561
ba03bc34 562=head2 Platform-Specific Notes
ee818f56 563
ba03bc34
SH
564XXX List any changes for specific platforms. This could include configuration
565and compilation changes or changes in portability/compatibility. However,
566changes within modules for platforms should generally be listed in the
567L</Modules and Pragmata> section.
ee818f56 568
ba03bc34 569=over 4
c054cc81 570
8c24c1f7 571=item WinCE
c054cc81 572
5b903226
SH
573The building of XS modules has largely been restored. Several still cannot
574(yet) be built but it is now possible to build Perl on WinCE with only a couple
575of further patches (to L<Socket> and L<ExtUtils::MakeMaker>), hopefully to be
576incorporated soon.
efcbb8b2 577
ba03bc34 578=back
efcbb8b2 579
ba03bc34 580=head1 Internal Changes
36813eeb 581
ba03bc34
SH
582XXX Changes which affect the interface available to C<XS> code go here. Other
583significant internal changes for future core maintainers should be noted as
584well.
36813eeb 585
ba03bc34 586[ List each change as a =item entry ]
52937067 587
ba03bc34 588=over 4
52937067 589
6760cac5
FC
590=item *
591
fba42467
NC
592The internal representation has changed for the match variables C<$1>, C<$2>
593I<etc.>, C<$`>, C<$&>, C<$'>, C<${^PREMATCH}>, C<${^MATCH}> and
594C<${^POSTMATCH>. It uses slightly less memory, avoids string comparisons
595and numeric conversions during lookup, and uses 23 fewer lines of C. This
596change should not affect any external code.
671f9ff7 597
ba03bc34 598=back
671f9ff7 599
ba03bc34 600=head1 Selected Bug Fixes
912a9a8f 601
ba03bc34
SH
602XXX Important bug fixes in the core language are summarized here. Bug fixes in
603files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
912a9a8f 604
ba03bc34 605[ List each fix as a =item entry ]
0d25b9d4 606
ba03bc34 607=over 4
0d25b9d4 608
a82207ba
FC
609=item *
610
e1c60bf3 611The value of C<$^E> is now saved across signal handlers on Win32. [perl #85104]
18e2e6cd 612
ba03bc34 613=back
18e2e6cd 614
ba03bc34 615=head1 Known Problems
a82207ba 616
ba03bc34
SH
617XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
618tests that had to be C<TODO>ed for the release would be noted here. Unfixed
619platform specific bugs also go here.
31d5dc65 620
ba03bc34 621[ List each fix as a =item entry ]
31d5dc65 622
ba03bc34 623=over 4
31d5dc65 624
74dac2b5
FC
625=item *
626
ba03bc34 627XXX
74dac2b5 628
ba03bc34 629=back
8fecfff0 630
ba03bc34 631=head1 Obituary
8fecfff0 632
ba03bc34
SH
633XXX If any significant core contributor has died, we've added a short obituary
634here.
d7bfa554 635
583aa5c2 636=head1 Acknowledgements
a75569c0 637
ba03bc34
SH
638XXX Generate this with:
639
640 perl Porting/acknowledgements.pl v5.19.3..HEAD
f5b73711 641
44691e6f
AB
642=head1 Reporting Bugs
643
e08634c5
SH
644If you find what you think is a bug, you might check the articles recently
645posted to the comp.lang.perl.misc newsgroup and the perl bug database at
646http://rt.perl.org/perlbug/ . There may also be information at
647http://www.perl.org/ , the Perl Home Page.
44691e6f 648
e08634c5
SH
649If you believe you have an unreported bug, please run the L<perlbug> program
650included with your release. Be sure to trim your bug down to a tiny but
651sufficient test case. Your bug report, along with the output of C<perl -V>,
652will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
653
654If the bug you are reporting has security implications, which make it
e08634c5
SH
655inappropriate to send to a publicly archived mailing list, then please send it
656to perl5-security-report@perl.org. This points to a closed subscription
657unarchived mailing list, which includes all the core committers, who will be
658able to help assess the impact of issues, figure out a resolution, and help
f9001595 659co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
660platforms on which Perl is supported. Please only use this address for
661security issues in the Perl core, not for modules independently distributed on
662CPAN.
44691e6f
AB
663
664=head1 SEE ALSO
665
e08634c5
SH
666The F<Changes> file for an explanation of how to view exhaustive details on
667what changed.
44691e6f
AB
668
669The F<INSTALL> file for how to build Perl.
670
671The F<README> file for general stuff.
672
673The F<Artistic> and F<Copying> files for copyright information.
674
675=cut