This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta: c56ed9f deserves no mention
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =for comment
4 Stuff that needs to be done still:
5 70502ce [perl #119101] Extraneous warnings in Parse::ErrorString::Perl
6 88b3a46 PATCH (partial) [perl #107816] Performance regression since 0abd0d78
7 eb40d2c [perl #2726] Prototype is not applied until BLOCK is defined
8 8fe3c67 fix 114884 positive GPOS lookbehind regex substitution failure
9 d8fe30a Avoid read-after-free in S_scan_heredoc() if the terminator line has no "\n".
10
11 =head1 NAME
12
13 [ this is a template for a new perldelta file.  Any text flagged as XXX needs
14 to be processed before release. ]
15
16 perldelta - what is new for perl v5.19.3
17
18 =head1 DESCRIPTION
19
20 This document describes differences between the 5.19.2 release and the 5.19.3
21 release.
22
23 If you are upgrading from an earlier release such as 5.19.1, first read
24 L<perl5192delta>, which describes differences between 5.19.1 and 5.19.2.
25
26 =head1 Notice
27
28 XXX Any important notices here
29
30 =head1 Core Enhancements
31
32 XXX New core language features go here.  Summarize user-visible core language
33 enhancements.  Particularly prominent performance optimisations could go
34 here, but most should go in the L</Performance Enhancements> section.
35
36 [ List each enhancement as a =head2 entry ]
37
38 =head2 B<-F> now implies B<-a> and B<-a> implies B<-n>
39
40 Previously B<-F> without B<-a> was a no-op, and B<-a> without B<-n> or B<-p>
41 was a no-op, with this change, if you supply B<-F> then both B<-a> and B<-n>
42 are implied and if you supply B<-a> then B<-n> is implied.
43
44 You can still use B<-p> for its extra behaviour. [perl #116190]
45
46 =head1 Security
47
48 XXX Any security-related notices go here.  In particular, any security
49 vulnerabilities closed should be noted here rather than in the
50 L</Selected Bug Fixes> section.
51
52 [ List each security issue as a =head2 entry ]
53
54 =head1 Incompatible Changes
55
56 XXX For a release on a stable branch, this section aspires to be:
57
58     There are no changes intentionally incompatible with 5.XXX.XXX
59     If any exist, they are bugs, and we request that you submit a
60     report.  See L</Reporting Bugs> below.
61
62 [ List each incompatible change as a =head2 entry ]
63
64 =head1 Deprecations
65
66 XXX Any deprecated features, syntax, modules etc. should be listed here.
67
68 =head2 Module removals
69
70 XXX Remove this section if inapplicable.
71
72 The following modules will be removed from the core distribution in a
73 future release, and will at that time need to be installed from CPAN.
74 Distributions on CPAN which require these modules will need to list them as
75 prerequisites.
76
77 The core versions of these modules will now issue C<"deprecated">-category
78 warnings to alert you to this fact.  To silence these deprecation warnings,
79 install the modules in question from CPAN.
80
81 Note that these are (with rare exceptions) fine modules that you are encouraged
82 to continue to use.  Their disinclusion from core primarily hinges on their
83 necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
84 not usually on concerns over their design.
85
86 =over
87
88 XXX Note that deprecated modules should be listed here even if they are listed
89 as an updated module in the L</Modules and Pragmata> section.
90
91 =back
92
93 [ List each other deprecation as a =head2 entry ]
94
95 =head1 Performance Enhancements
96
97 XXX Changes which enhance performance without changing behaviour go here.
98 There may well be none in a stable release.
99
100 [ List each enhancement as a =item entry ]
101
102 =over 4
103
104 =item *
105
106 XXX
107
108 =back
109
110 =head1 Modules and Pragmata
111
112 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
113 go here.  If Module::CoreList is updated, generate an initial draft of the
114 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
115 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
116 below.  A paragraph summary for important changes should then be added by hand.
117 In an ideal world, dual-life modules would have a F<Changes> file that could be
118 cribbed.
119
120 [ Within each section, list entries as a =item entry ]
121
122 =head2 New Modules and Pragmata
123
124 =over 4
125
126 =item *
127
128 XXX
129
130 =back
131
132 =head2 Updated Modules and Pragmata
133
134 =over 4
135
136 =item *
137
138 L<B> has been upgraded from version 1.44 to 1.45.
139
140 Calling the C<GV> method on C<B::CV> objects created from a lexical sub would
141 return nonsense, possibly crashing perl.  C<GV> now returns C<undef> for
142 lexical subs. [perl #118525]
143
144 Added the C<NAME_HEK> method to return the name of a lexical sub.
145
146 =item *
147
148 L<bignum> has been upgraded from version 0.35 to 0.36.
149
150 L<bigrat> wasn't correctly updating an internal variable when C<use>d with a
151 C<lib> option.
152
153 =item *
154
155 L<Carp> has been upgraded from 1.30 to 1.31
156
157 L<Carp> now handles objects with string overloads.  It also allows objects to
158 specify how they appear in the stack dump with a C<CARP_TRACE> method, and also
159 allows the user to specify their own formatter for objects without
160 C<CARP_TRACE> as well as other references. [perl #92446]
161
162 =item *
163
164 L<Compress::Raw::Bzip2> has been upgraded from 2.061 to 2.062.
165
166 XXX: TODO
167
168 =item *
169
170 L<Compress::Raw::Zlib> has been upgraded from 2.061 to 2.062.
171
172 XXX: TODO
173
174 =item *
175
176 L<Config::Perl::V> has been upgraded from version 0.18 to 0.19.
177
178 XXX: TODO
179
180 =item *
181
182 L<constant> has been upgraded from version 1.27 to 1.28.
183
184 Note that list constants will be inlined and may be read-only in future Perl
185 versions.
186
187 =item *
188
189 L<CPAN::Meta> has been upgraded from version 2.131560 to 2.132140.
190
191 Some documentation typos have been fixed.
192
193 =item *
194
195 L<Data::Dumper> has been upgraded from version 2.147 to 2.148.
196
197 The compatbility of the XS implementation with the pure perl version under
198 C<Useqq> has been improved. [perl #118933]
199
200 =item *
201
202 L<DB> has been upgraded from 1.41 to 1.42.
203
204 The Perl debugger no longer crashes with C<PERLDB_OPTS="noTTY frame=2">.
205
206 =item *
207
208 L<Devel::Peek> has been upgraded from version 1.12 to 1.13.
209
210 C<SvREFCNT_inc> and C<SvREFCNT_dec> have been removed and C<SvREFCNT> will now
211 work on non-scalars. [perl #117793]
212
213 C<Dump> now checks its arguments at compile time.  Both arguments are now
214 evaluated in scalar context, with exceptions for @arrays and %hashes, allowing
215 aggregates to be dumped directly.  The first argument is evaluated in rvalue
216 scalar context, allowing rvalue C<pos> and C<substr> to be dumped.
217
218 C<fill_mstats> no longer crashes if its argument is not already a string.
219 [perl #92260]
220
221 =item *
222
223 L<diagnostics> has been upgraded from version 1.31 to 1.32.
224
225 Wrapped links are no longer truncated.
226
227 =item *
228
229 L<DynaLoader> has been upgraded from version 1.18 to 1.19.
230
231 The $dl_dlext variable is now documented.
232
233 =item *
234
235 L<Encode> has been upgraded from version 2.51 to 2.52.
236
237 Encoding "0" with MIME-Headers no longer gets a blank string.
238
239 =item *
240
241 L<English> has been upgraded from version 1.07 to 1.08.
242
243 The documentation of a performance fix has been corrected.
244
245 =item *
246
247 L<Exporter> has been upgraded from version 5.68 to 5.69.
248
249 L<Exporter> would ignore custom $SIG{__WARN__} handlers in C<Exporter::Heavy>.
250 [perl #39739]
251
252 =item *
253
254 L<File::Spec> has been upgraded from 3.41 to 3.44.
255
256 The module is now partly implemented in XS, for performance.
257
258 =item *
259
260 L<ExtUtils::MakeMaker> has been upgraded from 6.68 to 6.72.
261
262 The C<dist> target now reports the file created, an infinite loop in
263 C<clean_subdirs> has been fixed, an invisible interactive question is now
264 avoided when rebuilding Makefile, issues with F</cygdrive> on Cygwin have been
265 resolved, C<LD> and C<OPTIMIZE> are now used in recursive F<Makefile.PL>
266 invocations, C<VERSION> and C<VERSION_FROM> now handle v-strings correctly, and
267 control characters are now stripped from C<ABSTRACT>.
268
269 =item *
270
271 L<ExtUtils::ParseXS> has been upgraded from version 3.18 to 3.21.
272
273 XXX: TODO
274
275 =item *
276
277 L<Getopt::Std> has been upgraded from version 1.09 to 1.10.
278
279 Clarified documentation of what happens when a switch is expecting an argument
280 but fails to be provided with one.
281
282 =item *
283
284 The IO-Compress module collection has been upgraded from 2.061 to 2.062.
285
286 XXX: TODO
287
288 =item *
289
290 L<IPC::Cmd> has been upgraded from version 0.82 to 0.84.
291
292 C<run_forked> has various fixes/improvements, L<Socket> is only used where
293 needed and a regression introduced in 0.78 has been fixed.
294
295 =item *
296
297 L<IPC::Open3> has been upgradded from version 1.14 to 1.15.
298
299 C<open3> would leak a zombie process if the child process I/O redirection or
300 C<exec> failed. [perl #114722]
301
302 =item *
303
304 L<IPC::SysV> has been upgraded from version 2.03 to 2.04.
305
306 $EXPORT_TAGS{all} has been added and a couple of typos have been fixed.
307
308 =item *
309
310 The libnet module collection has been upgraded from version 1.22 to 1.23.
311
312 XXX: TODO
313
314 =item *
315
316 L<List::Util> has been upgraded from version 1.27 to 1.31.
317
318 L<List::Util> now includes C<pairgrep>, C<pairmap>, C<pairs>, C<pairkeys>,
319 C<pairvalues> and C<pairfirst> functions that operate on even-sized lists of
320 pairs.
321
322 =item *
323
324 L<Module::Build> has been upgraded from 0.4005 to 0.4007.
325
326 The test suite has been significantly sped up, Unicode man page support has
327 been enhanced and hash argument parsing in subclasses has been fixed.
328
329 =item *
330
331 L<Module::CoreList> has been upgraded from 2.92 to 2.97.
332
333 XXX: TODO
334
335 =item *
336
337 L<mro> has been upgraded from version 1.12 to 1.13.
338
339 A minor typo has been fixed in the documentation.
340
341 =item *
342
343 L<parent> has been upgraded from version 0.225 to 0.226.
344
345 XXX: TODO
346
347 =item *
348
349 L<PerlIO> has been upgraded from version 1.07 to 1.08.
350
351 Although not a security vulnerability, it was possible to inject code via
352 C<PerlIO-E<gt>import()>.  This has now been fixed. [perl #119287]
353
354 =item *
355
356 L<Pod::Functions> has been upgraded from version 1.07 to 1.08.
357
358 Internal changes only have been made to the test suite.
359
360 =item *
361
362 L<Socket> has been upgraded from version 2.010 to 2.011.
363
364 Handle FreeBSD (or other platforms) returning shorter AF_UNIX sockaddr
365 structures due to embedded sun_len. [cpan #86613]
366
367 =item *
368
369 L<Storable> has been upgraded from version 2.45 to 2.46.
370
371 Avoid creating temporary objects for STORABLE_attach when they aren't required.
372 [perl #118907]
373
374 =item *
375
376 L<Time::HiRes> has been upgraded from version 1.9725 to 1.9726.
377
378 Now provides an C<lstat> function.
379 Various bugs fixed.
380
381 =item *
382
383 L<Time::Piece> has been upgraded from version 1.21 to 1.22.
384
385 XXX: TODO
386
387 =item *
388
389 L<utf8> has been upgraded from version 1.12 to 1.13.
390
391 A minor clarification has been made in the documentation.
392
393 =back
394
395 =head2 Removed Modules and Pragmata
396
397 =over 4
398
399 =item *
400
401 XXX
402
403 =back
404
405 =head1 Documentation
406
407 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
408 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
409
410 =head2 New Documentation
411
412 XXX Changes which create B<new> files in F<pod/> go here.
413
414 =head3 L<XXX>
415
416 XXX Description of the purpose of the new file here
417
418 =head2 Changes to Existing Documentation
419
420 XXX Changes which significantly change existing files in F<pod/> go here.
421 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
422 section.
423
424 =head3 L<perlopentut>
425
426 =over 4
427
428 =item *
429
430 The C<open> tutorial has been completely rewriten by Tom Christiansen, and now
431 focuses on covering only the basics, rather than providing a comprehensive
432 reference to all things openable.  This rewrite came as the result of a
433 vigorous discussion on perl5-porters kicked off by a set of improvements
434 written by Alexander Hartmaier to the existing L<perlopentut>.  A "more than
435 you ever wanted to know about C<open>" document may follow in subsequent
436 versions of perl.
437
438 =back
439
440 =head3 L<perlre>
441
442 =over 4
443
444 =item *
445
446 The C</r> modifier (for non-destructive substitution) is now documented. [perl
447 #119151]
448
449 =back
450
451 =head3 L<perlxs>
452
453 =over 4
454
455 =item *
456
457 Several problems in the C<MY_CXT> example have been fixed.
458
459 =back
460
461 =head1 Diagnostics
462
463 The following additions or changes have been made to diagnostic output,
464 including warnings and fatal error messages.  For the complete list of
465 diagnostic messages, see L<perldiag>.
466
467 XXX New or changed warnings emitted by the core's C<C> code go here.  Also
468 include any changes in L<perldiag> that reconcile it to the C<C> code.
469
470 =head2 New Diagnostics
471
472 XXX Newly added diagnostic messages go under here, separated into New Errors
473 and New Warnings
474
475 =head3 New Errors
476
477 =over 4
478
479 =item *
480
481 XXX L<message|perldiag/"message">
482
483 =back
484
485 =head3 New Warnings
486
487 =over 4
488
489 =item *
490
491 L<Argument "%s" treated as 0 in increment (++)|perldiag/"Argument "%s" treated
492 as 0 in increment (++)">
493
494 (W numeric) The indicated string was fed as an argument to the C<++> operator
495 which expects either a number or a string matching C</^[a-zA-Z]*[0-9]*\z/>.
496 See L<perlop/Auto-increment and Auto-decrement> for details.
497
498 =back
499
500 =head2 Changes to Existing Diagnostics
501
502 XXX Changes (i.e. rewording) of diagnostic messages go here
503
504 =over 4
505
506 =item *
507
508 XXX Describe change here
509
510 =back
511
512 =head1 Utility Changes
513
514 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
515 Most of these are built within the directories F<utils> and F<x2p>.
516
517 [ List utility changes as a =head3 entry for each utility and =item
518 entries for each change
519 Use L<XXX> with program names to get proper documentation linking. ]
520
521 =head3 L<XXX>
522
523 =over 4
524
525 =item *
526
527 XXX
528
529 =back
530
531 =head1 Configuration and Compilation
532
533 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
534 go here.  Any other changes to the Perl build process should be listed here.
535 However, any platform-specific changes should be listed in the
536 L</Platform Support> section, instead.
537
538 [ List changes as a =item entry ].
539
540 =over 4
541
542 =item *
543
544 XXX
545
546 =back
547
548 =head1 Testing
549
550 XXX Any significant changes to the testing of a freshly built perl should be
551 listed here.  Changes which create B<new> files in F<t/> go here as do any
552 large changes to the testing harness (e.g. when parallel testing was added).
553 Changes to existing files in F<t/> aren't worth summarizing, although the bugs
554 that they represent may be covered elsewhere.
555
556 [ List each test improvement as a =item entry ]
557
558 =over 4
559
560 =item *
561
562 XXX
563
564 =back
565
566 =head1 Platform Support
567
568 XXX Any changes to platform support should be listed in the sections below.
569
570 [ Within the sections, list each platform as a =item entry with specific
571 changes as paragraphs below it. ]
572
573 =head2 New Platforms
574
575 XXX List any platforms that this version of perl compiles on, that previous
576 versions did not.  These will either be enabled by new files in the F<hints/>
577 directories, or new subdirectories and F<README> files at the top level of the
578 source tree.
579
580 =over 4
581
582 =item XXX-some-platform
583
584 XXX
585
586 =back
587
588 =head2 Discontinued Platforms
589
590 XXX List any platforms that this version of perl no longer compiles on.
591
592 =over 4
593
594 =item XXX-some-platform
595
596 XXX
597
598 =back
599
600 =head2 Platform-Specific Notes
601
602 XXX List any changes for specific platforms.  This could include configuration
603 and compilation changes or changes in portability/compatibility.  However,
604 changes within modules for platforms should generally be listed in the
605 L</Modules and Pragmata> section.
606
607 =over 4
608
609 =item XXX-some-platform
610
611 XXX
612
613 =back
614
615 =head1 Internal Changes
616
617 XXX Changes which affect the interface available to C<XS> code go here.  Other
618 significant internal changes for future core maintainers should be noted as
619 well.
620
621 [ List each change as a =item entry ]
622
623 =over 4
624
625 =item *
626
627 C<sv_pos_b2u_flags> has been added to the API.  It is similar to C<sv_pos_b2u>,
628 but supports long strings on 64-bit platforms.
629
630 =item *
631
632 C<PL_exit_flags> can now be used by perl embedders or other XS code to have
633 perl C<warn> or C<abort> on an attempted exit. [perl #52000]
634
635 =back
636
637 =head1 Selected Bug Fixes
638
639 XXX Important bug fixes in the core language are summarized here.  Bug fixes in
640 files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
641
642 [ List each fix as a =item entry ]
643
644 =over 4
645
646 =item *
647
648 Autovivifying a subroutine stub via C<\&$glob> started causing crashes in Perl
649 5.18.0 if the $glob was merely a copy of a real glob, i.e., a scalar that had
650 had a glob assigned to it.  This has been fixed. [perl #119051]
651
652 =item *
653
654 On 64-bit platforms C<pos> can now be set to a value higher than 2**31-1.
655 [perl #72766]
656
657 =item *
658
659 Perl used to leak an implementation detail when it came to referencing the
660 return values of certain operators.  C<for ($a+$b) { warn \$_; warn \$_ }> used
661 to display two different memory addresses, because the C<\> operator was
662 copying the variable.  Under threaded builds, it would also happen for
663 constants (C<for(1) { ... }>).  This has been fixed. [perl #21979, #78194,
664 #89188, #109746, #114838, #115388]
665
666 =item *
667
668 The range operator C<..> was returning the same modifiable scalars with each
669 call, unless it was the only thing in a C<foreach> loop header.  This meant
670 that changes to values within the list returned would be visible the next time
671 the operator was executed. [perl #3105]
672
673 =item *
674
675 Constant folding and subroutine inlining no longer cause operations that would
676 normally return new modifiable scalars to return read-only values instead.
677
678 =item *
679
680 Closures of the form C<sub () { $some_variable }> are no longer inlined,
681 causing changes to the variable to be ignored by callers of the subroutine.
682 [perl #79908]
683
684 =item *
685
686 Return values of certain operators such as C<ref> would sometimes be shared
687 between recursive calls to the same subroutine, causing the inner call to
688 modify the value returned by C<ref> in the outer call.  This has been fixed.
689
690 =item *
691
692 C<__PACKAGE__> and constants returning a package name or hash key are now
693 consistently read-only.  In various previous Perl releases, they have become
694 mutable under certain circumstances.
695
696 =item *
697
698 C</$qr/p> was broken in Perl 5.18.0; the C</p> flag was ignored.  This has been
699 fixed. [perl #118213]
700
701 =item *
702
703 Starting in v5.18.0, a construct like C</[#](?{})/x> would have its C<#>
704 incorrectly interpreted as a comment.  The code block would be skipped,
705 unparsed.  This has been corrected.
706
707 =item *
708
709 Starting in Perl 5.001, a regular expression like C</[#$a]/x> or C</[#]$a/x>
710 would have its C<#> incorrectly interpreted as a comment, so the variable would
711 not interpolate.  This has been corrected. [perl #45667]
712
713 =item *
714
715 On non-threaded builds, setting C<${"_<filename"}> to a reference or typeglob
716 no longer causes C<__FILE__> and some error messages to produce a corrupt
717 string, and no longer prevents C<#line> directives in string evals from
718 providing the source lines to the debugger.  Threaded builds were unaffected.
719
720 =item *
721
722 Enabling "used once" warnings no longer causes crashes on stash circularities
723 created at compile time (C<*Foo::Bar::Foo:: = *Foo::>).
724
725 =item *
726
727 Undef constants used in hash keys (C<use constant u => undef; $h{+u}>) no
728 longer produce "uninitialized" warnings at compile time.
729
730 =item *
731
732 Modifying a substitution target inside the substitution replacement no longer
733 causes crashes.
734
735 =item *
736
737 The first statement inside a string eval used to use the wrong pragma setting
738 sometimes during constant folding.  C<eval 'uc chr 0xe0'> would randomly choose
739 between Unicode, byte, and locale semantics.  This has been fixed.
740
741 =item *
742
743 The handling of return values of @INC filters (subroutines returned by
744 subroutines in @INC) has been fixed in various ways.  Previously tied variables
745 were mishandled, and setting $_ to a reference or typeglob could result in
746 crashes.
747
748 =item *
749
750 The C<SvPVbyte> XS function has been fixed to work with tied scalars returning
751 something other than a string.  It used to return utf8 in those cases where
752 C<SvPV> would.
753
754 =item *
755
756 Perl 5.18.0 inadvertently made dereferenced regular expressions
757 S<(C<${ qr// }>)> false as booleans.  This has been fixed.
758
759 =item *
760
761 Perl 5.18.0 inadvertently made C<--> and C<++> crash on dereferenced regular
762 expressions, and stopped C<++> from flattening vstrings.
763
764 =item *
765
766 C<bless> no longer dies with "Can't bless non-reference value" if its first
767 argument is a tied reference.
768
769 =item *
770
771 C<reset> with an argument no longer skips copy-on-write scalars, regular
772 expressions, typeglob copies, and vstrings.  Also, when encountering those or
773 read-only values, it no longer skips any array or hash with the same name.
774
775 =item *
776
777 C<reset> with an argument now skips scalars aliased to typeglobs
778 (C<for $z (*foo) { reset "z" }>).  Previously it would corrupt memory or crash.
779
780 =item *
781
782 C<ucfirst> and C<lcfirst> were not respecting the bytes pragma.  This was a
783 regression from v5.12. [perl #117355]
784
785 =item *
786
787 The use of C<\G> in regular expressions, where it's not at the start of the
788 pattern, is now slightly less buggy (although it is still somewhat
789 problematic).
790
791 =item *
792
793 Where a regular expression included code blocks (C</(?{...})/>), and where the
794 use of constant overloading triggered a re-compilation of the code block, the
795 second compilation didn't see its outer lexical scope.  This was a regression
796 in 5.18.0.
797
798 =back
799
800 =head1 Known Problems
801
802 XXX Descriptions of platform agnostic bugs we know we can't fix go here.  Any
803 tests that had to be C<TODO>ed for the release would be noted here.  Unfixed
804 platform specific bugs also go here.
805
806 [ List each fix as a =item entry ]
807
808 =over 4
809
810 =item *
811
812 XXX
813
814 =back
815
816 =head1 Obituary
817
818 XXX If any significant core contributor has died, we've added a short obituary
819 here.
820
821 =head1 Acknowledgements
822
823 XXX Generate this with:
824
825   perl Porting/acknowledgements.pl v5.19.2..HEAD
826
827 =head1 Reporting Bugs
828
829 If you find what you think is a bug, you might check the articles recently
830 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
831 http://rt.perl.org/perlbug/ .  There may also be information at
832 http://www.perl.org/ , the Perl Home Page.
833
834 If you believe you have an unreported bug, please run the L<perlbug> program
835 included with your release.  Be sure to trim your bug down to a tiny but
836 sufficient test case.  Your bug report, along with the output of C<perl -V>,
837 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
838
839 If the bug you are reporting has security implications, which make it
840 inappropriate to send to a publicly archived mailing list, then please send it
841 to perl5-security-report@perl.org.  This points to a closed subscription
842 unarchived mailing list, which includes all the core committers, who will be
843 able to help assess the impact of issues, figure out a resolution, and help
844 co-ordinate the release of patches to mitigate or fix the problem across all
845 platforms on which Perl is supported.  Please only use this address for
846 security issues in the Perl core, not for modules independently distributed on
847 CPAN.
848
849 =head1 SEE ALSO
850
851 The F<Changes> file for an explanation of how to view exhaustive details on
852 what changed.
853
854 The F<INSTALL> file for how to build Perl.
855
856 The F<README> file for general stuff.
857
858 The F<Artistic> and F<Copying> files for copyright information.
859
860 =cut