This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Fix miscellaneous missing d_xxx variables in configure.com.
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3670aff5
FC
3=for comment
4Stuff that needs to be done still:
0c2596e5
FC
56136213 [perl #52000] Warn/abort on attempted perl exit
6cccbbce Reap child in case where exception has been thrown
1be66aa5 770502ce [perl #119101] Extraneous warnings in Parse::ErrorString::Perl
2dfcda00 8aa8c2dc Fix RT #41461 (with a test).
3670aff5 9
44691e6f
AB
10=head1 NAME
11
12dcbffb
AP
12[ this is a template for a new perldelta file. Any text flagged as XXX needs
13to be processed before release. ]
14
15perldelta - what is new for perl v5.19.3
e128ab2c 16
4eabcf70 17=head1 DESCRIPTION
6db9054f 18
12dcbffb 19This document describes differences between the 5.19.2 release and the 5.19.3
e08634c5 20release.
6db9054f 21
12dcbffb
AP
22If you are upgrading from an earlier release such as 5.19.1, first read
23L<perl5192delta>, which describes differences between 5.19.1 and 5.19.2.
42bff0d9 24
12dcbffb 25=head1 Notice
42bff0d9 26
12dcbffb 27XXX Any important notices here
42bff0d9 28
12dcbffb 29=head1 Core Enhancements
c0ca71c9 30
12dcbffb
AP
31XXX New core language features go here. Summarize user-visible core language
32enhancements. Particularly prominent performance optimisations could go
33here, but most should go in the L</Performance Enhancements> section.
c0ca71c9 34
12dcbffb 35[ List each enhancement as a =head2 entry ]
c0ca71c9 36
5bb43e77
TC
37=head2 B<-F> now implies B<-a> and B<-a> implies B<-n>
38
39Previously B<-F> without B<-a> was a no-op, and B<-a> without B<-n> or
40B<-p> was a no-op, with this change, if you supply B<-F> then both
41B<-a> and B<-n> are implied and if you supply B<-a> then B<-n> is implied.
42
43You can still use B<-p> for its extra behaviour. [perl #116190]
44
12dcbffb 45=head1 Security
c0ca71c9 46
12dcbffb
AP
47XXX Any security-related notices go here. In particular, any security
48vulnerabilities closed should be noted here rather than in the
49L</Selected Bug Fixes> section.
c0ca71c9 50
12dcbffb 51[ List each security issue as a =head2 entry ]
c0ca71c9 52
12dcbffb 53=head1 Incompatible Changes
c0ca71c9 54
12dcbffb 55XXX For a release on a stable branch, this section aspires to be:
c0ca71c9 56
12dcbffb
AP
57 There are no changes intentionally incompatible with 5.XXX.XXX
58 If any exist, they are bugs, and we request that you submit a
59 report. See L</Reporting Bugs> below.
c0ca71c9 60
12dcbffb 61[ List each incompatible change as a =head2 entry ]
c0ca71c9 62
12dcbffb 63=head1 Deprecations
c0ca71c9 64
12dcbffb 65XXX Any deprecated features, syntax, modules etc. should be listed here.
c0ca71c9 66
12dcbffb 67=head2 Module removals
c0ca71c9 68
12dcbffb 69XXX Remove this section if inapplicable.
c0ca71c9 70
12dcbffb
AP
71The following modules will be removed from the core distribution in a
72future release, and will at that time need to be installed from CPAN.
73Distributions on CPAN which require these modules will need to list them as
74prerequisites.
c0ca71c9 75
12dcbffb
AP
76The core versions of these modules will now issue C<"deprecated">-category
77warnings to alert you to this fact. To silence these deprecation warnings,
78install the modules in question from CPAN.
c0ca71c9 79
12dcbffb
AP
80Note that these are (with rare exceptions) fine modules that you are encouraged
81to continue to use. Their disinclusion from core primarily hinges on their
82necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
83not usually on concerns over their design.
c0ca71c9 84
12dcbffb 85=over
c0ca71c9 86
12dcbffb
AP
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.
c0ca71c9 89
12dcbffb 90=back
c0ca71c9 91
12dcbffb 92[ List each other deprecation as a =head2 entry ]
c0ca71c9 93
12dcbffb 94=head1 Performance Enhancements
c0ca71c9 95
12dcbffb
AP
96XXX Changes which enhance performance without changing behaviour go here.
97There may well be none in a stable release.
c0ca71c9 98
12dcbffb 99[ List each enhancement as a =item entry ]
c0ca71c9 100
12dcbffb 101=over 4
c0ca71c9
AP
102
103=item *
104
12dcbffb 105XXX
c0ca71c9 106
12dcbffb 107=back
70ba8092 108
12dcbffb 109=head1 Modules and Pragmata
42bff0d9 110
12dcbffb
AP
111XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
112go here. If Module::CoreList is updated, generate an initial draft of the
113following sections using F<Porting/corelist-perldelta.pl>, which prints stub
114entries to STDOUT. Results can be pasted in place of the '=head2' entries
115below. A paragraph summary for important changes should then be added by hand.
116In an ideal world, dual-life modules would have a F<Changes> file that could be
117cribbed.
6e4979f3 118
12dcbffb 119[ Within each section, list entries as a =item entry ]
6e4979f3 120
12dcbffb 121=head2 New Modules and Pragmata
6e4979f3 122
12dcbffb 123=over 4
42bff0d9 124
c0ca71c9 125=item *
42bff0d9 126
12dcbffb 127XXX
42bff0d9 128
12dcbffb 129=back
42bff0d9 130
12dcbffb 131=head2 Updated Modules and Pragmata
42bff0d9 132
12dcbffb 133=over 4
42bff0d9 134
c0ca71c9 135=item *
42bff0d9 136
323602af
TC
137L<B> has been upgraded from version 1.44 to 1.45.
138
139Calling the C<GV> method on C<B::CV> objects created from a lexical
140sub would return nonsense, possibly crashing perl. C<GV> now returns
141C<undef> for lexical subs. [perl #118525]
142
143Added the C<NAME_HEK> method to return the name of a lexical sub.
144
145=item *
146
9a743a6d
SH
147L<bignum> has been upgraded from version 0.35 to 0.36.
148
149L<bigrat> wasn't correctly updating an internal variable when C<use>d
150with a C<lib> option.
151
1afc4c90
FC
152=item *
153
1448059e
TC
154L<Carp> has been upgraded from 1.30 to 1.31
155
156L<Carp> now handles objects with string overloads. It also allows objects
157to specify how they appear in the stack dump with a C<CARP_TRACE> method,
158and also allows the user to specify their own formatter for objects without
159C<CARP_TRACE> as well as other references. [perl #92446]
160
9a743a6d
SH
161=item *
162
ef379d05
SH
163L<Compress::Raw::Bzip2> has been upgraded from 2.061 to 2.062.
164
165=item *
166
167L<Compress::Raw::Zlib> has been upgraded from 2.061 to 2.062.
168
169=item *
170
89e01640
SH
171L<Config::Perl::V> has been upgraded from version 0.18 to 0.19.
172
173=item *
174
cffd634c
TC
175L<Data::Dumper> has been upgraded from version 2.147 to 2.148.
176
177The compatbility of the XS implementation with the pure perl version
178under C<Useqq> has been improved. [perl #118933]
42bff0d9 179
2cf99697
TC
180=item *
181
8b0411a9
TC
182L<Devel::Peek> has been upgraded from version 1.12 to 1.13.
183
184The C<SvREFCNT_inc()> and C<SvREFCNT_dec()> functions have been
185removed and C<SvREFCNT()> will now work on non-scalars. [perl #117793]
186
f6e0e5cc
FC
187C<Dump> now checks its arguments at compile time. Both arguments are now
188evaluated in scalar context, with exceptions for @arrays and %hashes,
189allowing aggregates to be dumped directly. The first argument is evaluated
190in rvalue scalar context, allowing rvalue C<pos> and C<substr> to be
191dumped.
192
1547e7b4
FC
193C<fill_mstats> no longer crashes if its argument is not already a string.
194[perl #92260]
195
8b0411a9
TC
196=item *
197
9a743a6d
SH
198L<Exporter> has been upgraded from version 5.68 to 5.69.
199
200L<Exporter> would ignore custom C<$SIG{__WARN__}> handlers in
201C<Exporter::Heavy>. [perl #39739]
202
203=item *
204
ef379d05
SH
205The IO-Compress module collection has been upgraded from 2.061 to 2.062.
206
207=item *
208
c7e51fe7
SH
209L<IPC::Cmd> has been upgraded from version 0.82 to 0.84.
210
211C<run_forked> has various fixes/improvements, L<Socket> is only used where
212needed and a regression introduced in 0.78 has been fixed.
213
214=item *
215
07513bb4 216The libnet module collection has been upgraded from version 1.22 to 1.23.
8723f121
SH
217
218=item *
219
6a9ebaf3 220L<List::Util> has been upgraded from version 1.27 to 1.30
2dc8d725 221
6a9ebaf3
SH
222L<List::Util> now includes C<pairgrep>, C<pairmap>, C<pairs>, C<pairkeys>,
223C<pairvalues> and C<pairfirst> functions that operate on even-sized lists of
224pairs.
2dc8d725
CBW
225
226=item *
227
4725e868
SH
228L<parent> has been upgraded from version 0.225 to 0.226.
229
230=item *
231
669d990b
SH
232L<Socket> has been upgraded from version 2.010 to 2.011.
233
234Handle FreeBSD (or other platforms) returning shorter AF_UNIX sockaddr
235structures due to embedded sun_len. [cpan #86613]
236
237=item *
238
2cf99697
TC
239L<Storable> has been upgraded from version 2.45 to 2.46.
240
241Avoid creating temporary objects for STORABLE_attach when they aren't
242required. [perl #118907]
243
21d55435
SH
244=item *
245
246L<Time::Piece> has been upgraded from version 1.21 to 1.22.
247
c0ca71c9 248=back
42bff0d9 249
12dcbffb 250=head2 Removed Modules and Pragmata
dbd04185 251
38663f11 252=over 4
583aa5c2 253
1fdd5e53
KW
254=item *
255
12dcbffb 256XXX
42bff0d9 257
38663f11 258=back
42bff0d9 259
12dcbffb 260=head1 Documentation
989e4501 261
12dcbffb
AP
262XXX Changes to files in F<pod/> go here. Consider grouping entries by
263file and be sure to link to the appropriate page, e.g. L<perlfunc>.
989e4501 264
12dcbffb 265=head2 New Documentation
989e4501 266
12dcbffb 267XXX Changes which create B<new> files in F<pod/> go here.
42bff0d9 268
12dcbffb 269=head3 L<XXX>
42bff0d9 270
12dcbffb 271XXX Description of the purpose of the new file here
42bff0d9 272
12dcbffb 273=head2 Changes to Existing Documentation
42bff0d9 274
12dcbffb
AP
275XXX Changes which significantly change existing files in F<pod/> go here.
276However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
277section.
42bff0d9 278
3031ec7a 279=head3 L<perlopentut>
42bff0d9 280
38663f11 281=over 4
42bff0d9
DG
282
283=item *
284
3031ec7a
RS
285The C<open> tutorial has been completely rewriten by Tom Christiansen, and now
286focuses on covering only the basics, rather than providing a comprehensive
287reference to all things openable. This rewrite came as the result of a
288vigorous discussion on perl5-porters kicked off by a set of improvements
289written by Alexander Hartmaier to the existing C<perlopentut>. A "more than
290you ever wanted to know about C<open>" document may follow in subsequent
291versions of perl.
1fdd5e53 292
583aa5c2
RS
293=back
294
c0ca71c9
AP
295=head1 Diagnostics
296
297The following additions or changes have been made to diagnostic output,
298including warnings and fatal error messages. For the complete list of
299diagnostic messages, see L<perldiag>.
300
12dcbffb
AP
301XXX New or changed warnings emitted by the core's C<C> code go here. Also
302include any changes in L<perldiag> that reconcile it to the C<C> code.
303
c0ca71c9
AP
304=head2 New Diagnostics
305
12dcbffb
AP
306XXX Newly added diagnostic messages go under here, separated into New Errors
307and New Warnings
308
309=head3 New Errors
583aa5c2 310
38663f11 311=over 4
583aa5c2 312
b8a02ff1 313=item *
583aa5c2 314
12dcbffb 315XXX L<message|perldiag/"message">
583aa5c2 316
b8a02ff1 317=back
583aa5c2 318
12dcbffb 319=head3 New Warnings
96d496e4 320
38663f11 321=over 4
b8a02ff1
DG
322
323=item *
324
3ead5f64 325L<Argument "%s" treated as 0 in increment (++)|perldiag/"Argument
2ff08520 326"%s" treated as 0 in increment (++)">
3ead5f64
FC
327
328(W numeric) The indicated string was fed as an argument to the C<++>
329operator which expects either a number or a string matching
330C</^[a-zA-Z]*[0-9]*\z/>. See L<perlop/Auto-increment and
331Auto-decrement> for details.
96d496e4 332
12dcbffb 333=back
1310e590 334
12dcbffb 335=head2 Changes to Existing Diagnostics
e727f86a 336
12dcbffb 337XXX Changes (i.e. rewording) of diagnostic messages go here
e727f86a 338
12dcbffb 339=over 4
e727f86a 340
81ca6d44
FC
341=item *
342
12dcbffb 343XXX Describe change here
81ca6d44 344
96d496e4
RS
345=back
346
12dcbffb 347=head1 Utility Changes
583aa5c2 348
12dcbffb
AP
349XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
350Most of these are built within the directories F<utils> and F<x2p>.
71e6aba6 351
12dcbffb
AP
352[ List utility changes as a =head3 entry for each utility and =item
353entries for each change
354Use L<XXX> with program names to get proper documentation linking. ]
d5f315e8 355
12dcbffb 356=head3 L<XXX>
e38fc308
NC
357
358=over 4
359
360=item *
361
12dcbffb 362XXX
e38fc308
NC
363
364=back
365
12dcbffb 366=head1 Configuration and Compilation
2426c394 367
12dcbffb
AP
368XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
369go here. Any other changes to the Perl build process should be listed here.
370However, any platform-specific changes should be listed in the
371L</Platform Support> section, instead.
4724da03 372
12dcbffb 373[ List changes as a =item entry ].
583aa5c2 374
38663f11 375=over 4
a34da6c4 376
12dcbffb 377=item *
a34da6c4 378
12dcbffb 379XXX
a34da6c4 380
583aa5c2
RS
381=back
382
12dcbffb 383=head1 Testing
583aa5c2 384
12dcbffb
AP
385XXX Any significant changes to the testing of a freshly built perl should be
386listed here. Changes which create B<new> files in F<t/> go here as do any
387large changes to the testing harness (e.g. when parallel testing was added).
388Changes to existing files in F<t/> aren't worth summarizing, although the bugs
389that they represent may be covered elsewhere.
1de7c8e6 390
12dcbffb 391[ List each test improvement as a =item entry ]
9c800862 392
12dcbffb 393=over 4
aaf54772 394
b7bbd8b6
FC
395=item *
396
12dcbffb 397XXX
b7bbd8b6 398
583aa5c2
RS
399=back
400
12dcbffb 401=head1 Platform Support
d7bfa554 402
12dcbffb 403XXX Any changes to platform support should be listed in the sections below.
81d3ed5a 404
12dcbffb
AP
405[ Within the sections, list each platform as a =item entry with specific
406changes as paragraphs below it. ]
81d3ed5a 407
12dcbffb 408=head2 New Platforms
0b023496 409
12dcbffb
AP
410XXX List any platforms that this version of perl compiles on, that previous
411versions did not. These will either be enabled by new files in the F<hints/>
412directories, or new subdirectories and F<README> files at the top level of the
413source tree.
0b023496 414
12dcbffb 415=over 4
e11f653d 416
12dcbffb 417=item XXX-some-platform
5e0164b2 418
12dcbffb 419XXX
5e0164b2 420
12dcbffb 421=back
e11f653d 422
12dcbffb 423=head2 Discontinued Platforms
8be8cdec 424
12dcbffb 425XXX List any platforms that this version of perl no longer compiles on.
8be8cdec 426
12dcbffb 427=over 4
07a522a5 428
12dcbffb 429=item XXX-some-platform
07a522a5 430
12dcbffb 431XXX
71b4007c 432
12dcbffb 433=back
71b4007c 434
12dcbffb 435=head2 Platform-Specific Notes
f6b1d2f5 436
12dcbffb
AP
437XXX List any changes for specific platforms. This could include configuration
438and compilation changes or changes in portability/compatibility. However,
439changes within modules for platforms should generally be listed in the
440L</Modules and Pragmata> section.
f6b1d2f5 441
12dcbffb 442=over 4
7e4f209b 443
12dcbffb 444=item XXX-some-platform
7e4f209b 445
12dcbffb 446XXX
558673e6 447
12dcbffb 448=back
558673e6 449
12dcbffb 450=head1 Internal Changes
47a7c93d 451
12dcbffb
AP
452XXX Changes which affect the interface available to C<XS> code go here. Other
453significant internal changes for future core maintainers should be noted as
454well.
47a7c93d 455
12dcbffb 456[ List each change as a =item entry ]
b5a80c26 457
12dcbffb 458=over 4
b5a80c26 459
7f1d4316
FC
460=item *
461
6e6c0044
FC
462C<sv_pos_b2u_flags> has been added to the API. It is similar to
463C<sv_pos_b2u>, but supports long strings on 64-bit platforms.
7f1d4316 464
12dcbffb 465=back
02bef66e 466
12dcbffb 467=head1 Selected Bug Fixes
d30fb844 468
12dcbffb
AP
469XXX Important bug fixes in the core language are summarized here. Bug fixes in
470files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
d30fb844 471
12dcbffb 472[ List each fix as a =item entry ]
21c01741 473
12dcbffb 474=over 4
21c01741 475
467582e8
FC
476=item *
477
5c24ac0b
FC
478Autovivifying a subroutine stub via C<\&$glob> started causing crashes in
479Perl 5.18.0 if the $glob was merely a copy of a real glob, i.e., a scalar
480that had had a glob assigned to it. This has been fixed [perl #119051].
467582e8 481
64da853d
FC
482=item *
483
484On 64-bit platforms C<pos> can now be set to a value higher than 2**31-1
485[perl #72766].
486
8847717e
FC
487=item *
488
489Perl used to leak an implementation detail when it came to referencing the
490return values of certain operators. C<for ($a+$b) { warn \$_; warn \$_ }>
491used to display two different memory addresses, because the C<\> operator
492was copying the variable. Under threaded builds, it would also happen for
493constants (C<for(1) { ... }>). This has been fixed [perl #21979, #78194,
494#89188, #109746, #114838, #115388].
495
f1b856da
FC
496=item *
497
498The range operator C<..> was returning the same modifiable scalars with
499each call, unless it was the only thing in a C<foreach> loop header. This
500meant that changes to values within the list returned would be visible the
501next time the operator was executed [perl #3105].
502
eaed284b
FC
503=item *
504
505Constant folding and subroutine inlining no longer cause operations that
506would normally return new modifiable scalars to return read-only values
507instead.
508
0335212c
FC
509=item *
510
511Closures of the form C<sub () { $some_variable }> are no longer inlined,
512causing changes to the variable to be ignored by callers of the subroutine
513[perl #79908].
514
c3e455cf
FC
515=item *
516
517Return values of certain operators such as C<ref> would sometimes be shared
518between recursive calls to the same subroutine, causing the inner call to
519modify the value returned by C<ref> in the outer call. This has been
520fixed.
521
019705bc
FC
522=item *
523
524C<__PACKAGE__> and constants returning a package name or hash key are now
525consistently read-only. In various previous Perl releases, they have
526become mutable under certain circumstances.
527
25921d77
FC
528=item *
529
530C</$qr/p> was broken in Perl 5.18.0; the C</p> flag was ignored. This has
531been fixed [perl #118213].
532
28ea507e
FC
533=item *
534
535Starting in v5.18.0, a construct like C</[#](?{})/x> would have its C<#>
536incorrectly interpreted as a comment. The code block would be skipped,
537unparsed. This has been corrected.
538
539=item *
540
541Starting in Perl 5.001, a regular expression like C</[#$a]/x> or
542C</[#]$a/x> would have its C<#> incorrectly interpreted as a comment, so
543the variable would not interpolate. This has been corrected [perl #45667].
544
074d6753
FC
545=item *
546
547On non-threaded builds, setting C<${"_<filename"}> to a reference or
ac71653f
FC
548typeglob no longer causes C<__FILE__> and some error messages to produce a
549corrupt string, and no longer prevents C<#line> directives in string evals
550from providing the source lines to the debugger. Threaded builds were
ba06688d 551unaffected.
074d6753 552
4e5b563d
FC
553=item *
554
555Enabling "used once" warnings no longer causes crashes on stash
556circularities created at compile time (C<*Foo::Bar::Foo:: = *Foo::>).
557
ee818f56
FC
558=item *
559
560Undef constants used in hash keys (C<use constant u => undef; $h{+u}>) no
561longer produce "uninitialized" warnings at compile time.
562
c054cc81
FC
563=item *
564
565Modifying a substitution target inside the substitution replacement no
566longer causes crashes.
567
efcbb8b2
FC
568=item *
569
570The first statement inside a string eval used to use the wrong pragma setting sometimes during constant folding. C<eval 'uc chr 0xe0'> would randomly choose between Unicode, byte, and locale semantics. This has been
571fixed.
572
36813eeb
FC
573=item *
574
575The handling of return values of @INC filters (subroutines returned by
576subroutines in @INC) has been fixed in various ways. Previously tied
577variables were mishandled, and setting $_ to a reference or typeglob could
578result in crashes.
579
52937067
FC
580=item *
581
582The C<SvPVbyte> XS function has been fixed to work with tied scalars
583returning something other than a string. It used to return utf8 in those
584cases where C<SvPV> would.
585
6760cac5
FC
586=item *
587
588Perl 5.18.0 inadvertently made dereferenced regular expressions
589S<(C<${ qr// }>)> false as booleans. This has been fixed.
590
671f9ff7
FC
591=item *
592
593Perl 5.18.0 inadvertently made C<--> and C<++> crash on dereferenced
594regular expressions, and stopped C<++> from flattening vstrings.
595
912a9a8f
FC
596=item *
597
598C<bless> no longer dies with "Can't bless non-reference value" if its first
599argument is a tied reference.
600
0d25b9d4
FC
601=item *
602
603C<reset> with an argument no longer skips copy-on-write scalars, regular
604expressions, typeglob copies, and vstrings. Also, when encountering those
605or read-only values, it no longer skips any array or hash with the same
606name.
607
a82207ba
FC
608=item *
609
18e2e6cd
FC
610C<reset> with an argument now skips scalars aliased to typeglobs
611(C<for $z (*foo) { reset "z" }>). Previously it would corrupt memory or
612crash.
613
614=item *
615
a82207ba
FC
616C<ucfirst> and C<lcfirst> were not respecting the bytes pragma. This was a
617regression from v5.12 [perl #117355].
618
31d5dc65
DM
619=item *
620
621The use of C<\G> in regular expressions, where it's not at the start of
622the pattern, is now slightly less buggy (although it is still somewhat
623problematic).
624
625=item *
626
627Where a regular expression included code blocks (C</(?{...})/>), and where
628the use of constant overloading triggered a re-compilation of the code block,
629the second compilation didn't see its outer lexical scope. This was a
630regression in 5.18.0.
631
38663f11 632=back
d7bfa554 633
38663f11 634=head1 Known Problems
6810f0ad 635
12dcbffb
AP
636XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
637tests that had to be C<TODO>ed for the release would be noted here. Unfixed
638platform specific bugs also go here.
639
640[ List each fix as a =item entry ]
641
38663f11 642=over 4
14fd9356
FC
643
644=item *
645
12dcbffb 646XXX
0e417e4d 647
38663f11 648=back
583aa5c2 649
12dcbffb
AP
650=head1 Obituary
651
652XXX If any significant core contributor has died, we've added a short obituary
653here.
654
583aa5c2 655=head1 Acknowledgements
a75569c0 656
12dcbffb
AP
657XXX Generate this with:
658
659 perl Porting/acknowledgements.pl v5.19.2..HEAD
f5b73711 660
44691e6f
AB
661=head1 Reporting Bugs
662
e08634c5
SH
663If you find what you think is a bug, you might check the articles recently
664posted to the comp.lang.perl.misc newsgroup and the perl bug database at
665http://rt.perl.org/perlbug/ . There may also be information at
666http://www.perl.org/ , the Perl Home Page.
44691e6f 667
e08634c5
SH
668If you believe you have an unreported bug, please run the L<perlbug> program
669included with your release. Be sure to trim your bug down to a tiny but
670sufficient test case. Your bug report, along with the output of C<perl -V>,
671will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
672
673If the bug you are reporting has security implications, which make it
e08634c5
SH
674inappropriate to send to a publicly archived mailing list, then please send it
675to perl5-security-report@perl.org. This points to a closed subscription
676unarchived mailing list, which includes all the core committers, who will be
677able to help assess the impact of issues, figure out a resolution, and help
f9001595 678co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
679platforms on which Perl is supported. Please only use this address for
680security issues in the Perl core, not for modules independently distributed on
681CPAN.
44691e6f
AB
682
683=head1 SEE ALSO
684
e08634c5
SH
685The F<Changes> file for an explanation of how to view exhaustive details on
686what changed.
44691e6f
AB
687
688The F<INSTALL> file for how to build Perl.
689
690The F<README> file for general stuff.
691
692The F<Artistic> and F<Copying> files for copyright information.
693
694=cut