This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
fix typos
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
2ff1ebfe 5perldelta - what is new for perl v5.21.9
c68523cb 6
238894db 7=head1 DESCRIPTION
c68523cb 8
2ff1ebfe 9This document describes differences between the 5.21.8 release and the 5.21.9
238894db 10release.
c68523cb 11
2ff1ebfe
MH
12If you are upgrading from an earlier release such as 5.21.7, first read
13L<perl5218delta>, which describes differences between 5.21.7 and 5.21.8.
2ec11c70 14
b5d4d3b9 15=head1 Notice
2ec11c70 16
cd7bac54
S
17With this release we are now in the user-visible changes portion of the code
18freeze as we prepare for the next stable release of Perl 5.
67f2cc75 19
b5d4d3b9 20=head1 Core Enhancements
67f2cc75 21
64935bc6
KW
22=head2 qr/\b{gcb}/ is now handled in regular expressions
23
24C<gcb> stands for Grapheme Cluster Boundary. It is a Unicode property
25that finds the boundary between sequences of characters that look like a
26single character to a native speaker of a language. Perl has long had
27the ability to deal with these through the C<\X> regular escape
28sequence. Now, there is an alternative way of handling these. See
29L<perlrebackslash/\b{}, \b, \B{}, \B> for details.
25941dca 30
ae3bb8ea
KW
31=head2 qr/\b{wb}/ is now handled in regular expressions
32
33C<wb> stands for Word Boundary. It is a Unicode property
34that finds the boundary between words. This is similar to the plain
35C<\b> (without braces) but is more suitable for natural language
36processing. It knows, for example that apostrophes can occur in the
37middle of words. See L<perlrebackslash/\b{}, \b, \B{}, \B> for details.
38
06ae2722
KW
39=head2 qr/\b{sb}/ is now handled in regular expressions
40
41C<sb> stands for Sentence Boundary. It is a Unicode property
42to aid in parsing natural language sentences.
43See L<perlrebackslash/\b{}, \b, \B{}, \B> for details.
156f41cf
FC
44
45=head2 New bitwise operators
46
47A new experimental facility has been added that makes the four standard
48bitwise operators (C<& | ^ ~>) treat their operands consistently as
49numbers, and introduces four new dotted operators (C<&. |. ^. ~.>) that
50treat their operands consistently as strings. The same applies to the
51assignment variants (C<&= |= ^= &.= |.= ^.=>).
52
53To use this, enable the "bitwise" feature and disable the
54"experimental::bitwise" warnings category. See L<perlop/Bitwise String
cd7bac54 55Operators> for details. [rt.perl.org #123466]
06ae2722 56
cd7bac54 57=head2 C<no re> covers more and is lexical
25941dca 58
cd7bac54
S
59Previously running C<no re> would only turn off a few things. Now it
60turns off all the enabled things. For example, previously, you
61couldn't turn off debugging, once enabled, inside the same block.
48c4d243 62
b5d4d3b9 63=head1 Incompatible Changes
ef8784b7 64
cd7bac54
S
65There are no changes intentionally incompatible with 5.21.8.
66If any exist, they are bugs, and we request that you submit a
67report. See L</Reporting Bugs> below.
541e1e0d 68
2ff1ebfe 69=head1 Performance Enhancements
541e1e0d 70
2ff1ebfe 71=over 4
541e1e0d
MH
72
73=item *
74
2ff1ebfe 75XXX
541e1e0d 76
2ff1ebfe 77=back
541e1e0d 78
2ff1ebfe 79=head1 Modules and Pragmata
541e1e0d 80
cd7bac54 81=head2 Updated Modules and Pragmata
541e1e0d 82
2ff1ebfe 83=over 4
541e1e0d
MH
84
85=item *
86
cd7bac54 87L<attributes> has been upgraded from version 0.25 to 0.26.
541e1e0d 88
cd7bac54 89=item *
541e1e0d 90
cd7bac54 91L<B> has been upgraded from version 1.55 to 1.56.
541e1e0d 92
cd7bac54
S
93=item *
94
95L<B::Debug> has been upgraded from version 1.22 to 1.23.
541e1e0d
MH
96
97=item *
98
cd7bac54
S
99L<B::Deparse> has been upgraded from version 1.32 to 1.33.
100
101=over 4
6c8457e9
S
102
103=item *
104
cd7bac54 105Deparse now provides a defined state sub in inner subs.
897dbee7
TC
106
107=item *
108
cd7bac54
S
109Since version Perl 5.21.6, Deparse would croak on special constants, but
110this has now been fixed.
111
112=back
6c8457e9
S
113
114=item *
115
116L<Benchmark> has been upgraded from version 1.19 to 1.20.
117
118=item *
119
65e96328 120L<bigint>, L<bignum>, L<bigrat> have been upgraded to version 0.39.
127a7155 121
65e96328 122Document in CAVEATS that using strings as numbers won't always invoke
cd7bac54 123the big number overloading, and how to invoke it. [rt.perl.org #123064]
541e1e0d 124
9e8951cf
TC
125=item *
126
6c8457e9
S
127L<Carp> has been upgraded from version 1.34 to 1.35.
128
cd7bac54
S
129=over 4
130
131=item *
132
133Carp now handles non-ASCII platforms better.
134
135=item *
136
137Off-by-one error fix for Perl < 5.14.
138
139=back
140
6c8457e9
S
141=item *
142
143L<Config::Perl::V> has been upgraded from version 0.22 to 0.23.
144
145=item *
146
147L<CPAN::Meta::Requirements> has been upgraded from version 2.131 to 2.132
148
149=item *
150
65e96328 151L<Devel::Peek> has been upgraded from version 1.21 to 1.22.
1b3da025 152
65e96328
TC
153=item *
154
6c8457e9 155L<Encode> has been upgraded from version 2.67 to 2.70.
65e96328
TC
156
157Building in C++ mode on Windows now works.
1b3da025
TC
158
159=item *
160
8e0a272f
TC
161L<Errno> has been upgraded from version 1.22 to 1.23.
162
163Add C<-P> to the preprocessor command-line on GCC 5. GCC added extra
cd7bac54 164line directives, breaking parsing of error code definitions. [rt.perl.org
8e0a272f
TC
165#123784]
166
167=item *
168
6c8457e9
S
169L<HTTP::Tiny> has been upgraded from version 0.053 to 0.054.
170
171=item *
172
0bbdc33c
TC
173L<Opcode> has been upgraded from version 1.31 to 1.32.
174
175=item *
176
6c8457e9
S
177L<Perl::OSType> has been upgraded from version 1.007 to 1.008.
178
179=item *
180
9e8951cf
TC
181L<PerlIO::scalar> has been upgraded from version 0.21 to 0.22.
182
eca355c2 183Attempting to write at file positions impossible for the platform now
9e8951cf
TC
184fail early rather than wrapping at 4GB.
185
e5240100
SH
186=item *
187
6c8457e9
S
188L<Pod::Parser> has been upgraded from version 1.62 to 1.63.
189
190=item *
191
192L<Pod::Perldoc> has been upgraded from version 3.24 to 3.25.
193
194=item *
195
196L<POSIX> has been upgraded from version 1.49 to 1.51.
197
198=item *
199
200L<re> has been upgraded from version 0.30 to 0.31.
201
202=item *
203
204L<Socket> has been upgraded from version 2.016 to 2.018.
205
206=item *
207
208L<Test::Simple> has been upgraded from version 1.301001_097 to 1.301001_098.
209
210=item *
211
6c8457e9 212L<Unicode::Collate> has been upgraded from version 1.10 to 1.11.
c49582c3 213
9024667a
KW
214=item *
215
216L<Unicode::UCD> has been upgraded from version 0.60 to 0.61.
31e72f27
KW
217
218=over 4
219
220=item *
221
9024667a
KW
222A new function L<property_values()|Unicode::UCD/prop_values()>
223has been added to return a given property's possible values.
224
31e72f27
KW
225=item *
226
12fee290
KW
227A new function L<charprop()|Unicode::UCD/charprop()>
228has been added to return the value of a given property for a given code
229point.
230
231=item *
232
3ba01ffb 233A new function L<charprops_all()|Unicode::UCD/charprops_all()>
40416981
KW
234has been added to return the values of all Unicode properties for a
235given code point.
236
237=item *
238
31e72f27
KW
239A bug has been fixed so that L<propaliases()|Unicode::UCD/prop_aliases()>
240returns the correct short and long names for the Perl extensions where
241it was incorrect.
242
0ce5e53e
KW
243=item *
244
5c1d8161
KW
245A bug has been fixed so that
246L<prop_value_aliases()|Unicode::UCD/prop_value_aliases()>
247returns C<undef> instead of a wrong result for properties that are Perl
248extensions.
249
250=item *
251
0ce5e53e
KW
252This module now works on EBCDIC platforms.
253
31e72f27
KW
254=back
255
cd7bac54
S
256=item *
257
258L<VMS::Stdio> has been upgraded from version 2.4 to 2.41.
259
260=item *
261
262L<Win32> has been upgraded from version 0.49 to 0.51.
263
264GetOSName() now supports Windows 8.1, and building in C++ mode now works.
265
266=item *
267
268L<Win32API::File> has been upgraded from version 0.1201 to 0.1202
269
270Building in C++ mode now works.
271
2ff1ebfe 272=back
541e1e0d 273
cd7bac54
S
274=head1 Documentation
275
276=head2 New Documentation
277
278=head3 L<perlrebackslash>
541e1e0d 279
2ff1ebfe 280=over 4
d676fe86
JK
281
282=item *
283
cd7bac54 284Added documentation of C<\b{sb}>, C<\b{wb}>, C<\b{gcb}>, and C<\b{g}>.
d2fff9f6 285
2ff1ebfe 286=back
d2fff9f6 287
cd7bac54 288=head3 L<perlrequick>
e329daf3 289
cd7bac54 290=over 4
e329daf3 291
cd7bac54 292=item *
e329daf3 293
cd7bac54 294Added example for C<\b{wb}>.
ba31029d 295
cd7bac54
S
296=back
297
298=head3 L<perlretut>
b045b8b5 299
cd7bac54
S
300=over 4
301
302=item *
303
304Added example for C<\b{wb}>.
305
306=back
541e1e0d 307
2ff1ebfe 308=head2 Changes to Existing Documentation
541e1e0d 309
cd7bac54
S
310=head3 L<perlunicode>
311
312=over 4
313
314=item *
315
316Update B<Default Word Boundaries> under
317L<perlunicode/"Unicode Regular Expression Support Level">'s
318B<Extended Unicode Support>.
319
320=back
541e1e0d 321
cd7bac54 322=head3 L<perlunicook>
541e1e0d 323
2ff1ebfe 324=over 4
aa67537d 325
4c7a0d98
DD
326=item *
327
cd7bac54
S
328Clarify that autodie >= 2.26 works with C<use open>.
329
330=item *
331
332Correct warning message for C<use autodie> and C<use open>.
4c7a0d98 333
b5d4d3b9 334=back
4c7a0d98 335
a5d66edf
JK
336=head3 L<perlfaq>
337
338=over 4
339
340=item *
341
342L<perlfaq> has been synchronized with version 5.021009 from CPAN.
343
344=back
345
cd7bac54 346=head3 L<perlop>
f348c3d8 347
cd7bac54 348=over 4
f348c3d8 349
cd7bac54 350=item *
2ff1ebfe 351
cd7bac54 352Correct the version number which removes C<m?PATTERN?>. It was Perl 5.22.0.
f348c3d8 353
cd7bac54 354=back
2ff1ebfe 355
cd7bac54 356=head3 L<perlvar>
f348c3d8 357
b5d4d3b9 358=over 4
6ed80d55 359
60dde9d3 360=item *
f348c3d8 361
cd7bac54 362Further clarify version number representations and usage.
4dc623f0 363
b5d4d3b9 364=back
84d03adf 365
cd7bac54 366=head3 L<perlmodstyle>
ff433f2d 367
9ce6583e 368=over 4
4cd408ba 369
9ce6583e 370=item *
6ed80d55 371
cd7bac54 372Instead of pointing to the module list, we are now pointing to PrePAN.
9ce6583e 373
2ff1ebfe 374=back
ab0b796c 375
cd7bac54 376=head1 Diagnostics
8c6180a9 377
cd7bac54
S
378The following additions or changes have been made to diagnostic output,
379including warnings and fatal error messages. For the complete list of
380diagnostic messages, see L<perldiag>.
381
382=head2 New Diagnostics
383
384=head3 New Warnings
8c6180a9 385
2ff1ebfe 386=over 4
0561e60b 387
9ce6583e 388=item *
dd200dff 389
cd7bac54 390L<'%s' is an unknown bound type in regex|perldiag/"'%s' is an unknown bound type in regex; marked by <-- HERE in m/%s/">
9ce6583e 391
cd7bac54
S
392You used C<\b{...}> or C<\B{...}> and the C<...> is not known to
393Perl. The current valid ones are given in
394L<perlrebackslash/\b{}, \b, \B{}, \B>.
73e793fc 395
cd7bac54 396=item *
9ce6583e 397
cd7bac54 398L<Use of \b{} for non-UTF-8 locale is wrong. Assuming a UTF-8 locale|perldiag/"Use of \b{} for non-UTF-8 locale is wrong. Assuming a UTF-8 locale">
73e793fc 399
cd7bac54
S
400You are matching a regular expression using locale rules,
401and a Unicode boundary is being matched, but the locale is not a Unicode
402one. This doesn't make sense. Perl will continue, assuming a Unicode
403(UTF-8) locale, but the results could well be wrong except if the locale
404happens to be ISO-8859-1 (Latin1) where this message is spurious and can
405be ignored.
613abc6d 406
cd7bac54 407=item *
9ce6583e 408
cd7bac54
S
409L<< Using E<sol>u for '%s' instead of E<sol>%s in regex; marked by <-- HERE in mE<sol>%sE<sol>|perldiag/"Using E<sol>u for '%s' instead of E<sol>%s in regex; marked by <-- HERE in mE<sol>%sE<sol>" >>
410
411You used a Unicode boundary (C<\b{...}> or C<\B{...}>) in a
412portion of a regular expression where the character set modifiers C</a>
413or C</aa> are in effect. These two modifiers indicate an ASCII
0308b42c 414interpretation, and this doesn't make sense for a Unicode definition.
cd7bac54
S
415The generated regular expression will compile so that the boundary uses
416all of Unicode. No other portion of the regular expression is affected.
9ce6583e 417
b927b7e9
KW
418=item *
419
cd7bac54 420L<The bitwise feature is experimental|perldiag/"The bitwise feature is experimental">
db5cc9f9 421
cd7bac54
S
422This warning is emitted if you use bitwise
423operators (C<& | ^ ~ &. |. ^. ~.>) with the "bitwise" feature enabled.
424Simply suppress the warning if you want to use the feature, but know
425that in doing so you are taking the risk of using an experimental
426feature which may change or be removed in a future Perl version:
db5cc9f9 427
cd7bac54
S
428 no warnings "experimental::bitwise";
429 use feature "bitwise";
430 $x |.= $y;
c877af1b 431
cd7bac54 432=back
c877af1b 433
cd7bac54 434=head2 Changes to Existing Diagnostics
db5cc9f9 435
2ff1ebfe 436=over 4
db5cc9f9 437
acdfc3b6
KW
438=item *
439
cd7bac54
S
440B<Unusual use of %s in void context> has been removed. It might
441come back in a future release.
db5cc9f9 442
cd7bac54 443=item *
8c6180a9 444
cd7bac54
S
445L<Argument "%s" isn't numeric%s|perldiag/"Argument "%s" isn't numeric%s">
446now adds the following note:
447
448 Note that for the C<Inf> and C<NaN> (infinity and not-a-number) the
449 definition of "numeric" is somewhat unusual: the strings themselves
450 (like "Inf") are considered numeric, and anything following them is
451 considered non-numeric.
780fcc9f 452
cd7bac54 453=item *
40a81b59 454
cd7bac54
S
455B<Possible precedence problem on bitwise %c operator> reworded as
456L<Possible precedence problem on bitwise %s operator|perldiag/"Possible precedence problem on bitwise %s operator">.
457
458=back
459
460=head1 Utility Changes
461
462=head2 L<h2ph>
bb8c7e27 463
b5d4d3b9 464=over 4
83b69bfd
DD
465
466=item *
467
cd7bac54
S
468F<h2ph> now handles hexadecimal constants in the compiler's predefined
469macro definitions, as visible in C<$Config{cppsymbols}>. [rt.perl.org
470#123784]
13adb056 471
b5d4d3b9 472=back
391823f2 473
cd7bac54 474=head2 L<encguess>
6ff8f256 475
6c8457e9
S
476=over 4
477
cd7bac54 478=item *
6c8457e9 479
cd7bac54 480No longer depends on non-core module anymore.
db98db4e 481
6c8457e9 482=back
8818afe8 483
cd7bac54 484=head1 Configuration and Compilation
8af808bf 485
2ff1ebfe 486=over 4
fdcaecb7 487
cd7bac54 488=item *
fdcaecb7 489
cd7bac54 490F<Configure> now checks for F<lrintl>, F<lroundl>, F<llrintl>, and F<llroundl>.
2af7c6b6 491
4dc623f0 492=back
2af7c6b6 493
cd7bac54 494=head1 Testing
70cee83f 495
b5d4d3b9 496=over 4
e5fbfbc1 497
cd7bac54 498=item *
b4045391 499
cd7bac54 500Added F<t/op/dump.t> for testing C<dump>.
b4045391 501
2ff1ebfe 502=back
b4045391 503
cd7bac54
S
504=head1 Deprecations
505
506=head2 Support for new warnings categories outside of "all"
507
508The new option for warnings outside the B<all> category in the L<warnings>
509pragma has been removed for now.
510
511For more context, you can refer to the following
512L<discussion thread|http://www.nntp.perl.org/group/perl.perl5.porters/2015/01/msg225066.html>.
513
514=head1 Platform Support
515
2ff1ebfe 516=head2 Platform-Specific Notes
8c847e66 517
cd7bac54 518=head3 Win32
8c847e66 519
2ff1ebfe 520=over 4
d345f487 521
cd7bac54 522=item *
d345f487 523
8b08c4b9
SH
524Perl can now be built in C++ mode on Windows by setting the makefile macro
525C<USE_CPLUSPLUS> to the value "define".
353075a0 526
cd7bac54
S
527=item *
528
5904c5c0
TC
529List form pipe open no longer falls back to the shell.
530
cd7bac54
S
531=item *
532
533In release 5.21.8 compiling on VC with dmake was broken. Fixed.
534
535=item *
536
537New C<DebugSymbols> and C<DebugFull> configuration options added to
538Windows makefiles.
539
540=item *
541
542L<B> now compiles again on Windows.
543
4dc623f0 544=back
353075a0 545
cd7bac54 546=head3 Solaris
9f122eef 547
cd7bac54
S
548Look for the Sun Studio compiler in both F</opt/solstudio*> and
549F</opt/solarisstudio*>.
2ff1ebfe 550
cd7bac54 551=head3 VMS
2ff1ebfe 552
b5d4d3b9 553=over 4
2ec11c70
DM
554
555=item *
556
cd7bac54
S
557When spawning a subprocess without waiting, the return value is now
558the correct PID.
559
560=item *
561
562Fix a prototype so linking doesn't fail under the VMS C++ compiler.
2683609f 563
4dc623f0 564=back
c7f058f0 565
4dc623f0 566=head1 Selected Bug Fixes
0ef4323a 567
cd7bac54 568=over 4
00ba25b8 569
cd7bac54 570=item *
567291b6 571
cd7bac54 572Patterns starting with C</.*/> are now fast again. [rt.perl.org #123743]
436f6503 573
f44e0270
FC
574=item *
575
d536498f
TC
576The original visible value of C<$/> is now preserved when it is set to
577an invalid value. Previously if you set C<$/> to a reference to an
578array, for example, perl would produce a runtime error and not set
579C<PL_rs>, but perl code that checked C<$/> would see the array
cd7bac54 580reference. [rt.perl.org #123218]
ea13b07e 581
7dbd4c44
KW
582=item *
583
584In a regular expression pattern, a POSIX class, like C<[:ascii:]>, must
585be inside a bracketed character class, like C</qr[[:ascii:]]>. A
586warning is issued when something looking like a POSIX class is not
587inside a bracketed class. That warning wasn't getting generated when
588the POSIX class was negated: C<[:^ascii:]>. This is now fixed.
589
47c2f9f1
TC
590=item *
591
cd7bac54 592Fix a couple of other size calculation overflows. [rt.perl.org #123554]
47c2f9f1 593
5bd81aa7
TC
594=item *
595
596A bug introduced in 5.21.6, C<dump LABEL> acted the same as C<goto
cd7bac54 597LABEL>. This has been fixed. [rt.perl.org #123836]
5bd81aa7 598
bea370a8
FC
599=item *
600
601Perl 5.14.0 introduced a bug whereby C<eval { LABEL: }> would crash. This
cd7bac54 602has been fixed. [rt.perl.org #123652]
bea370a8 603
2bf83140
FC
604=item *
605
606Various crashes due to the parser getting confused by syntax errors have
cd7bac54
S
607been fixed. [rt.perl.org #123617] [rt.perl.org #123737]
608[rt.perl.org #123753] [rt.perl.org #123677]
2bf83140 609
041a5927
FC
610=item *
611
612Code like C</$a[/> used to read the next line of input and treat it as
613though it came immediately after the opening bracket. Some invalid code
614consequently would parse and run, but some code caused crashes, so this is
cd7bac54 615now disallowed. [rt.perl.org #123712]
041a5927 616
cd7bac54 617=item *
ea13b07e 618
cd7bac54 619Fix argument underflow for C<pack>. [rt.perl.org #123874]
b65adbec 620
cd7bac54 621=item *
b65adbec 622
cd7bac54
S
623Fix handling of non-strict C<\x{}>. Now C<\x{}> is equivalent to C<\x{0}>
624instead of faulting.
370c71c5 625
cd7bac54
S
626=item *
627
628C<stat -t> is now no longer treated as stackable, just like C<-t stat>.
629[rt.perl.org #123816]
b94c7836
FC
630
631=item *
632
cd7bac54 633The following no longer causes a SEGV: C<qr{x+(y(?0))*}>.
439f6100 634
cd7bac54 635=item *
439f6100 636
cd7bac54 637Fixed infinite loop in parsing backrefs in regexp patterns.
e3e8f263 638
cd7bac54
S
639=item *
640
641Several minor bug fixes in behavior of Inf and NaN, including
642warnings when stringifying Inf-like or NaN-like strings. For example,
643"NaNcy" doesn't numify to NaN anymore.
e3e8f263 644
cb6cc22b
TC
645=item *
646
cd7bac54 647Only stringy classnames are now shared. This fixes some failures in L<autobox>. [rt.cpan.org #100819]
cb6cc22b 648
b5d4d3b9 649=back
fcfb7b86 650
cd7bac54 651=head1 Acknowledgements
541e1e0d 652
cd7bac54
S
653Perl 5.21.9 represents approximately 4 weeks of development since Perl 5.21.8
654and contains approximately 170,000 lines of changes across 520 files from 32
655authors.
541e1e0d 656
cd7bac54
S
657Excluding auto-generated files, documentation and release tools, there were
658approximately 160,000 lines of changes to 270 .pm, .t, .c and .h files.
659
660Perl continues to flourish into its third decade thanks to a vibrant community
661of users and developers. The following people are known to have contributed the
662improvements that became Perl 5.21.9:
663
664Chad Granum, Chris 'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari
665Mannsåker, Daniel Dragan, David Golden, David Mitchell, Father Chrysostomos,
666H.Merijn Brand, Hugo van der Sanden, James E Keenan, James Raspass, Jarkko
667Hietaniemi, Karen Etheridge, Karl Williamson, Kent Fredric, Lajos Veres, Leon
668Timmermans, Lukas Mai, Mathieu Arnold, Matthew Horsfall, Peter Martini, Petr
669Písař, Randy Stauner, Ricardo Signes, Sawyer X, Shlomi Fish, Sisyphus, Steve
670Hay, Tony Cook, Yves Orton, Ævar Arnfjörð Bjarmason.
671
672The list above is almost certainly incomplete as it is automatically generated
673from version control history. In particular, it does not include the names of
674the (very much appreciated) contributors who reported issues to the Perl bug
675tracker.
541e1e0d 676
cd7bac54
S
677Many of the changes included in this version originated in the CPAN modules
678included in Perl's core. We're grateful to the entire CPAN community for
679helping Perl to flourish.
01d42a22 680
cd7bac54
S
681For a more complete list of all of Perl's historical contributors, please see
682the F<AUTHORS> file in the Perl source distribution.
f5b73711 683
44691e6f
AB
684=head1 Reporting Bugs
685
e08634c5
SH
686If you find what you think is a bug, you might check the articles recently
687posted to the comp.lang.perl.misc newsgroup and the perl bug database at
238894db 688https://rt.perl.org/ . There may also be information at
7ef8b31d 689http://www.perl.org/ , the Perl Home Page.
44691e6f 690
e08634c5
SH
691If you believe you have an unreported bug, please run the L<perlbug> program
692included with your release. Be sure to trim your bug down to a tiny but
693sufficient test case. Your bug report, along with the output of C<perl -V>,
694will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
695
696If the bug you are reporting has security implications, which make it
e08634c5
SH
697inappropriate to send to a publicly archived mailing list, then please send it
698to perl5-security-report@perl.org. This points to a closed subscription
699unarchived mailing list, which includes all the core committers, who will be
700able to help assess the impact of issues, figure out a resolution, and help
f9001595 701co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
702platforms on which Perl is supported. Please only use this address for
703security issues in the Perl core, not for modules independently distributed on
704CPAN.
44691e6f
AB
705
706=head1 SEE ALSO
707
e08634c5
SH
708The F<Changes> file for an explanation of how to view exhaustive details on
709what changed.
44691e6f
AB
710
711The F<INSTALL> file for how to build Perl.
712
713The F<README> file for general stuff.
714
715The F<Artistic> and F<Copying> files for copyright information.
716
717=cut