This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
e0414082a3ed432e3386a0128ac6528eab628eb3
[perl5.git] / pod / perldelta.pod
1 =encoding utf8
2
3 =for comment
4 This has been completed up to aebc0cbe, except for:
5 bb789b09de07edfb74477eb1603949c96d60927d (Dave Mitchell)
6
7 =head1 NAME
8
9 [ this is a template for a new perldelta file. Any text flagged as
10 XXX needs to be processed before release. ]
11
12 perldelta - what is new for perl v5.15.1
13
14 =head1 DESCRIPTION
15
16 This document describes differences between the 5.15.1 release and
17 the 5.15.0 release.
18
19 If you are upgrading from an earlier release such as 5.14.0, first read
20 L<perl5150delta>, which describes differences between 5.14.0 and
21 5.15.0.
22
23 =head1 Notice
24
25 XXX Any important notices here
26
27 =head1 Core Enhancements
28
29 XXX New core language features go here. Summarise user-visible core language
30 enhancements. Particularly prominent performance optimisations could go
31 here, but most should go in the L</Performance Enhancements> section.
32
33 [ List each enhancement as a =head2 entry ]
34
35 =head2 C<splice()> doesn't warn when truncating
36
37 You can now limit the size of an array using C<splice(@a,MAX_LEN)> without
38 worrying about warnings.
39
40 =head2 The C<\$> prototype accepts any scalar lvalue
41
42 The C<\$> and C<\[$]> subroutine prototypes now accept any scalar lvalue
43 argument.  Previously they only accepted scalars beginning with C<$> and
44 hash and array elements.  This change makes them consistent with the way
45 the built-in C<read> and C<recv> functions (among others) parse their
46 arguments. This means that one can override the built-in functions with
47 custom subroutines that parse their arguments the same way.
48
49 =head2 You can now C<study> more than one string
50
51 The restriction that you can only have one C<study> active at a time has been
52 removed. You can now usefully C<study> as many strings as you want (until you
53 exhaust memory).
54
55 =head2 The Unicode C<Script_Extensions> property is now supported.
56
57 New in Unicode 6.0, this is an improved C<Script> property.  Details
58 are in L<perlunicode/Scripts>.
59
60 =head2 DTrace probes for interpreter phase change
61
62 The C<phase-change> probes will fire when the interpreter's phase
63 changes, which tracks the C<${^GLOBAL_PHASE}> variable. C<arg0> is
64 the new phase name; C<arg1> is the old one. This is useful mostly
65 for limiting your instrumentation to one or more of: compile time,
66 run time, destruct time.
67
68 =head2 New Pad API
69
70 Many new functions have been added to the API for manipulating lexical
71 pads.  See L<perlapi/Pad Data Structures> for more information.
72
73 =head1 Security
74
75 XXX Any security-related notices go here.  In particular, any security
76 vulnerabilities closed should be noted here rather than in the
77 L</Selected Bug Fixes> section.
78
79 [ List each security issue as a =head2 entry ]
80
81 =head1 Incompatible Changes
82
83 XXX For a release on a stable branch, this section aspires to be:
84
85     There are no changes intentionally incompatible with 5.XXX.XXX
86     If any exist, they are bugs and reports are welcome.
87
88 [ List each incompatible change as a =head2 entry ]
89
90 =head1 Deprecations
91
92 XXX Any deprecated features, syntax, modules etc. should be listed here.
93 In particular, deprecated modules should be listed here even if they are
94 listed as an updated module in the L</Modules and Pragmata> section.
95
96 [ List each deprecation as a =head2 entry ]
97
98 =head1 Performance Enhancements
99
100 XXX Changes which enhance performance without changing behaviour go here. There
101 may well be none in a stable release.
102
103 [ List each enhancement as a =item entry ]
104
105 =over 4
106
107 =item *
108
109 The short-circuiting operators C<&&>, C<||>, and C<//> are now
110 considerably faster in the short-circuiting case due to reduced
111 OP-tree traversal.
112
113 =item *
114
115 The implementation of C<s///r> makes one less copy of the scalar's value.
116
117 =item *
118
119 If a studied scalar is C<split> with a regex, the engine will now take
120 advantage of the C<study> data.
121
122 =item *
123
124 C<study> now uses considerably less memory for shorter strings. Strings shorter
125 than 65535 characters use roughly half the memory than previously, strings
126 shorter than 255 characters use roughly one quarter of the memory.
127
128 =item *
129
130 Recursive calls to lvalue subroutines in lvalue scalar context use less
131 memory.
132
133 =back
134
135 =head1 Modules and Pragmata
136
137 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
138 go here.  If Module::CoreList is updated, generate an initial draft of the
139 following sections using F<Porting/corelist-perldelta.pl>, which prints stub
140 entries to STDOUT.  Results can be pasted in place of the '=head2' entries
141 below.  A paragraph summary for important changes should then be added by hand.
142 In an ideal world, dual-life modules would have a F<Changes> file that could be
143 cribbed.
144
145 [ Within each section, list entries as a =item entry ]
146
147 =head2 New Modules and Pragmata
148
149 =over 4
150
151 =item *
152
153 The logic for parsing, merging, and dumping XS typemaps has been extracted
154 from C<ExtUtils::ParseXS> into a module of its own, L<ExtUtils::Typemaps>.
155 C<ExtUtils::Typemaps> offers an interface to typemap handling outside of
156 the scope of the XS compiler itself.
157
158 As a first use case of the improved API and extensibility, typemaps can now
159 be included inline in XS code with a HEREDOC-like syntax:
160
161   TYPEMAP: <<END_TYPEMAP
162   MyType        T_IV
163   END_TYPEMAP
164
165 =back
166
167 =head2 Updated Modules and Pragmata
168
169 =over 4
170
171 =item *
172
173 L<B::Deparse> has been upgrade from version 1.05 to 1.06.
174
175 It now correctly deparses interpolation of punctuation variables (like
176 C<@*>) that do not interpolate without braces [perl #93990].
177
178 =item *
179
180 L<CGI> has been upgraded from version 3.54 to version 3.55
181
182 [THINGS THAT MAY BREAK YOUR CODE]
183
184 C<url()> was fixed to return C<PATH_INFO> when it is explicitly requested
185 with either the path=>1 or path_info=>1 flag.
186
187 If your code is running under mod_rewrite (or compatible) and you are calling C<self_url()> or
188 you are calling C<url()> and passing path_info=>1, These methods will actually be
189 returning C<PATH_INFO> now, as you have explicitly requested, or has C<self_url()>
190 has requested on your behalf.
191
192 The C<PATH_INFO> has been omitted in such URLs since the issue was introduced
193 in the 3.12 release in December, 2005.
194
195 This bug is so old your application may have come to depend on it or
196 workaround it. Check for application before upgrading to this release.
197
198 Examples of affected method calls:
199
200   $q->url(-absolute => 1, -query => 1, -path_info => 1 )
201   $q->url(-path=>1)
202   $q->url(-full=>1,-path=>1)
203   $q->url(-rewrite=>1,-path=>1)
204   $q->self_url();
205
206 =item *
207
208 L<Compress::Raw::Bzip2> has been upgraded from version 2.035 to version 2.037
209
210 =item *
211
212 L<Compress::Raw::Zlib> has been upgraded from version 2.035 to version 2.037
213
214 Added offset parameter to CRC32
215
216 =item *
217
218 L<Compress::Zlib> has been upgraded from version 2.035 to version 2.037
219
220 IO::Compress::Zip and IO::Uncompress::Unzip now have support for LZMA (method 14).
221 There is a fix for a CRC issue in IO::Compress::Unzip and it supports Streamed
222 Stored context now. And fixed a Zip64 issue in
223 IO::Compress::Zip when the content size was exactly 0xFFFFFFFF.
224
225 =item *
226
227 L<CPANPLUS> has been upgraded from version 0.9105 to version 0.9108
228
229 =item *
230
231 L<Cwd> has been upgraded from version 3.36 to 3.37, to address an
232 incompatibility with the EPIC debugger.
233
234 =item *
235
236 L<diagnostics> has been upgraded from version 1.22 to 1.23.
237
238 It now knows how to find descriptions for diagnostic messages ending with a
239 dot, instead getting confused by it.
240
241 =item *
242
243 L<ExtUtils::MakeMaker> has been upgraded from version 6.57_05 to version 6.58
244
245 =item *
246
247 L<ExtUtils::ParseXS> has been upgraded from version 2.2210 to 3.00_01.
248
249 Much of L<ExtUtils::ParseXS>, the module behind the XS compiler C<xsubpp>,
250 was rewritten and cleaned up. It has been made somewhat more extensible
251 and now finally uses strictures.
252
253 The typemap logic has been moved into a separate module,
254 L<ExtUtils::Typemaps>.  See L</New Modules and Pragmata>, above.
255
256 =item *
257
258 L<HTTP::Tiny> has been upgraded from version 0.012 to version 0.013.
259
260 Added support for using C<$ENV{http_proxy}> to set the default proxy host.
261
262 =item *
263
264 L<IPC::Cmd> has been upgraded from version 0.70 to version 0.72
265
266 Capturing of command output (both C<STDOUT> and C<STDERR>) is now supported
267 using L<IPC::Open3> on MSWin32 without requiring L<IPC::Run>.
268
269 =item *
270
271 L<Locale::Codes> has been upgraded from version 3.16 to version 3.17
272
273 Added Language Extension codes (langext) and Language Variation codes
274 (langvar) as defined in the IANA language registry.
275
276 Added language codes from ISO 639-5
277
278 Added language/script codes from the IANA language subtag
279 registry
280
281 Fixed an uninitialized value warning.  RT 67438
282
283 Fixed the return value for the all_XXX_codes and all_XXX_names functions.  RT 69100
284
285 Reorganized modules to move Locale::MODULE to Locale::Codes::MODULE to
286 allow for cleaner future additions.  The original four modules (Locale::Language,
287 Locale::Currency, Locale::Country, Locale::Script) will continue to work, but
288 all new sets of codes will be added in the Locale::Codes namespace.
289
290 =item *
291
292 L<attributes> has been upgraded from version 0.14 to 0.15, as part of the
293 lvalue attribute warnings fix.  See L</Selected Bug Fixes>, below.
294
295 =item *
296
297 L<Math::BigInt::FastCalc> has been upgraded from version 0.28 to version 0.29.
298
299 The XS code is now compiled with C<PERL_NO_GET_CONTEXT>, which will aid
300 performance under ithreads.
301
302 =item *
303
304 L<Module::CoreList> has been upgraded from version 2.51 to 2.53.
305
306 Some extraneous (and erroneous) entries have been removed
307 [rt.cpan.org #69108].
308
309 The C<corelist> utility now understands the C<-r> option for
310 displaying Perl release dates.
311
312 =item *
313
314 L<Pod::Perldoc> has been upgraded from version 3.15_05 to 3.15_06.
315
316 The B<-v> option now fetches the right section for C<$0>.
317
318 =item *
319
320 L<Pod::Simple> has been upgraded from version 3.16 to version 3.18
321
322 =item *
323
324 L<Unicode::Collate> has been upgraded from version 0.76 to version 0.77
325
326 Applied [perl #93470] silencing compiler warnings with -Wwrite-strings
327
328 =item *
329
330 L<Win32API::File> has been upgraded from version 0.1101 to version 0.1200
331
332 Added SetStdHandle and GetStdHandle functions
333
334 =item *
335
336 L<threads> has been upgraded from version 1.83 to 1.84
337
338 An unused variable was removed from the XS code.
339
340 =back
341
342 =head2 Removed Modules and Pragmata
343
344 =over 4
345
346 =item *
347
348 Perl 4-era .pl libraries
349
350 Perl used to bundle a handful of library files that predate Perl 5. Most of
351 these files, which have been deprecated since version 5.14.0, have now been
352 removed. If your code still relies on these libraries, you can install them
353 again from C<Perl4::CoreLibs> on CPAN.
354
355 =back
356
357 =head1 Documentation
358
359 XXX Changes to files in F<pod/> go here.  Consider grouping entries by
360 file and be sure to link to the appropriate page, e.g. L<perlfunc>.
361
362 =head2 New Documentation
363
364 XXX Changes which create B<new> files in F<pod/> go here.
365
366 =head3 L<perldtrace>
367
368 L<perldtrace> describes Perl's DTrace support, listing the provided probes
369 and gives examples of their use.
370
371 =head3 L<perl5141delta>
372
373 The delta file for Perl 5.14.1 has been copied to blead.
374
375 =head2 Changes to Existing Documentation
376
377 XXX Changes which significantly change existing files in F<pod/> go here.
378 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
379 section.
380
381 =head3 L<XXX>
382
383 =over 4
384
385 =item *
386
387 XXX Description of the change here
388
389 =item *
390
391 L<perlxs> was extended with documentation on inline typemaps.
392
393 =item *
394
395 L<perlref> has a new L<Circular References|perlref/Circular References>
396 section explaining how circularities may not be freed and how to solve that
397 with weak references.
398
399 =item *
400
401 The documentation for smart match in L<perlsyn> has been corrected for the
402 case of C<undef> on the left-hand side.  The list of different smart match
403 behaviours had an item in the wrong place.
404
405 =back
406
407 =head1 Diagnostics
408
409 The following additions or changes have been made to diagnostic output,
410 including warnings and fatal error messages.  For the complete list of
411 diagnostic messages, see L<perldiag>.
412
413 XXX New or changed warnings emitted by the core's C<C> code go here. Also
414 include any changes in L<perldiag> that reconcile it to the C<C> code.
415
416 [ Within each section, list entries as a =item entry that links to perldiag,
417   e.g.
418
419   =item *
420
421   L<Invalid version object|perldiag/"Invalid version object">
422 ]
423
424 =head2 New Diagnostics
425
426 XXX Newly added diagnostic messages go here
427
428 =head3 New Errors
429
430 =over 4
431
432 =item *
433
434 XXX L<message|perldiag/"message">
435
436 =back
437
438 =head3 New Warnings
439
440 =over 4
441
442 =item *
443
444 XXX L<message|perldiag/"message">
445
446 =back
447
448 =head2 Changes to Existing Diagnostics
449
450 XXX Changes (i.e. rewording) of diagnostic messages go here
451
452 =over 4
453
454 =item *
455
456 The L<Invalid version format|perldiag/"Invalid version format (%s)">
457 error message now says "negative version number" within the parentheses,
458 rather than "non-numeric data", for negative numbers.
459
460 =item *
461
462 The two warnings
463 L<Possible attempt to put comments in qw() list|perldiag/"Possible attempt to put comments in qw() list">
464 and
465 L<Possible attempt to separate words with commas|perldiag/"Possible attempt to separate words with commas">
466 are no longer mutually exclusive: the same C<qw> construct may produce
467 both.
468
469 =item *
470
471 Warnings that mention the names of lexical (C<my>) variables with Unicode
472 characters in them now respect the presence or absence of the C<:utf8>
473 layer on the output handle, instead of outputting UTF8 regardless.  Also,
474 the correct names are included in the strings passed to C<$SIG{__WARN__}>
475 handlers, rather than the raw UTF8 bytes.
476
477 =back
478
479 =head1 Utility Changes
480
481 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
482 here. Most of these are built within the directories F<utils> and F<x2p>.
483
484 [ List utility changes as a =head3 entry for each utility and =item
485 entries for each change
486 Use L<XXX> with program names to get proper documentation linking. ]
487
488 =head3 L<XXX>
489
490 =over 4
491
492 =item *
493
494 XXX
495
496 =back
497
498 =head1 Configuration and Compilation
499
500 XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
501 go here.  Any other changes to the Perl build process should be listed here.
502 However, any platform-specific changes should be listed in the
503 L</Platform Support> section, instead.
504
505 [ List changes as a =item entry ].
506
507 =over 4
508
509 =item *
510
511 XXX
512
513 =back
514
515 =head1 Testing
516
517 XXX Any significant changes to the testing of a freshly built perl should be
518 listed here.  Changes which create B<new> files in F<t/> go here as do any
519 large changes to the testing harness (e.g. when parallel testing was added).
520 Changes to existing files in F<t/> aren't worth summarising, although the bugs
521 that they represent may be covered elsewhere.
522
523 [ List each test improvement as a =item entry ]
524
525 =over 4
526
527 =item *
528
529 F<t/run/dtrace.t> was added to test Perl's DTrace support. This
530 test will only be run if your Perl was built with C<-Dusedtrace>
531 and if calling C<dtrace> actually lets you instrument code. This
532 generally requires being run as root, so this test file is primarily
533 intended for use by the dtrace subcommittee of p5p.
534
535 =item *
536
537 F<t/win32/runenv.t> was added to test aspects of Perl's environment
538 variable handling on MSWin32 platforms.  Previously, such tests were
539 skipped on MSWin32 platforms.
540
541 =back
542
543 =head1 Platform Support
544
545 XXX Any changes to platform support should be listed in the sections below.
546
547 [ Within the sections, list each platform as a =item entry with specific
548 changes as paragraphs below it. ]
549
550 =head2 New Platforms
551
552 XXX List any platforms that this version of perl compiles on, that previous
553 versions did not. These will either be enabled by new files in the F<hints/>
554 directories, or new subdirectories and F<README> files at the top level of the
555 source tree.
556
557 =over 4
558
559 =item XXX-some-platform
560
561 XXX
562
563 =back
564
565 =head2 Discontinued Platforms
566
567 XXX List any platforms that this version of perl no longer compiles on.
568
569 =over 4
570
571 =item XXX-some-platform
572
573 XXX
574
575 =back
576
577 =head2 Platform-Specific Notes
578
579 XXX List any changes for specific platforms. This could include configuration
580 and compilation changes or changes in portability/compatibility.  However,
581 changes within modules for platforms should generally be listed in the
582 L</Modules and Pragmata> section.
583
584 =head3 Windows
585
586 =over
587
588 =item *
589
590 On Windows 7, 2008 and Vista, C<@INC> is now always properly populated
591 based on the value of PERL5LIB set in the environment.  Previously,
592 values of PERL5LIB longer than 32766 bytes were skipped when C<@INC>
593 was being populated.  Tests for environment handling were
594 also added (see L</Testing> section).  Fixes
595 L<RT #87322|https://rt.perl.org/rt3/Public/Bug/Display.html?id=87322>.
596
597 =back
598
599 =head3 XXX-some-platform
600
601 =over
602
603 =item *
604
605 XXX
606
607 =back
608
609 =head1 Internal Changes
610
611 XXX Changes which affect the interface available to C<XS> code go here.
612 Other significant internal changes for future core maintainers should
613 be noted as well.
614
615 [ List each change as a =item entry ]
616
617 =over 4
618
619 =item *
620
621 The expermental C<fetch_cop_label> function has been renamed to
622 C<cop_fetch_label>.
623
624 =item *
625
626 The C<cop_store_label> function has been added to the API, but is
627 experimental.
628
629 =back
630
631 =head1 Selected Bug Fixes
632
633 XXX Important bug fixes in the core language are summarised here.
634 Bug fixes in files in F<ext/> and F<lib/> are best summarised in
635 L</Modules and Pragmata>.
636
637 [ List each fix as a =item entry ]
638
639 =over 4
640
641 =item *
642
643 Applying the :lvalue attribute to subroutine that is already defined does
644 not work properly, as the attribute changes the way the sub is compiled.
645 Hence, Perl 5.12 began warning when an attempt is made to apply the
646 attribute to an already defined sub.  In such cases, the attribute is
647 discarded.
648
649 But the change in 5.12 missed the case where custom attributes are also
650 present: that case still silently and ineffectively applied the attribute.
651 That omission has now been corrected.  C<sub foo :lvalue :Whatever> (when
652 C<foo> is already defined) now warns about the :lvalue attribute, and does
653 not apply it.
654
655 L<attributes.pm|attributes> has likewise been updated to warn and not apply
656 the attribute.
657
658 =item *
659
660 =for comment
661 Not necessary for perl5160delta
662
663 The remaining discrepancies between explicit and implicit return from
664 lvalue subroutines have been resolved.  They mainly involved which error
665 message to display when a read-only value is returned in lvalue context.
666 Also, returning a PADTMP (the result of most built-ins, like C<index>) in
667 lvalue context is now forbidden for explicit return, as it always has been
668 for implicit return.  This is not a regression from 5.14, as all the cases
669 in which it could happen where previously syntax errors.
670
671 =item *
672
673 =for comment
674 Not necessary for perl5160delta
675
676 Explicitly returning a tied C<my> variable from an lvalue subroutine in
677 list lvalue context used to clear the variable before the assignment could
678 happen.  This is something that was missed when explicit return was made to
679 work in 5.15.0.
680
681 =item *
682
683 =for comment
684 Not necessary for perl5160delta
685
686 A minor memory leak, introduced in 5.15.0, has been fixed.  It would occur
687 when a hash is freed that has had its current iterator deleted
688 [perl #93454].
689
690 =item *
691
692 The C<prototype> function now returns a prototype (the empty string) for
693 the C<__FILE__>, C<__LINE__> and C<__PACKAGE__> directives, instead of
694 dying, as they are indistinguishable syntactically from nullary functions
695 like C<time>.
696
697 =item *
698
699 A bug affecting lvalue context propagation through nested lvalue subroutine
700 calls has been fixed.  Previously, returning a value in nested rvalue
701 context would be treated as lvalue context by the inner subroutine call,
702 resulting in some values (such as read-only values) being rejected.
703
704 =item *
705
706 Some core bugs affecting L<Hash::Util> have been fixed: locking a hash
707 element that is a glob copy no longer causes subsequent assignment to it to
708 corrupt the glob, and unlocking a hash element that holds a copy-on-write
709 scalar no longer causes modifications to that scalar to modify other
710 scalars that were sharing the same string buffer.
711
712 =item *
713
714 C<when> blocks are now capable of returning variables declared inside the
715 enclosing C<given> block [perl #93548].
716
717 =item *
718
719 A problem with context propagation when a C<do> block is an argument to
720 C<return> has been fixed.  It used to cause undefined to be returned in
721 some cases of a C<return> inside an C<if> block which itself is followed by
722 another C<return>.
723
724 =item *
725
726 Calling C<index> with a tainted constant no longer causes constants in
727 subsequently compiled code to become tainted [perl #64804].
728
729 =item *
730
731 The peephole optimiser uses less recursion than before, making it possible
732 to evaluate code like C<eval ("{\$x = 1 }\n" x 100000)> without a crash.
733
734 =item *
735
736 Use of lexical (C<my>) variables in code blocks embedded in regular
737 expressions will no longer result in memory corruption or crashes.
738
739 Nevertheless, these code blocks are still experimental, as there are still
740 problems with the wrong variables being closed over (in loops for instance)
741 and with abnormal exiting (e.g., C<die>) causing memory corruption.
742
743 =item *
744
745 The C<SvIsCOW> C macro now returns false for read-only copies of typeglobs,
746 such as those created by:
747
748   $hash{elem} = *foo;
749   Hash::Util::lock_value %hash, 'elem';
750
751 It used to return true.
752
753 =back
754
755 =head1 Known Problems
756
757 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
758 tests that had to be C<TODO>ed for the release would be noted here, unless
759 they were specific to a particular platform (see below).
760
761 This is a list of some significant unfixed bugs, which are regressions
762 from either 5.XXX.XXX or 5.XXX.XXX.
763
764 [ List each fix as a =item entry ]
765
766 =over 4
767
768 =item *
769
770 XXX
771
772 =back
773
774 =head1 Obituary
775
776 XXX If any significant core contributor has died, we've added a short obituary
777 here.
778
779 =head1 Acknowledgements
780
781 Generate this with:
782
783   perl Porting/acknowledgements.pl v5.15.0..HEAD
784
785 =head1 Reporting Bugs
786
787 If you find what you think is a bug, you might check the articles
788 recently posted to the comp.lang.perl.misc newsgroup and the perl
789 bug database at http://rt.perl.org/perlbug/ .  There may also be
790 information at http://www.perl.org/ , the Perl Home Page.
791
792 If you believe you have an unreported bug, please run the L<perlbug>
793 program included with your release.  Be sure to trim your bug down
794 to a tiny but sufficient test case.  Your bug report, along with the
795 output of C<perl -V>, will be sent off to perlbug@perl.org to be
796 analysed by the Perl porting team.
797
798 If the bug you are reporting has security implications, which make it
799 inappropriate to send to a publicly archived mailing list, then please send
800 it to perl5-security-report@perl.org. This points to a closed subscription
801 unarchived mailing list, which includes
802 all the core committers, who will be able
803 to help assess the impact of issues, figure out a resolution, and help
804 co-ordinate the release of patches to mitigate or fix the problem across all
805 platforms on which Perl is supported. Please only use this address for
806 security issues in the Perl core, not for modules independently
807 distributed on CPAN.
808
809 =head1 SEE ALSO
810
811 The F<Changes> file for an explanation of how to view exhaustive details
812 on what changed.
813
814 The F<INSTALL> file for how to build Perl.
815
816 The F<README> file for general stuff.
817
818 The F<Artistic> and F<Copying> files for copyright information.
819
820 =cut