This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl #80548] perldelta for DTrace package name change
[perl5.git] / pod / perldelta.pod
CommitLineData
3a5c9134
CBW
1=encoding utf8
2
59773fc7 3=for comment
7cdf3308 4This has been completed up to 26de4ac8, except for:
c6008483 5d9a4b459f94297889956ac3adc42707365f274c2
d66e82e8
FC
6bf5522a13a381257966e7ed6b731195a873b153e
79cef83062267e94311e1fd8744396e440642738e
70bfa48a 88e88cfee26d866223a6b3bfffce6270271de00db
59773fc7 9
3a5c9134
CBW
10=head1 NAME
11
12[ this is a template for a new perldelta file. Any text flagged as
13XXX needs to be processed before release. ]
14
15perldelta - what is new for perl v5.13.8
16
17=head1 DESCRIPTION
18
19This document describes differences between the 5.13.8 release and
20the 5.13.7 release.
21
dbbe2d83 22If you are upgrading from an earlier release such as 5.13.6, first read
3a5c9134
CBW
23L<perl5137delta>, which describes differences between 5.13.6 and
245.13.7.
25
26=head1 Notice
27
28XXX Any important notices here
29
30=head1 Core Enhancements
31
32XXX New core language features go here. Summarise user-visible core language
33enhancements. Particularly prominent performance optimisations could go
34here, but most should go in the L</Performance Enhancements> section.
35
36[ List each enhancement as a =head2 entry ]
37
b19934fb
NC
38=head2 C<-d:-foo> calls C<Devel::foo::unimport>
39
40The syntax C<-dI<B<:>foo>> was extended in 5.6.1 to make C<-dI<:fooB<=bar>>>
6a8c8694
FC
41equivalent to C<-MDevel::foo=bar>, which expands
42internally to C<use Devel::foo 'bar';>.
b19934fb
NC
43F<perl> now allows prefixing the module name with C<->, with the same
44semantics as C<-M>, I<i.e.>
45
46=over 4
47
48=item C<-d:-foo>
49
6a8c8694
FC
50Equivalent to C<-M-Devel::foo>, expands to
51C<no Devel::foo;>, calls C<< Devel::foo->unimport() >>
b19934fb
NC
52if the method exists.
53
54=item C<-d:-foo=bar>
55
6a8c8694
FC
56Equivalent to C<-M-Devel::foo=bar>, expands to C<no Devel::foo 'bar';>,
57calls C<< Devel::foo->unimport('bar') >> if the method exists.
b19934fb
NC
58
59=back
60
61This is particularly useful to suppresses the default actions of a
62C<Devel::*> module's C<import> method whilst still loading it for debugging.
63
15e6cdd9
DG
64=head2 Filehandle method calls load IO::File on demand
65
66When a method call on a filehandle would die because the method can not
67be resolved and L<IO::File> has not been loaded, Perl now loads IO::File
68via C<require> and attempts method resolution again:
69
70 open my $fh, ">", $file;
71 $fh->binmode(":raw"); # loads IO::File and succeeds
72
73This also works for globs like STDOUT, STDERR and STDIN:
74
75 STDOUT->autoflush(1);
76
77Because this on-demand load only happens if method resolution fails, the
78legacy approach of manually loading an IO::File parent class for partial
79method support still works as expected:
80
81 use IO::Handle;
82 open my $fh, ">", $file;
83 $fh->autoflush(1); # IO::File not loaded
84
20db7501
KW
85=head2 Full functionality for C<use feature 'unicode_strings'>
86
87This release provides full functionality for C<use feature
88'unicode_strings'>. Under its scope, all string operations executed and
89regular expressions compiled (even if executed outside its scope) have
90Unicode semantics. See L<feature>.
91
92This feature avoids the "Unicode Bug" (See
93L<perlunicode/The "Unicode Bug"> for details.) If their is a
94possibility that your code will process Unicode strings, you are
95B<strongly> encouraged to use this subpragma to avoid nasty surprises.
96
07291fb1
KW
97This availability of this should strongly affect the whole tone of
98various documents, such as L<perlunicode> and L<perluniintro>, but this
99work has not been done yet.
100
ee076ba5
FR
101=head2 Exception Handling Backcompat Hack
102
103When an exception is thrown in an C<eval BLOCK>, C<$@> is now set before
104unwinding, as well as being set after unwinding as the eval block exits. This
105early setting supports code that has historically treated C<$@> during unwinding
106as an indicator of whether the unwinding was due to an exception. These modules
107had been broken by 5.13.1's change from setting C<$@> early to setting it late.
108This double setting arrangement is a stopgap until the reason for unwinding can
109be made properly introspectable. C<$@> has never been a reliable indicator of
110this.
111
0d157ee2
DL
112=head2 DTrace probes now include package name
113
114The DTrace probes now include an additional argument (C<arg3>) which contains
115the package the subroutine being entered or left was compiled in.
116
117For example using the following DTrace script:
118
119 perl$target:::sub-entry
120 {
121 printf("%s::%s\n", copyinstr(arg0), copyinstr(arg3));
122 }
123
124and then running:
125
126 perl -e'sub test { }; test'
127
128DTrace will print:
129
130 main::test
131
3a5c9134
CBW
132=head1 Security
133
134XXX Any security-related notices go here. In particular, any security
135vulnerabilities closed should be noted here rather than in the
136L</Selected Bug Fixes> section.
137
138[ List each security issue as a =head2 entry ]
139
140=head1 Incompatible Changes
141
2dc78664 142=head2 Attempting to use C<:=> as an empty attribute list is now a syntax error
3a5c9134 143
2dc78664
NC
144Previously C<my $pi := 4;> was exactly equivalent to C<my $pi : = 4;>,
145with the C<:> being treated as the start of an attribute list, ending before
146the C<=>. The use of C<:=> to mean C<: => was deprecated in 5.12.0, and is now
147a syntax error. This will allow the future use of C<:=> as a new token.
3a5c9134 148
2dc78664
NC
149We find no Perl 5 code on CPAN using this construction, outside the core's
150tests for it, so we believe that this change will have very little impact on
151real-world codebases.
152
153If it is absolutely necessary to have empty attribute lists (for example,
baed7a72
NC
154because of a code generator) then avoid the error by adding a space before
155the C<=>.
3a5c9134 156
d66e82e8
FC
157=head2 Run-time code block in regular expressions
158
159Code blocks in regular expressions (C<(?{...})> and C<(??{...})>) used not
160to inherit any pragmata (strict, warnings, etc.) if the regular expression
161was compiled at run time as happens in cases like these two:
162
163 use re 'eval';
164 $foo =~ $bar; # when $bar contains (?{...})
165 $foo =~ /$bar(?{ $finished = 1 })/;
166
167This was a bug, which has now been fixed. But it has the potential to break
168any code that was relying on this bug.
169
3a5c9134
CBW
170=head1 Deprecations
171
172XXX Any deprecated features, syntax, modules etc. should be listed here.
173In particular, deprecated modules should be listed here even if they are
174listed as an updated module in the L</Modules and Pragmata> section.
175
176[ List each deprecation as a =head2 entry ]
177
59773fc7
FC
178=head2 C<?PATTERN?> is deprecated
179
180C<?PATTERN?> (without the initial m) has been deprecated and now produces
181a warning.
182
d59a8b3e
NC
183=head2 C<sv_compile_2op> is now deprecated
184
185The C<sv_compile_2op> is now deprecated, and will be removed. Searches suggest
186that nothing on CPAN is using it, so this should have zero impact.
187
188It attempted to provide an API to compile code down to an optree, but failed
189to bind correctly to lexicals in the enclosing scope. It's not possible to
190fix this problem within the constraints of its parameters and return value.
191
5609d5f9
FC
192=head2 Tie functions on scalars holding typeglobs
193
194Calling a tie function (C<tie>, C<tied>, C<untie>) with a scalar argument
195acts on a file handle if the scalar happens to hold a typeglob.
196
197This is a long-standing bug that will be removed in Perl 5.16, as
198there is currently no way to tie the scalar itself when it holds
199a typeglob, and no way to untie a scalar that has had a typeglob
200assigned to it.
201
202This bug was fixed in 5.13.7 but, because of the breakage it caused, the
203fix has been reverted. Now there is a deprecation warning whenever a tie
204function is used on a handle without an explicit C<*>.
205
3a5c9134
CBW
206=head1 Performance Enhancements
207
208XXX Changes which enhance performance without changing behaviour go here. There
209may well be none in a stable release.
210
211[ List each enhancement as a =item entry ]
212
213=over 4
214
215=item *
216
217XXX
218
219=back
220
221=head1 Modules and Pragmata
222
223XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
224go here. If Module::CoreList is updated, generate an initial draft of the
225following sections using F<Porting/corelist-perldelta.pl>, which prints stub
226entries to STDOUT. Results can be pasted in place of the '=head2' entries
227below. A paragraph summary for important changes should then be added by hand.
228In an ideal world, dual-life modules would have a F<Changes> file that could be
229cribbed.
230
231[ Within each section, list entries as a =item entry ]
232
233=head2 New Modules and Pragmata
234
235=over 4
236
237=item *
238
239XXX
240
241=back
242
243=head2 Updated Modules and Pragmata
244
245=over 4
246
247=item *
248
c2f8ff19
FR
249C<Devel::SelfStubber> has been upgraded from version 1.04 to 1.05.
250
251=item *
252
9cc8ef8a 253C<Digest::SHA> has been upgraded from 5.48 to 5.50
0a178734
CBW
254
255shasum now more closely mimics sha1sum/md5sum and Addfile
256accepts all POSIX filenames.
8d849515
FR
257
258=item *
259
260C<Dumpvalue> has been upgraded from version 1.14 to 1.15.
0a178734
CBW
261
262=item *
263
5b0bc4e8
FR
264C<Env> has been upgraded from version 1.01 to 1.02.
265
266=item *
267
d3413324 268C<ExtUtils::CBuilder> has been upgraded from 0.2703 to 0.2802
06e8058f
CBW
269
270=item *
271
11f2b7f3
FR
272C<if> has been upgraded from 0.06 to 0.0601.
273
274=item *
275
92c0bb90
FR
276C<Devel::SelfStubber> has been upgraded from version 1.03 to 1.04.
277
278=item *
279
39b09a1b
CBW
280C<IPC::Cmd> has been upgraded from 0.64 to 0.66
281
282Resolves an issue with splitting Win32 command lines
283and documentation enhancements.
284
285=item *
286
1245abf1
CBW
287C<Locale::Codes> has been upgraded from version 3.14 to 3.15
288
289=item *
290
28502098
FR
291C<Memoize> has been upgraded from version 1.01_03 to 1.02.
292
293=item *
294
37fa6334 295C<MIME::Base64> has been upgraded from 3.10 to 3.13
2456140e
CBW
296
297Now provides encode_base64url and decode_base64url functions to process
298the base64 scheme for "URL applications".
299
300=item *
301
ad033849
FC
302C<mro> has been upgraded from version 1.05 to 1.06.
303
304C<next::method> I<et al.> now take into account that every class inherits
305from UNIVERSAL
306L<[perl #68654]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68654>.
307
308=item *
309
2638c0ff
FC
310C<overload> has been upgraded from 1.11 to 1.12.
311
312=item *
313
314C<PerlIO::scalar> has been upgraded from 0.10 to 0.11.
315
316A C<read> after a C<seek> beyond the end of the string no longer thinks it
317has data to read
318L<[perl #78716]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78716>.
319
320=item *
321
f295f417
FC
322C<re> has been upgraded from 0.14 to 0.15.
323
324=item *
325
5ebfb99c 326C<Socket> has been upgraded from 1.91 to 1.92.
b373eab8
FC
327
328It has several new functions for handling IPv6 addresses.
329
330=item *
331
b6ae81ab
DL
332C<Storable> has been upgraded from 2.24 to 2.25.
333
334This adds support for serialising code references that contain UTF-8 strings
335correctly. The Storable minor version number changed as a result -- this means
336Storable users that set C<$Storable::accept_future_minor> to a C<FALSE> value
337will see errors (see L<Storable/FORWARD COMPATIBILITY> for more details).
338
339=item *
340
d4238815
FC
341C<Time::HiRes> has been upgraded from 1.9721 to 1.9721_01.
342
343=item *
344
68adb2b0
CBW
345C<Unicode::Collate> has been upgraded from 0.67 to 0.68
346
347=item *
348
59773fc7 349C<Unicode::UCD> has been upgraded from 0.29 to 0.30.
3a5c9134 350
c2e0289e
FC
351=item *
352
353C<version> has been upgraded from 0.82 to 0.86.
354
e6f1cc4d
FC
355=item *
356
357C<Win32> has been upgraded from 0.039 to 0.040.
358
3a5c9134
CBW
359=back
360
361=head2 Removed Modules and Pragmata
362
363=over 4
364
365=item *
366
367XXX
368
369=back
370
371=head1 Documentation
372
373XXX Changes to files in F<pod/> go here. Consider grouping entries by
374file and be sure to link to the appropriate page, e.g. L<perlfunc>.
375
376=head2 New Documentation
377
378XXX Changes which create B<new> files in F<pod/> go here.
379
380=head3 L<XXX>
381
382XXX Description of the purpose of the new file here
383
384=head2 Changes to Existing Documentation
385
386XXX Changes which significantly change existing files in F<pod/> go here.
387However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
388section.
389
390=head3 L<XXX>
391
392=over 4
393
394=item *
395
396XXX Description of the change here
397
398=back
399
400=head1 Diagnostics
401
402The following additions or changes have been made to diagnostic output,
403including warnings and fatal error messages. For the complete list of
404diagnostic messages, see L<perldiag>.
405
406XXX New or changed warnings emitted by the core's C<C> code go here. Also
407include any changes in L<perldiag> that reconcile it to the C<C> code.
408
409[ Within each section, list entries as a =item entry ]
410
411=head2 New Diagnostics
412
413XXX Newly added diagnostic messages go here
414
415=over 4
416
417=item *
418
4d4ca6a5 419There is a new "Closure prototype called" error.
3a5c9134
CBW
420
421=back
422
423=head2 Changes to Existing Diagnostics
424
425XXX Changes (i.e. rewording) of diagnostic messages go here
426
427=over 4
428
429=item *
430
c6008483
FC
431The "Found = in conditional" warning that is emitted when a constant is
432assigned to a variable in a condition is now withheld if the constant is
433actually a subroutine or one generated by C<use constant>, since the value
434of the constant may not be known at the time the program is written
435L<[perl #77762]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77762>.
3a5c9134
CBW
436
437=back
438
439=head1 Utility Changes
440
441XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
442here. Most of these are built within the directories F<utils> and F<x2p>.
443
444[ List utility changes as a =head3 entry for each utility and =item
445entries for each change
446Use L<XXX> with program names to get proper documentation linking. ]
447
448=head3 L<XXX>
449
450=over 4
451
452=item *
453
454XXX
455
456=back
457
458=head1 Configuration and Compilation
459
460XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
461go here. Any other changes to the Perl build process should be listed here.
462However, any platform-specific changes should be listed in the
463L</Platform Support> section, instead.
464
465[ List changes as a =item entry ].
466
467=over 4
468
469=item *
470
471XXX
472
473=back
474
475=head1 Testing
476
477XXX Any significant changes to the testing of a freshly built perl should be
478listed here. Changes which create B<new> files in F<t/> go here as do any
479large changes to the testing harness (e.g. when parallel testing was added).
480Changes to existing files in F<t/> aren't worth summarising, although the bugs
481that they represent may be covered elsewhere.
482
483[ List each test improvement as a =item entry ]
484
485=over 4
486
487=item *
488
489XXX
490
491=back
492
493=head1 Platform Support
494
495XXX Any changes to platform support should be listed in the sections below.
496
497[ Within the sections, list each platform as a =item entry with specific
498changes as paragraphs below it. ]
499
500=head2 New Platforms
501
502XXX List any platforms that this version of perl compiles on, that previous
503versions did not. These will either be enabled by new files in the F<hints/>
504directories, or new subdirectories and F<README> files at the top level of the
505source tree.
506
507=over 4
508
509=item XXX-some-platform
510
511XXX
512
513=back
514
515=head2 Discontinued Platforms
516
517XXX List any platforms that this version of perl no longer compiles on.
518
519=over 4
520
521=item XXX-some-platform
522
523XXX
524
525=back
526
527=head2 Platform-Specific Notes
528
529XXX List any changes for specific platforms. This could include configuration
530and compilation changes or changes in portability/compatibility. However,
531changes within modules for platforms should generally be listed in the
532L</Modules and Pragmata> section.
533
534=over 4
535
085d0904 536=item NetBSD
3a5c9134 537
085d0904
FC
538The NetBSD hints file has been changed to make the system's malloc the
539default.
3a5c9134
CBW
540
541=back
542
543=head1 Internal Changes
544
545XXX Changes which affect the interface available to C<XS> code go here.
546Other significant internal changes for future core maintainers should
547be noted as well.
548
549[ List each test improvement as a =item entry ]
550
551=over 4
552
553=item *
554
833f1b93
FR
555C<mg_findext> and C<sv_unmagicext> have been added.
556
557These new functions allow extension authors to find and remove magic attached to
558scalars based on both the magic type and the magic virtual table, similar to how
559C<sv_magicext> attaches magic of a certain type and with a given virtual table
560to a scalar. This eliminates the need for extensions to walk the list of
561C<MAGIC> pointers of an C<SV> to find the magic that belongs to them.
3a5c9134 562
c61b6d0f
FC
563=item *
564
565The C<parse_fullexpr()>, C<parse_listexpr(), C<parse_termexpr()> and
566C<parse_arithexpr()> functions have been added.
567
568These are for parsing expressions at various precedence levels.
569
3a5c9134
CBW
570=back
571
572=head1 Selected Bug Fixes
573
574XXX Important bug fixes in the core language are summarised here.
575Bug fixes in files in F<ext/> and F<lib/> are best summarised in
576L</Modules and Pragmata>.
577
578[ List each fix as a =item entry ]
579
580=over 4
581
582=item *
583
88e9444c
NC
584C<BEGIN {require 5.12.0}> now behaves as documented, rather than behaving
585identically to C<use 5.12.0;>. Previously, C<require> in a C<BEGIN> block
586was erroneously executing the C<use feature ':5.12.0'> and
587C<use strict; use warnings;> behaviour, which only C<use> was documented to
b373eab8
FC
588provide
589L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>.
590
591=item *
592
593C<use 5.42>
594L<[perl #69050]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=69050>,
595C<use 6> and C<no 5> no longer leak memory.
596
597=item *
598
599C<eval "BEGIN{die}"> no longer leaks memory on non-threaded builds.
3a5c9134 600
1428a560
FC
601=item *
602
603PerlIO no longer crashes when called recursively, e.g., from a signal
604handler. Now it just leaks memory
605L<[perl #75556]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75556>.
606
11cd2234
FC
607=item *
608
609Defining a constant with the same name as one of perl's special blocks
610(e.g., INIT) stopped working in 5.12.0, but has now been fixed
611L<[perl #78634]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78634>.
612
e3ef43a5
FC
613=item *
614
615A reference to a literal value used as a hash key (C<$hash{\"foo"}>) used
616to be stringified, even if the hash was tied
617L<[perl #79178]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79178>.
618
3ad6135d
FC
619=item *
620
3ad6135d
FC
621A closure containing an C<if> statement followed by a constant or variable
622is no longer treated as a constant
623L<[perl #63540]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=63540>.
624
4d4ca6a5
FC
625=item *
626
627Calling a closure prototype (what is passed to an attribute handler for a
7cdf3308
FC
628closure) now results in a "Closure prototype called" error message instead
629of a crash
4d4ca6a5
FC
630L<[perl #68560]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68560>.
631
085d0904
FC
632=item *
633
634A regular expression optimisation would sometimes cause a match with a
635C<{n,m}> quantifier to fail when it should match
636L<[perl #79152]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=79152>.
637
20db7501
KW
638=item *
639
640What has become known as the "Unicode Bug" is resolved in this release.
641Under C<use feature 'unicode_strings'>, the internal storage format of a
642string no longer affects the external semantics. There are two known
643exceptions. User-defined case changing functions, which are planned to
644be deprecated in 5.14, require utf8-encoded strings to function; and the
645character C<LATIN SMALL LETTER SHARP S> in regular expression
646case-insensitive matching has a somewhat different set of bugs depending
647on the internal storage format. Case-insensitive matching of all
648characters that have multi-character matches, as this one does, is
649problematical in Perl.
650L<[perl #58182]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=58182>.
651
70bfa48a
FC
652=item *
653
654Mentioning a read-only lexical variable from the enclosing scope in a
655string C<eval> would cause the variable to become writable
656L<[perl #19135]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=19135>.
657
f853e70a
FC
658=item *
659
660C<state> can now be used with attributes. It used to mean the same thing as
661C<my> if attributes were present
662L<[perl #68658]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68658>.
663
37079308
FC
664=item *
665
666Expressions like C<< @$a > 3 >> no longer cause C<$a> to be mentioned in
667the "Use of uninitialized value in numeric gt" warning when C<$a> is
668undefined (since it is not part of the C<E<gt>> expression, but the operand
669of the C<@>)
670L<[perl #72090]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72090>.
671
4c9d53d5
FC
672=item *
673
674C<require> no longer causes C<caller> to return the wrong file name for
675the scope that called C<require> and other scopes higher up that had the
676same file name
677L<[perl #68712]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=68712>.
678
0c7420e7
FC
679=item *
680
7cdf3308 681The ref types in the typemap for XS bindings now support magical variables
0c7420e7
FC
682L<[perl #72684]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72684>.
683
460c4bfb
FC
684=item *
685
686Match variables (e.g., C<$1>) no longer persist between calls to a sort
687subroutine
688L<[perl #76026]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=76026>.
689
26de4ac8
FC
690=item *
691
692The C<B> module was returning B::OPs instead of B::LOGOPs for C<entertry>
693L<[perl #80622]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=80622>.
694
695This was due to a bug in the perl core, not in C<B> itself.
696
3a5c9134
CBW
697=back
698
699=head1 Known Problems
700
701XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
702tests that had to be C<TODO>ed for the release would be noted here, unless
703they were specific to a particular platform (see below).
704
705This is a list of some significant unfixed bugs, which are regressions
706from either 5.XXX.XXX or 5.XXX.XXX.
707
708[ List each fix as a =item entry ]
709
710=over 4
711
712=item *
713
3ad6135d 714XXX
3a5c9134
CBW
715
716=back
717
718=head1 Obituary
719
720XXX If any significant core contributor has died, we've added a short obituary
721here.
722
723=head1 Acknowledgements
724
725XXX The list of people to thank goes here.
726
727=head1 Reporting Bugs
728
729If you find what you think is a bug, you might check the articles
730recently posted to the comp.lang.perl.misc newsgroup and the perl
731bug database at http://rt.perl.org/perlbug/ . There may also be
732information at http://www.perl.org/ , the Perl Home Page.
733
734If you believe you have an unreported bug, please run the L<perlbug>
735program included with your release. Be sure to trim your bug down
736to a tiny but sufficient test case. Your bug report, along with the
737output of C<perl -V>, will be sent off to perlbug@perl.org to be
738analysed by the Perl porting team.
739
740If the bug you are reporting has security implications, which make it
741inappropriate to send to a publicly archived mailing list, then please send
742it to perl5-security-report@perl.org. This points to a closed subscription
743unarchived mailing list, which includes all the core committers, who be able
744to help assess the impact of issues, figure out a resolution, and help
745co-ordinate the release of patches to mitigate or fix the problem across all
746platforms on which Perl is supported. Please only use this address for
747security issues in the Perl core, not for modules independently
748distributed on CPAN.
749
750=head1 SEE ALSO
751
752The F<Changes> file for an explanation of how to view exhaustive details
753on what changed.
754
755The F<INSTALL> file for how to build Perl.
756
757The F<README> file for general stuff.
758
759The F<Artistic> and F<Copying> files for copyright information.
760
761=cut