This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta galore for ExtUtils::ParseXS changes
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
d2006265
FC
3=for comment
4This has been completed up to 527d644b124fe.
5
44691e6f
AB
6=head1 NAME
7
63ac71b9
RS
8[ this is a template for a new perldelta file. Any text flagged as
9XXX needs to be processed before release. ]
10
f25d4e05 11perldelta - what is new for perl v5.15.3
760696b8 12
5438d4b8 13=head1 DESCRIPTION
5cd408a2 14
f25d4e05
RS
15This document describes differences between the 5.15.2 release and
16the 5.15.3 release.
5cd408a2 17
f25d4e05
RS
18If you are upgrading from an earlier release such as 5.15.1, first read
19L<perl5152delta>, which describes differences between 5.15.1 and
205.15.2.
062678b2 21
63ac71b9 22=head1 Notice
4185c919 23
63ac71b9 24XXX Any important notices here
0afed34d 25
63ac71b9 26=head1 Core Enhancements
0afed34d 27
63ac71b9
RS
28XXX New core language features go here. Summarise user-visible core language
29enhancements. Particularly prominent performance optimisations could go
30here, but most should go in the L</Performance Enhancements> section.
0afed34d 31
63ac71b9 32[ List each enhancement as a =head2 entry ]
0afed34d 33
d2006265
FC
34=head2 More CORE subs are callable through references
35
c148612c 36Perl 5.15.2 introduced subroutines in the CORE namespace. Most of them
d2006265
FC
37could only be called as barewords; i.e., they could be aliased at compile
38time and then inlined under new names.
39
2702a50a
FC
40Almost all of these functions can now be called through references and via
41C<&foo()> syntax, bypassing the prototype. See L<CORE> for a list of the
42exceptions.
d2006265 43
63ac71b9 44=head1 Security
0afed34d 45
63ac71b9
RS
46XXX Any security-related notices go here. In particular, any security
47vulnerabilities closed should be noted here rather than in the
48L</Selected Bug Fixes> section.
135c0b08 49
63ac71b9 50[ List each security issue as a =head2 entry ]
135c0b08 51
46661105
CB
52=head2 C<File::Glob::bsd_glob()> memory error with GLOB_ALTDIRFUNC (CVE-2011-2728).
53
54Calling C<File::Glob::bsd_glob> with the unsupported flag GLOB_ALTDIRFUNC would
55cause an access violation / segfault. A Perl program that accepts a flags value from
56an external source could expose itself to denial of service or arbitrary code
57execution attacks. There are no known exploits in the wild. The problem has been
58corrected by explicitly disabling all unsupported flags and setting unused function
59pointers to null. Bug reported by Clément Lecigne.
60
5438d4b8 61=head1 Incompatible Changes
7818c927 62
e1dccc0d
Z
63=head2 $[ has been removed
64
65The array/string index offsetting mechanism, controlled by the C<$[> magic
66variable, has been removed. C<$[> now always reads as zero. Writing a
67zero to it is still permitted, but writing a non-zero value causes an
68exception. Those hopelessly addicted to FORTRAN-style 1-based indexing
69may wish to use the module L<Array::Base>, which provides an independent
70implementation of the index offsetting concept, or L<Classic::Perl>,
71which allows L<Array::Base> to be controlled through assignment to C<$[>.
72
5d1892be 73=head2 User-defined case changing operations.
7b2b001e 74
5d1892be
KW
75This feature was deprecated in Perl 5.14, and has now been removed.
76The CPAN module L<Unicode::Casing> provides better functionality without
77the drawbacks that this feature had, as are detailed in the 5.14
78documentation:
79L<http://perldoc.perl.org/5.14.0/perlunicode.html#User-Defined-Case-Mappings-%28for-serious-hackers-only%29>
bdb9ba77 80
7ec04da5
S
81=head2 XSUBs are now 'static'
82
83XSUB C functions are now 'static', that is, they are not visible from
404452ea
S
84outside the compilation unit. Users can use the new C<XS_EXTERNAL(name)>
85and C<XS_INTERNAL(name)> macros to pick the desired linking behaviour.
86The ordinary C<XS(name)> declaration for XSUBs will continue to declare
87non-'static' XSUBs for compatibility, but the XS compiler,
88C<ExtUtils::ParseXS> (C<xsubpp>) will emit 'static' XSUBs by default.
89C<ExtUtils::ParseXS>'s behaviour can be reconfigured from XS using the
7ec04da5
S
90C<EXPORT_XSUB_SYMBOLS> keyword, see L<perlxs> for details.
91
63ac71b9 92=head1 Deprecations
760696b8 93
63ac71b9
RS
94XXX Any deprecated features, syntax, modules etc. should be listed here.
95In particular, deprecated modules should be listed here even if they are
96listed as an updated module in the L</Modules and Pragmata> section.
760696b8 97
63ac71b9 98[ List each deprecation as a =head2 entry ]
760696b8 99
63ac71b9 100=head1 Performance Enhancements
115ff745 101
63ac71b9
RS
102XXX Changes which enhance performance without changing behaviour go here. There
103may well be none in a stable release.
115ff745 104
63ac71b9 105[ List each enhancement as a =item entry ]
115ff745 106
63ac71b9 107=over 4
4ea805df
CBW
108
109=item *
110
63ac71b9 111XXX
1ba7a2fb 112
63ac71b9 113=back
730e5b5b 114
63ac71b9 115=head1 Modules and Pragmata
730e5b5b 116
63ac71b9
RS
117XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
118go here. If Module::CoreList is updated, generate an initial draft of the
119following sections using F<Porting/corelist-perldelta.pl>, which prints stub
120entries to STDOUT. Results can be pasted in place of the '=head2' entries
121below. A paragraph summary for important changes should then be added by hand.
122In an ideal world, dual-life modules would have a F<Changes> file that could be
123cribbed.
730e5b5b 124
63ac71b9 125[ Within each section, list entries as a =item entry ]
730e5b5b 126
63ac71b9 127=head2 New Modules and Pragmata
a30cae0b 128
63ac71b9 129=over 4
a30cae0b
CBW
130
131=item *
132
63ac71b9 133XXX
bbc28bfc 134
63ac71b9 135=back
bbc28bfc 136
63ac71b9 137=head2 Updated Modules and Pragmata
e46d9735 138
63ac71b9 139=over 4
e46d9735
CBW
140
141=item *
142
5f8b5b70
NC
143L<AnyDBM_File> has been upgraded from version 1.00 to version 1.01.
144
145This is only a minor documentation update.
146
147=item *
148
43c6b706 149L<Archive::Extract> has been upgraded from version 0.52 to version 0.56.
4afdee4c
CBW
150
151Resolved an issue where C<unzip> executable was present in C<PATH> on MSWin32
57126352 152
d93f0209
FC
153=item *
154
93e94d8a
CBW
155L<Archive::Tar> has been upgraded from version 1.76 to version 1.78.
156
157=item *
158
755f12e5
NC
159L<CPANPLUS> has been upgraded from version 0.9109 to version 0.9110.
160
161=item *
162
50b3d220
CBW
163L<CPANPLUS::Dist::Build> has been upgraded from version 0.56 to version 0.58.
164
165=item *
166
49ef49fe
CBW
167L<Devel::PPPort> has been upgraded from version 3.19 to version 3.20.
168
169=item *
170
43c6b706 171L<diagnostics> has been upgraded from version 1.24 to version 1.25.
d2006265
FC
172
173It now strips out C<SZ<><...>> formatting codes before displaying
174descriptions [perl #94488].
175
176=item *
177
4bbdbd51
NC
178L<Data::Dumper> has been upgraded from version 2.133 to version 2.134.
179
180The XS code for sorting hash keys has been simplified slightly.
181
182=item *
183
404452ea 184L<ExtUtils::ParseXS> has been upgraded from version 3.03_01 to version 3.04_04.
98e61122
NC
185
186The handling of C<dVAR> in the generated XS code has been simplified.
187
404452ea
S
188The previously broken "INCLUDE: ... |" functionality has been repaired
189(CPAN RT #70213).
190
191A compatibility-workaround for modules that cannot
192live with the new XSUB staticness (see I<XSUBs are now static> above)
193has been implemented with the C<PERL_EUPXS_ALWAYS_EXPORT> and
194C<PERL_EUPXS_NEVER_EXPORT> preprocessor defines.
195
196The compiler warnings when -except option is used with F<xsubpp>
197have been fixed.
198
199The XSUB.h changes to make C<XS(name)> use C<XS_INTERNAL(name)>
200by default (which were in the 5.15.2 dev release of perl)
201have been reverted since too many CPAN modules expect to
202be able to refer to XSUBs declared with C<XS(name)>.
203Instead, C<ExtUtils::ParseXS> will define a copy of the
204C<XS_INTERNAL>/C<XS_EXTERNAL> macros as necessary going back to
205perl 5.10.0. By default, ExtUtils::ParseXS will use
206C<XS_INTERNAL(name)> instead of C<XS(name)>.
207
208Fixed regression for input-typemap override in XS argument
209list (CPAN RT #70448).
210
211C<ExtUtils::Typemaps> now properly strips trailing semicolons
212from inputmaps. These could previously trigger warnings (errors
213in strict C89 compilers) due to additional semicolons being
214interpreted as empty statements.
215
216Now detects and throws a warning if there is a C<CODE> section using
217C<RETVAL>, but no C<OUTPUT> section (CPAN RT #69536).
218
98e61122
NC
219=item *
220
43c6b706
CBW
221L<Locale::Codes> has been upgraded from version 3.17 to version 3.18.
222
223The CIA world added non-standard values, so this is no longer used as a source
224of data.
225
226=item *
227
46661105
CB
228L<File::Glob> has been upgraded from version 1.12 to version 1.13.
229
230See L</Security>.
231
232=item *
233
0b2be169
FC
234L<Filter::Simple> has been upgrade from version 0.87 to 0.88.
235
236It is now better at detecting the end of a pod section. It always checks
237for =cut, instead of checking for =end (if the pod begins with =begin) or
238the end of the paragraph (if the pod begins with =for) [perl #92436].
239
240=item *
241
43c6b706 242L<Math::BigRat> has been upgraded from version 0.2602 to version 0.2603.
d93f0209
FC
243
244C<int()> on a Math::BigRat object containing -1/2 now creates a
245Math::BigInt containing 0, rather than -0. L<Math::BigInt> does not even
246support negative zero, so the resulting object was actually malformed
247[perl #95530].
248
60527824
FR
249=item *
250
d6ee8587 251L<Module::Metadata> has been upgraded from version 1.000005_01 to version 1.000007.
d39de893
CBW
252
253=item *
254
39afdc5a
CBW
255L<Module::Load::Conditional> has been upgraded from version 0.44 to version 0.46.
256
257=item *
258
666c7ca6
NC
259L<ODBM_File> has been upgraded from version 1.11 to version 1.12.
260
261This is only a minor refactoring of the XS code to bring it closer to the
262other C<?DBM_File> modules.
263
264=item *
265
a9feb6cb
CBW
266L<perlfaq> has been upgraded from version 5.01500302 to version 5.0150033.
267
268=item *
269
43c6b706 270L<Pod::Simple> has been upgraded from version 3.18 to version 3.19.
60527824 271
7ac26854
NC
272=item *
273
274L<POSIX> has been upgraded from version 1.24 to version 1.25.
275
276L<POSIX> no longer uses L<AutoLoader>. Any code which was relying on this
277implementation detail was buggy, and may fail as a result of this change.
278The module's Perl code has been considerably simplified, roughly halving
279the number of lines, with no change in functionality.
280
daef35db
NC
281=item *
282
283L<XSLoader> has been upgraded from version 0.15 to version 0.16.
284
63ac71b9 285=back
259925f6 286
63ac71b9 287=head2 Removed Modules and Pragmata
6252d2e2 288
63ac71b9 289=over 4
9840cdee
CBW
290
291=item *
292
63ac71b9 293XXX
54e02335 294
63ac71b9 295=back
310913d4 296
63ac71b9 297=head1 Documentation
310913d4 298
63ac71b9
RS
299XXX Changes to files in F<pod/> go here. Consider grouping entries by
300file and be sure to link to the appropriate page, e.g. L<perlfunc>.
7b2b001e 301
63ac71b9 302=head2 New Documentation
7b2b001e 303
b89e9b0d 304=head3 L<perlootut>
7b2b001e 305
b89e9b0d
DR
306This a new OO tutorial. It focuses on basic OO concepts, and then recommends
307that readers choose an OO framework from CPAN.
2df9265e 308
63ac71b9 309=head2 Changes to Existing Documentation
2df9265e 310
b89e9b0d 311=head3 L<perlobj>
dc80b0c6 312
63ac71b9 313=over 4
83b32788
CBW
314
315=item *
316
b89e9b0d
DR
317This document has been rewritten from scratch, and its coverage of various OO
318concepts has been expanded.
4eb81ef2 319
63ac71b9 320=back
4eb81ef2 321
b89e9b0d
DR
322=head2 Removed Documentation
323
324=head3 Old OO Documentation
325
326All the old OO tutorials, perltoot, perltooc, and perlboot, have been
327removed. The perlbot (bag of object tricks) document has been removed as well.
328
63ac71b9 329=head1 Diagnostics
4eb81ef2 330
63ac71b9
RS
331The following additions or changes have been made to diagnostic output,
332including warnings and fatal error messages. For the complete list of
333diagnostic messages, see L<perldiag>.
82eefd8a 334
63ac71b9
RS
335XXX New or changed warnings emitted by the core's C<C> code go here. Also
336include any changes in L<perldiag> that reconcile it to the C<C> code.
82eefd8a 337
63ac71b9
RS
338[ Within each section, list entries as a =item entry that links to perldiag,
339 e.g.
6252d2e2 340
63ac71b9 341 =item *
6252d2e2 342
63ac71b9
RS
343 L<Invalid version object|perldiag/"Invalid version object">
344]
5213914c 345
63ac71b9 346=head2 New Diagnostics
5213914c 347
63ac71b9 348XXX Newly added diagnostic messages go here
5213914c 349
63ac71b9 350=head3 New Errors
17609435 351
63ac71b9 352=over 4
17609435 353
69f26f52
CBW
354=item *
355
63ac71b9 356XXX L<message|perldiag/"message">
69f26f52 357
5438d4b8 358=back
77ccfaeb 359
63ac71b9 360=head3 New Warnings
c69a30ec 361
63ac71b9
RS
362=over 4
363
364=item *
7c420290 365
63ac71b9 366XXX L<message|perldiag/"message">
7818c927 367
63ac71b9 368=back
7818c927 369
63ac71b9 370=head2 Changes to Existing Diagnostics
dd413713 371
63ac71b9 372XXX Changes (i.e. rewording) of diagnostic messages go here
7818c927 373
5438d4b8 374=over 4
7818c927
FC
375
376=item *
377
63ac71b9 378XXX Describe change here
5aeca1f7 379
5438d4b8 380=back
5aeca1f7 381
63ac71b9 382=head1 Utility Changes
0cb4637e 383
63ac71b9
RS
384XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
385here. Most of these are built within the directories F<utils> and F<x2p>.
0cb4637e 386
63ac71b9
RS
387[ List utility changes as a =head3 entry for each utility and =item
388entries for each change
389Use L<XXX> with program names to get proper documentation linking. ]
4abaf918 390
63ac71b9 391=head3 L<XXX>
4abaf918 392
5438d4b8 393=over 4
4abaf918
Z
394
395=item *
396
63ac71b9 397XXX
8b00e523 398
e8e35311
FC
399=back
400
63ac71b9 401=head1 Configuration and Compilation
b908e258 402
63ac71b9
RS
403XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
404go here. Any other changes to the Perl build process should be listed here.
405However, any platform-specific changes should be listed in the
406L</Platform Support> section, instead.
b908e258 407
63ac71b9 408[ List changes as a =item entry ].
b908e258 409
63ac71b9 410=over 4
71449ad0
DG
411
412=item *
413
5ecd28b8
NC
414The file F<global.sym> is no longer needed, and has been removed. It
415contained a list of all exported functions, one of the files generated by
416F<regen/embed.pl> from data in F<embed.fnc> and F<regen/opcodes>. The code
417has been refactored so that the only user of F<global.sym>, F<makedef.pl>,
418now reads F<embed.fnc> and F<regen/opcodes> directly, removing the need to
419store the list of exported functions in an intermediate file.
420
421As F<global.sym> was never installed, this change will not be visible
422outside the build process.
b908e258 423
6693394d
FC
424=back
425
63ac71b9 426=head1 Testing
bbc28bfc 427
63ac71b9
RS
428XXX Any significant changes to the testing of a freshly built perl should be
429listed here. Changes which create B<new> files in F<t/> go here as do any
430large changes to the testing harness (e.g. when parallel testing was added).
431Changes to existing files in F<t/> aren't worth summarising, although the bugs
432that they represent may be covered elsewhere.
bbc28bfc 433
63ac71b9 434[ List each test improvement as a =item entry ]
b7188eb5 435
34dc2ec0 436=over 4
42a91c97 437
6693394d 438=item *
42a91c97 439
c752c500
FC
440F<t/porting/globvar.t> has been added, to run a sanity check on F<globar.sym>.
441F<globar.sym> is not needed on most *nix platforms, but is for Win32, hence
442previously was it was possible to inadvertently commit changes that worked
443perfectly locally, but broke the build on Win32.
310913d4 444
d2006265
FC
445=item *
446
447F<t/op/unlink.t> has been added to test the C<unlink> function.
448
34dc2ec0 449=back
42a91c97 450
0890f1a5 451=head1 Platform Support
975dff8c 452
63ac71b9 453XXX Any changes to platform support should be listed in the sections below.
9cfd094e 454
63ac71b9
RS
455[ Within the sections, list each platform as a =item entry with specific
456changes as paragraphs below it. ]
9cfd094e 457
63ac71b9 458=head2 New Platforms
9cfd094e 459
63ac71b9
RS
460XXX List any platforms that this version of perl compiles on, that previous
461versions did not. These will either be enabled by new files in the F<hints/>
462directories, or new subdirectories and F<README> files at the top level of the
463source tree.
7c4c6e7c 464
5438d4b8 465=over 4
95f7e41f 466
63ac71b9 467=item XXX-some-platform
95f7e41f 468
63ac71b9 469XXX
df5b44bd 470
63ac71b9 471=back
310913d4 472
63ac71b9 473=head2 Discontinued Platforms
310913d4 474
63ac71b9 475XXX List any platforms that this version of perl no longer compiles on.
310913d4 476
63ac71b9
RS
477=over 4
478
479=item XXX-some-platform
480
481XXX
310913d4 482
5438d4b8 483=back
df5b44bd 484
63ac71b9
RS
485=head2 Platform-Specific Notes
486
487XXX List any changes for specific platforms. This could include configuration
488and compilation changes or changes in portability/compatibility. However,
489changes within modules for platforms should generally be listed in the
490L</Modules and Pragmata> section.
e22e289d 491
5438d4b8 492=over 4
7818c927 493
63ac71b9 494=item XXX-some-platform
7818c927 495
63ac71b9 496XXX
f79aa60b 497
63ac71b9 498=back
7818c927 499
63ac71b9 500=head1 Internal Changes
3fdd840f 501
63ac71b9
RS
502XXX Changes which affect the interface available to C<XS> code go here.
503Other significant internal changes for future core maintainers should
504be noted as well.
3fdd840f 505
63ac71b9 506[ List each change as a =item entry ]
7ffa7e75 507
63ac71b9 508=over 4
7ffa7e75 509
862b2c43
FC
510=item *
511
63ac71b9 512XXX
862b2c43 513
63ac71b9 514=back
c973bd4f 515
63ac71b9 516=head1 Selected Bug Fixes
a6cefd81 517
63ac71b9
RS
518XXX Important bug fixes in the core language are summarised here.
519Bug fixes in files in F<ext/> and F<lib/> are best summarised in
520L</Modules and Pragmata>.
a6cefd81 521
63ac71b9 522[ List each fix as a =item entry ]
c4499eff 523
63ac71b9 524=over 4
c4499eff 525
bbc28bfc
FC
526=item *
527
d2006265
FC
528In Perl 5.15.0 C<defined(${'$'})> stopped returning true if the C<$$>
529variable had not been used yet. This has been fixed.
530
531=item *
532
b4155db2
FC
533C<defined(${"..."})>, C<defined(*{"..."})>, etc., used to
534return true for most, but not all built-in variables, if
535they had not been used yet. Many times that new built-in
536variables were added in past versions, this construct was
23496c6e 537not taken into account, so this affected C<${^GLOBAL_PHASE}> and
b4155db2
FC
538C<${^UTF8CACHE}>, among others. It also used to return false if the
539package name was given as well (C<${"::!"}>) and for subroutines in the
540CORE package [perl #97978] [perl #97492] [perl #97484].
23496c6e
FC
541
542=item *
543
d2006265
FC
544Perl 5.10.0 introduced a similar bug: C<defined(*{"foo"})> where "foo"
545represents the name of a built-in global variable used to return false if
546the variable had never been used before, but only on the I<first> call.
547This, too, has been fixed.
548
549=item *
550
551Various functions that take a filehandle argument in rvalue context
552(C<close>, C<readline>, etc.) used to call C<FETCH> multiple times, if it
553was a tied variable, and warn twice, if it was C<undef> [perl #97482].
554
555=item *
556
557C<close> and similar filehandle functions, when called on built-in global
558variables (like C<$+>), used to die if the variable happened to hold the
559undefined value, instead of producing the usual "Use of uninitialized
560value" warning.
561
562=item *
563
564When autovivified file handles were introduced in Perl 5.6.0, C<readline>
565was inadvertently made to autovivify when called as C<readline($foo)> (but
566not as C<< <$foo> >>). It has now been fixed never to autovivify.
567
568=item *
569
570C<defined ${ $tied_variable }> used to call C<FETCH> multiple times, but
571now calls it just once.
572
573=item *
574
575Some cases of dereferencing a complex expression, such as
576C<${ (), $tied } = 1>, used to call C<FETCH> multiple times, but now call
577it once.
578
579=item *
580
581For a tied variable returning a package name, C<< $tied->method >> used to
582call C<FETCH> multiple times (even up to six!), and sometimes would
583fail to call the method, due to memory corruption.
584
585=item *
586
587Calling an undefined anonymous subroutine (e.g., what $x holds after
588C<undef &{$x = sub{}}>) used to cause a "Not a CODE reference" error, which
589has been corrected to "Undefined subroutine called" [perl #71154].
bbc28bfc 590
e1a80902
FC
591=item *
592
593Causing C<@DB::args> to be freed between uses of C<caller> no longer
594results in a crash [perl #93320].
595
fdd313f4
FC
596=item *
597
598Since 5.6.0, C<*{ ... }> has been inconsistent in how it treats undefined
599values. It would die in strict mode or lvalue context for most undefined
600values, but would be treated as the empty string (with a warning) for the
601specific scalar return by C<undef()> (C<&PL_sv_undef> internally). This
602has been corrected. C<undef()> is now treated like other undefined
603scalars, as in Perl 5.005.
604
01433346
FC
605=item *
606
607It used to be possible to free the typeglob of a localised array or hash
608(e.g., C<local @{"x"}; delete $::{x}>), resulting in a crash on scope exit.
609
88d69532
FC
610=item *
611
612C<setpgrp($foo)> used to be equivalent to C<($foo, setpgrp)>, because
613C<setpgrp> was ignoring its argument if there was just one. Now it is
614equivalent to C<setpgrp($foo,0)>.
615
33d4ef81
FC
616=item *
617
8d4393cf
FC
618Assignments like C<*$tied = \&{"..."}> and C<*glob = $tied> now call FETCH
619only once.
33d4ef81 620
93564729
FC
621=item *
622
623C<chdir>, C<chmod> and C<chown> now always call FETCH if passed a tied
624variable as the last argument. They used to ignore tiedness if the last
625thing return from or assigned to the variable was a typeglob or reference
626to a typeglob.
627
63ac71b9 628=back
bbc28bfc 629
63ac71b9 630=head1 Known Problems
bbc28bfc 631
63ac71b9
RS
632XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
633tests that had to be C<TODO>ed for the release would be noted here, unless
634they were specific to a particular platform (see below).
bbc28bfc 635
63ac71b9
RS
636This is a list of some significant unfixed bugs, which are regressions
637from either 5.XXX.XXX or 5.XXX.XXX.
bbc28bfc 638
63ac71b9 639[ List each fix as a =item entry ]
bbc28bfc 640
63ac71b9 641=over 4
bbc28bfc 642
bad4ae38
FC
643=item *
644
63ac71b9 645XXX
bad4ae38 646
63ac71b9 647=back
ab6ce8ea 648
63ac71b9 649=head1 Obituary
ab6ce8ea 650
63ac71b9
RS
651XXX If any significant core contributor has died, we've added a short obituary
652here.
c62f68e3 653
44691e6f
AB
654=head1 Acknowledgements
655
63ac71b9
RS
656XXX Generate this with:
657
658 perl Porting/acknowledgements.pl v5.15.2..HEAD
29cf780c 659
44691e6f
AB
660=head1 Reporting Bugs
661
662If you find what you think is a bug, you might check the articles
34dc2ec0 663recently posted to the comp.lang.perl.misc newsgroup and the perl
44691e6f
AB
664bug database at http://rt.perl.org/perlbug/ . There may also be
665information at http://www.perl.org/ , the Perl Home Page.
666
667If you believe you have an unreported bug, please run the L<perlbug>
668program included with your release. Be sure to trim your bug down
669to a tiny but sufficient test case. Your bug report, along with the
670output of C<perl -V>, will be sent off to perlbug@perl.org to be
671analysed by the Perl porting team.
672
673If the bug you are reporting has security implications, which make it
674inappropriate to send to a publicly archived mailing list, then please send
34dc2ec0 675it to perl5-security-report@perl.org. This points to a closed subscription
b4707b2a
FC
676unarchived mailing list, which includes
677all the core committers, who will be able
44691e6f
AB
678to help assess the impact of issues, figure out a resolution, and help
679co-ordinate the release of patches to mitigate or fix the problem across all
34dc2ec0
DM
680platforms on which Perl is supported. Please only use this address for
681security issues in the Perl core, not for modules independently
44691e6f
AB
682distributed on CPAN.
683
684=head1 SEE ALSO
685
686The F<Changes> file for an explanation of how to view exhaustive details
687on what changed.
688
689The F<INSTALL> file for how to build Perl.
690
691The F<README> file for general stuff.
692
693The F<Artistic> and F<Copying> files for copyright information.
694
695=cut