This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta 282fc0b3cc2439f69587d980b62bef7f5d5bdfef
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
25219f3f
KE
5[ this is a template for a new perldelta file. Any text flagged as XXX needs
6to be processed before release. ]
7
8perldelta - what is new for perl v5.27.7
89853d76 9
b5cbfe35 10=head1 DESCRIPTION
89853d76 11
25219f3f 12This document describes differences between the 5.27.6 release and the 5.27.7
b5cbfe35 13release.
89853d76 14
25219f3f
KE
15If you are upgrading from an earlier release such as 5.27.5, first read
16L<perl5276delta>, which describes differences between 5.27.5 and 5.27.6.
e6a2e5ca 17
25219f3f 18=head1 Notice
e6a2e5ca 19
25219f3f 20XXX Any important notices here
f99042c8 21
25219f3f 22=head1 Core Enhancements
f99042c8 23
25219f3f
KE
24XXX New core language features go here. Summarize user-visible core language
25enhancements. Particularly prominent performance optimisations could go
26here, but most should go in the L</Performance Enhancements> section.
2e8ea15a 27
25219f3f 28[ List each enhancement as a =head2 entry ]
2e8ea15a 29
eaee9cdd
KW
30=head2 The C<sprintf> C<%j> format size modifier is now available with
31pre-C99 compilers
32
33The actual size used depends on the platform, so remains unportable.
34
25219f3f 35=head1 Security
e6a2e5ca 36
25219f3f
KE
37XXX Any security-related notices go here. In particular, any security
38vulnerabilities closed should be noted here rather than in the
39L</Selected Bug Fixes> section.
29d69c3c 40
25219f3f 41[ List each security issue as a =head2 entry ]
29d69c3c 42
25219f3f 43=head1 Incompatible Changes
29d69c3c 44
25219f3f 45XXX For a release on a stable branch, this section aspires to be:
29d69c3c 46
25219f3f
KE
47 There are no changes intentionally incompatible with 5.XXX.XXX
48 If any exist, they are bugs, and we request that you submit a
49 report. See L</Reporting Bugs> below.
7d65f652 50
25219f3f 51[ List each incompatible change as a =head2 entry ]
7d65f652 52
15397007
Z
53=head2 Over-radix digits in floating point literals
54
55Octal and binary floating point literals used to permit any hexadecimal
56digit to appear after the radix point. The digits are now restricted
57to those appropriate for the radix, as digits before the radix point
58always were.
59
25219f3f 60=head1 Deprecations
7d65f652 61
25219f3f 62XXX Any deprecated features, syntax, modules etc. should be listed here.
7d65f652 63
8e796115
DIM
64=head2 Assignment to C<$[> will be fatal in Perl 5.30
65
66Assigning a non-zero value to L<C<$[>|perlvar/$[> has been deprecated
67since Perl 5.12, but was never given a deadline for removal. This has
68now been scheduled for Perl 5.30.
69
cab9f0b0
Z
70=head2 hostname() won't accept arguments in Perl 5.32
71
72Passing arguments to C<Sys::Hostname::hostname()> was already deprecated,
73but didn't have a removal date. This has now been scheduled for Perl
745.32. [perl #124349]
75
25219f3f 76=head2 Module removals
4c46c124 77
25219f3f 78XXX Remove this section if not applicable.
7d65f652 79
25219f3f
KE
80The following modules will be removed from the core distribution in a
81future release, and will at that time need to be installed from CPAN.
82Distributions on CPAN which require these modules will need to list them as
83prerequisites.
e2091bb6 84
25219f3f
KE
85The core versions of these modules will now issue C<"deprecated">-category
86warnings to alert you to this fact. To silence these deprecation warnings,
87install the modules in question from CPAN.
a8ba758d 88
25219f3f
KE
89Note that these are (with rare exceptions) fine modules that you are encouraged
90to continue to use. Their disinclusion from core primarily hinges on their
91necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
92not usually on concerns over their design.
cf663f87 93
25219f3f 94=over
1b510166 95
183fb71f 96=item L<Locale::Codes> and its associated Country, Currency and Language modules
1b510166 97
25219f3f
KE
98XXX Note that deprecated modules should be listed here even if they are listed
99as an updated module in the L</Modules and Pragmata> section.
8ed1839e 100
25219f3f 101=back
8ed1839e 102
25219f3f 103[ List each other deprecation as a =head2 entry ]
8ed1839e 104
25219f3f 105=head1 Performance Enhancements
8ed1839e 106
25219f3f
KE
107XXX Changes which enhance performance without changing behaviour go here.
108There may well be none in a stable release.
8ed1839e 109
25219f3f 110[ List each enhancement as an =item entry ]
8ed1839e 111
25219f3f 112=over 4
d912eab8 113
7d65f652
FC
114=item *
115
25219f3f 116XXX
7d65f652 117
c83a3d01 118=back
d912eab8 119
c83a3d01 120=head1 Modules and Pragmata
af94b3ac 121
25219f3f
KE
122XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
123go here. If Module::CoreList is updated, generate an initial draft of the
124following sections using F<Porting/corelist-perldelta.pl>. A paragraph summary
125for important changes should then be added by hand. In an ideal world,
126dual-life modules would have a F<Changes> file that could be cribbed.
9b78f210 127
25219f3f
KE
128The list of new and updated modules is modified automatically as part of
129preparing a Perl release, so the only reason to manually add entries here is if
130you're summarising the important changes in the module update. (Also, if the
131manually-added details don't match the automatically-generated ones, the
132release manager will have to investigate the situation carefully.)
9b78f210 133
25219f3f 134[ Within each section, list entries as an =item entry ]
1218f5ba 135
25219f3f 136=head2 New Modules and Pragmata
e6a2e5ca
SH
137
138=over 4
64b9a139
SH
139
140=item *
141
25219f3f 142XXX Remove this section if not applicable.
b2a6778b 143
25219f3f 144=back
b2a6778b 145
25219f3f 146=head2 Updated Modules and Pragmata
b2a6778b 147
25219f3f 148=over 4
b2a6778b
KE
149
150=item *
151
183fb71f 152L<Locale::Codes> has been upgraded from version 3.54 to 3.55
b2a6778b 153
183fb71f
SB
154B<NOTE>: L<Locale::Codes> is deprecated in core and will be removed
155from Perl 5.30.
b2a6778b 156
95609a20
Z
157=item *
158
364b8cf9
Z
159L<threads> has been upgraded from version 2.19 to 2.20.
160The documentation now better describes the problems that arise when
161returning values from threads, and no longer warns about creating threads
162in C<BEGIN> blocks. [perl #96538]
163
164=item *
165
07d61e7e 166L<Data::Dumper> has been upgraded from version 2.167_02 to 2.169.
95609a20 167Quoting of glob names now obeys the Useqq option [perl #119831].
07d61e7e
Z
168Attempts to set an option to C<undef> through a combined getter/setter
169method are no longer mistaken for getter calls [perl #113090].
95609a20 170
c3fac04c
Z
171=item *
172
173L<Pod::Html> has been upgraded from version 1.2203 to 1.23.
174A title for the HTML document will now be automatically generated by
175default from a "NAME" section in the POD document, as it used to be
176before the module was rewritten to use L<Pod::Simple::XHTML> to do the
177core of its job. [perl #110520]
178
25219f3f 179=back
b2a6778b 180
25219f3f 181=head2 Removed Modules and Pragmata
b2a6778b 182
25219f3f 183=over 4
b2a6778b
KE
184
185=item *
186
25219f3f 187XXX
ad3f654c 188
25219f3f 189=back
7358a033 190
25219f3f 191=head1 Documentation
64b9a139 192
25219f3f
KE
193XXX Changes to files in F<pod/> go here. Consider grouping entries by
194file and be sure to link to the appropriate page, e.g. L<perlfunc>.
e6a2e5ca 195
25219f3f 196=head2 New Documentation
b2a6778b 197
25219f3f 198XXX Changes which create B<new> files in F<pod/> go here.
b2a6778b 199
25219f3f 200=head3 L<XXX>
b2a6778b 201
25219f3f 202XXX Description of the purpose of the new file here
b2a6778b 203
25219f3f 204=head2 Changes to Existing Documentation
b2a6778b 205
25219f3f
KE
206We have attempted to update the documentation to reflect the changes
207listed in this document. If you find any we have missed, send email
208to L<perlbug@perl.org|mailto:perlbug@perl.org>.
b2a6778b 209
25219f3f
KE
210XXX Changes which significantly change existing files in F<pod/> go here.
211However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
212section.
b2a6778b 213
25219f3f 214Additionally, the following selected changes have been made:
b2a6778b 215
497a8271
Z
216=head3 L<perlapi>
217
4dab62e3
Z
218The API functions C<perl_parse()>, C<perl_run()>, and C<perl_destruct()>
219are now documented comprehensively, where previously the only
220documentation was a reference to the L<perlembed> tutorial.
221
497a8271
Z
222The documentation of C<newGIVENOP()> has been belatedly updated to
223account for the removal of lexical C<$_>.
224
01d02537
Z
225The API functions C<newCONSTSUB()> and C<newCONSTSUB_flags()> are
226documented much more comprehensively than before.
227
40a66856
Z
228=head3 L<perlop>
229
b782ddf4
Z
230The general explanation of operator precedence and associativity has
231been corrected and clarified. [perl #127391]
232
40a66856
Z
233The documentation for the C<\> referencing operator now explains the
234unusual context that it supplies to its operand. [perl #131061]
235
b32ad89c
Z
236=head3 L<perlsyn>
237
238The means to disambiguate between code blocks and hash constructors,
239already documented in L<perlref>, are now documented in L<perlsyn> too.
240[perl #130958]
241
f6c3d597
Z
242=head3 L<perlfunc>
243
a8b6459c
Z
244There is now a note that warnings generated by built-in functions are
245documented in L<perldiag> and L<warnings>. [perl #116080]
246
f6c3d597
Z
247The documentation for the C<exists> operator no longer says that
248autovivification behaviour "may be fixed in a future release".
249We've determined that we're not going to change the default behaviour.
250[perl #127712]
251
b6108eb9
Z
252A couple of small details in the documentation for the C<bless> operator
253have been clarified. [perl #124428]
254
e6b4f2eb
Z
255The description of C<@INC> hooks in the documentation for C<require>
256has been corrected to say that filter subroutines receive a useless
257first argument. [perl #115754]
258
d2f4250c
Z
259The documentation of C<use> now explains what syntactically qualifies
260as a version number for its module version checking feature.
261
56e48c10
KW
262=head3 L<perluniprops>
263
264For each binary table or property, the documentation now includes which
265characters in the range C<\x00-\xFF> it matches, as well as a list of
266the first few ranges of code points matched above that.
b2a6778b 267
415e5995
Z
268=head3 L<perlobj>
269
270The documentation about C<DESTROY> methods has been corrected, updated,
271and revised, especially in regard to how they interact with exceptions.
272[perl #122753]
273
9deb4e0b
Z
274=head3 L<perlsec>
275
276The documentation about set-id scripts has been updated and revised.
277[perl #74142]
278
279A section about using C<sudo> to run Perl scripts has been added.
280
4dab62e3
Z
281=head3 L<perlembed>
282
283The examples in L<perlembed> have been made more portable in the way
284they exit, and the example that gets an exit code from the embedded Perl
285interpreter now gets it from the right place. The examples that pass
286a constructed argv to Perl now show the mandatory null C<argv[argc]>.
287
86e03141
Z
288=head3 L<perldebguts>
289
290The description of the conditions under which C<DB::sub()> will be called
291has been clarified. [perl #131672]
292
01d02537
Z
293=head3 L<perlintern>
294
295The internal functions C<newXS_len_flags()> and C<newATTRSUB_x()> are
296now documented.
297
4914bebe
Z
298=head3 L<perlgit>
299
300The precise rules for identifying C<smoke-me> branches are now stated.
301
25219f3f 302=over 4
b2a6778b
KE
303
304=item *
305
25219f3f 306XXX Description of the change here
b2a6778b 307
25219f3f 308=back
b2a6778b 309
25219f3f 310=head1 Diagnostics
b2a6778b 311
25219f3f
KE
312The following additions or changes have been made to diagnostic output,
313including warnings and fatal error messages. For the complete list of
314diagnostic messages, see L<perldiag>.
b2a6778b 315
25219f3f
KE
316XXX New or changed warnings emitted by the core's C<C> code go here. Also
317include any changes in L<perldiag> that reconcile it to the C<C> code.
b2a6778b 318
25219f3f 319=head2 New Diagnostics
b2a6778b 320
25219f3f
KE
321XXX Newly added diagnostic messages go under here, separated into New Errors
322and New Warnings
b2a6778b 323
25219f3f 324=head3 New Errors
b2a6778b 325
25219f3f 326=over 4
b2a6778b
KE
327
328=item *
329
a01f4640
FC
330L<Can't "goto" into a "given" block|perldiag/"Can't E<quot>gotoE<quot> into a E<quot>givenE<quot> block">
331
332(F) A "goto" statement was executed to jump into the middle of a C<given>
333block. You can't get there from here. See L<perlfunc/goto>.
b2a6778b 334
25219f3f 335=back
b2a6778b 336
25219f3f 337=head3 New Warnings
b2a6778b 338
25219f3f 339=over 4
64b9a139
SH
340
341=item *
342
0b4678bf
FC
343L<Old package separator used in string|perldiag/"Old package separator used in string">
344
345(W syntax) You used the old package separator, "'", in a variable
346named inside a double-quoted string; e.g., C<"In $name's house">. This
347is equivalent to C<"In $name::s house">. If you meant the former, put
348a backslash before the apostrophe (C<"In $name\'s house">).
64b9a139 349
e6a2e5ca 350=back
64b9a139 351
25219f3f 352=head2 Changes to Existing Diagnostics
64b9a139 353
25219f3f 354XXX Changes (i.e. rewording) of diagnostic messages go here
e6a2e5ca 355
04f89ea7
Z
356=over 4
357
64b9a139
SH
358=item *
359
25219f3f 360XXX Describe change here
2b8b74b0 361
52e3acf8
Z
362=item *
363
9fca523d
Z
364The warning about useless use of a concatenation operator in void context
365is now generated for expressions with multiple concatenations, such as
366C<$a.$b.$c>, which used to mistakenly not warn. [perl #6997]
367
368=item *
369
52e3acf8
Z
370Warnings that a variable or subroutine "masks earlier declaration in same
371...", or that an C<our> variable has been redeclared, have been moved to a
372new warnings category "shadow". Previously they were in category "misc".
373
cab9f0b0
Z
374=item *
375
376The deprecation warning from C<Sys::Hostname::hostname()> saying that
377it doesn't accept arguments now states the Perl version in which the
378warning will be upgraded to an error. [perl #124349]
379
9deb4e0b
Z
380=item *
381
382The L<perldiag> entry for the error regarding a set-id script has been
383expanded to make clear that the error is reporting a specific security
384vulnerability, and to advise how to fix it.
385
25219f3f 386=back
e509fc38 387
25219f3f 388=head1 Utility Changes
e509fc38 389
25219f3f
KE
390XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
391Most of these are built within the directory F<utils>.
64b9a139 392
25219f3f
KE
393[ List utility changes as a =head2 entry for each utility and =item
394entries for each change
395Use L<XXX> with program names to get proper documentation linking. ]
64b9a139 396
25219f3f 397=head2 L<XXX>
64b9a139 398
25219f3f 399=over 4
64b9a139
SH
400
401=item *
402
25219f3f 403XXX
64b9a139 404
e6a2e5ca
SH
405=back
406
25219f3f 407=head1 Configuration and Compilation
64b9a139 408
25219f3f
KE
409XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
410go here. Any other changes to the Perl build process should be listed here.
411However, any platform-specific changes should be listed in the
412L</Platform Support> section, instead.
e6a2e5ca 413
25219f3f 414[ List changes as an =item entry ].
64b9a139 415
e6a2e5ca 416=over 4
64b9a139
SH
417
418=item *
419
25219f3f 420XXX
f99042c8 421
a8d9a219
Z
422=item *
423
424Where an HTML version of the doucmentation is installed, the HTML
425documents now use relative links to refer to each other. Links from
426the index page of L<perlipc> to the individual section documents are
427now correct. [perl #110056]
428
e6a2e5ca
SH
429=back
430
25219f3f 431=head1 Testing
e6a2e5ca 432
25219f3f
KE
433XXX Any significant changes to the testing of a freshly built perl should be
434listed here. Changes which create B<new> files in F<t/> go here as do any
435large changes to the testing harness (e.g. when parallel testing was added).
436Changes to existing files in F<t/> aren't worth summarizing, although the bugs
437that they represent may be covered elsewhere.
e6a2e5ca 438
25219f3f 439XXX If there were no significant test changes, say this:
64b9a139 440
25219f3f
KE
441Tests were added and changed to reflect the other additions and changes
442in this release.
64b9a139 443
25219f3f 444XXX If instead there were significant changes, say this:
e6a2e5ca 445
25219f3f
KE
446Tests were added and changed to reflect the other additions and
447changes in this release. Furthermore, these significant changes were
448made:
e6a2e5ca 449
25219f3f 450[ List each test improvement as an =item entry ]
e6a2e5ca 451
e6a2e5ca 452=over 4
64b9a139 453
25219f3f 454=item *
dea26044 455
25219f3f 456XXX
dea26044 457
25219f3f 458=back
dea26044 459
25219f3f 460=head1 Platform Support
dea26044 461
25219f3f 462XXX Any changes to platform support should be listed in the sections below.
dea26044 463
25219f3f
KE
464[ Within the sections, list each platform as an =item entry with specific
465changes as paragraphs below it. ]
dea26044 466
25219f3f 467=head2 New Platforms
dea26044 468
25219f3f
KE
469XXX List any platforms that this version of perl compiles on, that previous
470versions did not. These will either be enabled by new files in the F<hints/>
471directories, or new subdirectories and F<README> files at the top level of the
472source tree.
dea26044 473
25219f3f 474=over 4
dea26044 475
25219f3f 476=item XXX-some-platform
dea26044 477
25219f3f 478XXX
dea26044
MB
479
480=back
e6a2e5ca 481
e6a2e5ca
SH
482=head2 Discontinued Platforms
483
25219f3f
KE
484XXX List any platforms that this version of perl no longer compiles on.
485
e6a2e5ca
SH
486=over 4
487
25219f3f 488=item XXX-some-platform
e6a2e5ca 489
25219f3f 490XXX
e6a2e5ca
SH
491
492=back
493
a8ba758d
JSA
494=head2 Platform-Specific Notes
495
25219f3f
KE
496XXX List any changes for specific platforms. This could include configuration
497and compilation changes or changes in portability/compatibility. However,
498changes within modules for platforms should generally be listed in the
499L</Modules and Pragmata> section.
500
a8ba758d 501=over 4
9ef07b78 502
04139aa0 503=item Windows
a8ba758d 504
04139aa0
SH
505We now set C<$Config{libpth}> correctly for 64-bit builds using Visual C++
506versions earlier than 14.1.
a8ba758d
JSA
507
508=back
509
e6a2e5ca
SH
510=head1 Internal Changes
511
25219f3f
KE
512XXX Changes which affect the interface available to C<XS> code go here. Other
513significant internal changes for future core maintainers should be noted as
514well.
8ed1839e 515
25219f3f 516=over 4
a8ba758d 517
ee5287f6
LM
518=item *
519
59eb8be1
KW
520XS modules can now automatically get reentrant versions of system
521functions on threaded perls.
522
523By saying
524
525 #define PERL_REENTRANT
526
527near the beginning of an C<XS> file, it will be compiled so that
528whatever reentrant functions perl knows about on that system will
529automatically and invisibly be used instead of the plain, non-reentrant
530versions. For example, if you write C<getpwnam()> in your code, on a
531system that has C<pwnam_r()> all calls to the former will be translated
532invisibly into the latter. This does not happen except on threaded
533perls, as they aren't needed otherwise. Be aware that which functions
534have reentrant versions varies from system to system.
ee5287f6 535
e6a2e5ca
SH
536=back
537
538=head1 Selected Bug Fixes
539
25219f3f
KE
540XXX Important bug fixes in the core language are summarized here. Bug fixes in
541files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
a155eb05 542
25219f3f 543[ List each fix as an =item entry ]
c2bb91f9 544
25219f3f 545=over 4
e6a2e5ca 546
4faa3060
TC
547=item *
548
25219f3f 549XXX
4faa3060 550
64072da0
Z
551=item *
552
66d3c925
Z
553Digits past the radix point in octal and binary floating point literals
554now have the correct weight on platforms where a floating point
555significand doesn't fit into an integer type.
556
557=item *
558
4dab62e3
Z
559C<exit(0)> in a C<UNITCHECK> or C<CHECK> block no longer permits the
560main program to run, and C<exit(0)> in a C<BEGIN> block no longer permits
561C<INIT> blocks to run before exiting. [perl #2754]
562
563=item *
564
1b16b015
Z
565The canonical truth value no longer has a spurious special meaning as
566a callable. It used to be a magic placeholder for a missing C<import>
567or C<unimport> method. It is now treated like any other string C<1>.
568[perl #126042]
569
570=item *
571
9a40fcb6
Z
572The C<readpipe()> built-in function now checks at compile time that
573it has only one parameter expression, and puts it in scalar context,
574thus ensuring that it doesn't corrupt the stack at runtime. [perl #4574]
575
576=item *
577
d679c20f
Z
578C<sort> now performs correct reference counting when aliasing C<$a> and
579C<$b>, thus avoiding premature destruction and leakage of scalars if they
580are re-aliased during execution of the sort comparator. [perl #92264]
581
582=item *
583
30f9405e
Z
584C<reverse> with no operand, reversing C<$_> by default, is no longer in
585danger of corrupting the stack. [perl #132544]
586
587=item *
588
222b5ca9
Z
589C<exec>, C<system>, et al are no longer liable to have their argument
590lists corrupted by reentrant calls and by magic such as tied scalars.
591[perl #129888]
592
593=item *
594
64072da0 595Perl's own C<malloc> no longer gets confused by attempts to allocate
7b9d2ba3 596more than a gigabyte on a 64-bit platform. [perl #119829]
64072da0 597
244d2682
FC
598=item *
599
8af6a5dc
Z
600Stacked file test operators in a sort comparator expression no longer
601cause a crash. [perl #129347]
602
603=item *
604
998753fe
Z
605An identity C<tr///> transformation on a reference is no longer mistaken
606for that reference for the purposes of deciding whether it can be
607assigned to. [perl #130578]
608
609=item *
610
53fff747
Z
611Lengthy hexadecimal, octal, or binary floating point literals no
612longer cause undefined behaviour when parsing digits that are of such
613low significance that they can't affect the floating point value.
614[perl #131894]
615
616=item *
617
244d2682
FC
618C<open $$scalarref...> and similar invocations no longer leak the file
619handle. [perl #115814]
620
621=item *
622
8f46363a
Z
623Some convoluted kinds of regexp no longer cause an arithmetic overflow
624when compiled. [perl #131893]
625
626=item *
627
244d2682
FC
628The default typemap, by avoiding C<newGVgen>, now no longer leaks when
629XSUBs return file handles (C<PerlIO *> or C<FILE *>). [perl #115814]
630
aa0c5741
Z
631=item *
632
633Creating a C<BEGIN> block as an XS subroutine with a prototype no longer
634crashes because of the early freeing of the subroutine.
635
25219f3f 636=back
4faa3060 637
25219f3f 638=head1 Known Problems
4faa3060 639
25219f3f
KE
640XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
641tests that had to be C<TODO>ed for the release would be noted here. Unfixed
642platform specific bugs also go here.
d1ac83c4 643
25219f3f 644[ List each fix as an =item entry ]
d1ac83c4 645
25219f3f 646=over 4
c4f4b223
Z
647
648=item *
649
25219f3f 650XXX
02d43d4f 651
e6a2e5ca
SH
652=back
653
e6a2e5ca
SH
654=head1 Errata From Previous Releases
655
656=over 4
8abafd33 657
e6a2e5ca
SH
658=item *
659
25219f3f
KE
660XXX Add anything here that we forgot to add, or were mistaken about, in
661the perldelta of a previous release.
8abafd33 662
e6a2e5ca 663=back
b2e49ab9 664
25219f3f 665=head1 Obituary
060724e5 666
25219f3f
KE
667XXX If any significant core contributor or member of the CPAN community has
668died, add a short obituary here.
060724e5 669
25219f3f 670=head1 Acknowledgements
060724e5 671
25219f3f 672XXX Generate this with:
060724e5 673
25219f3f 674 perl Porting/acknowledgements.pl v5.27.6..HEAD
f5b73711 675
44691e6f
AB
676=head1 Reporting Bugs
677
b5cbfe35
S
678If you find what you think is a bug, you might check the perl bug database
679at L<https://rt.perl.org/> . There may also be information at
680L<http://www.perl.org/> , the Perl Home Page.
44691e6f 681
e08634c5
SH
682If you believe you have an unreported bug, please run the L<perlbug> program
683included with your release. Be sure to trim your bug down to a tiny but
684sufficient test case. Your bug report, along with the output of C<perl -V>,
b5cbfe35 685will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f 686
87c118b9
DM
687If the bug you are reporting has security implications which make it
688inappropriate to send to a publicly archived mailing list, then see
c0ea3294
SH
689L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
690for details of how to report the issue.
44691e6f 691
390ae6f9
S
692=head1 Give Thanks
693
694If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
695you can do so by running the C<perlthanks> program:
696
697 perlthanks
698
699This will send an email to the Perl 5 Porters list with your show of thanks.
700
44691e6f
AB
701=head1 SEE ALSO
702
e08634c5
SH
703The F<Changes> file for an explanation of how to view exhaustive details on
704what changed.
44691e6f
AB
705
706The F<INSTALL> file for how to build Perl.
707
708The F<README> file for general stuff.
709
710The F<Artistic> and F<Copying> files for copyright information.
711
712=cut