This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
rewrite "ref" documentation for clarity
[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
f3c710fe
Z
259The documentation of C<ref> has been rewritten for clarity.
260
d2f4250c
Z
261The documentation of C<use> now explains what syntactically qualifies
262as a version number for its module version checking feature.
263
56e48c10
KW
264=head3 L<perluniprops>
265
266For each binary table or property, the documentation now includes which
267characters in the range C<\x00-\xFF> it matches, as well as a list of
268the first few ranges of code points matched above that.
b2a6778b 269
415e5995
Z
270=head3 L<perlobj>
271
272The documentation about C<DESTROY> methods has been corrected, updated,
273and revised, especially in regard to how they interact with exceptions.
274[perl #122753]
275
9deb4e0b
Z
276=head3 L<perlsec>
277
278The documentation about set-id scripts has been updated and revised.
279[perl #74142]
280
281A section about using C<sudo> to run Perl scripts has been added.
282
4dab62e3
Z
283=head3 L<perlembed>
284
285The examples in L<perlembed> have been made more portable in the way
286they exit, and the example that gets an exit code from the embedded Perl
287interpreter now gets it from the right place. The examples that pass
288a constructed argv to Perl now show the mandatory null C<argv[argc]>.
289
86e03141
Z
290=head3 L<perldebguts>
291
292The description of the conditions under which C<DB::sub()> will be called
293has been clarified. [perl #131672]
294
01d02537
Z
295=head3 L<perlintern>
296
297The internal functions C<newXS_len_flags()> and C<newATTRSUB_x()> are
298now documented.
299
4914bebe
Z
300=head3 L<perlgit>
301
302The precise rules for identifying C<smoke-me> branches are now stated.
303
25219f3f 304=over 4
b2a6778b
KE
305
306=item *
307
25219f3f 308XXX Description of the change here
b2a6778b 309
25219f3f 310=back
b2a6778b 311
25219f3f 312=head1 Diagnostics
b2a6778b 313
25219f3f
KE
314The following additions or changes have been made to diagnostic output,
315including warnings and fatal error messages. For the complete list of
316diagnostic messages, see L<perldiag>.
b2a6778b 317
25219f3f
KE
318XXX New or changed warnings emitted by the core's C<C> code go here. Also
319include any changes in L<perldiag> that reconcile it to the C<C> code.
b2a6778b 320
25219f3f 321=head2 New Diagnostics
b2a6778b 322
25219f3f
KE
323XXX Newly added diagnostic messages go under here, separated into New Errors
324and New Warnings
b2a6778b 325
25219f3f 326=head3 New Errors
b2a6778b 327
25219f3f 328=over 4
b2a6778b
KE
329
330=item *
331
a01f4640
FC
332L<Can't "goto" into a "given" block|perldiag/"Can't E<quot>gotoE<quot> into a E<quot>givenE<quot> block">
333
334(F) A "goto" statement was executed to jump into the middle of a C<given>
335block. You can't get there from here. See L<perlfunc/goto>.
b2a6778b 336
25219f3f 337=back
b2a6778b 338
25219f3f 339=head3 New Warnings
b2a6778b 340
25219f3f 341=over 4
64b9a139
SH
342
343=item *
344
0b4678bf
FC
345L<Old package separator used in string|perldiag/"Old package separator used in string">
346
347(W syntax) You used the old package separator, "'", in a variable
348named inside a double-quoted string; e.g., C<"In $name's house">. This
349is equivalent to C<"In $name::s house">. If you meant the former, put
350a backslash before the apostrophe (C<"In $name\'s house">).
64b9a139 351
e6a2e5ca 352=back
64b9a139 353
25219f3f 354=head2 Changes to Existing Diagnostics
64b9a139 355
25219f3f 356XXX Changes (i.e. rewording) of diagnostic messages go here
e6a2e5ca 357
04f89ea7
Z
358=over 4
359
64b9a139
SH
360=item *
361
25219f3f 362XXX Describe change here
2b8b74b0 363
52e3acf8
Z
364=item *
365
9fca523d
Z
366The warning about useless use of a concatenation operator in void context
367is now generated for expressions with multiple concatenations, such as
368C<$a.$b.$c>, which used to mistakenly not warn. [perl #6997]
369
370=item *
371
52e3acf8
Z
372Warnings that a variable or subroutine "masks earlier declaration in same
373...", or that an C<our> variable has been redeclared, have been moved to a
374new warnings category "shadow". Previously they were in category "misc".
375
cab9f0b0
Z
376=item *
377
378The deprecation warning from C<Sys::Hostname::hostname()> saying that
379it doesn't accept arguments now states the Perl version in which the
380warning will be upgraded to an error. [perl #124349]
381
9deb4e0b
Z
382=item *
383
384The L<perldiag> entry for the error regarding a set-id script has been
385expanded to make clear that the error is reporting a specific security
386vulnerability, and to advise how to fix it.
387
25219f3f 388=back
e509fc38 389
25219f3f 390=head1 Utility Changes
e509fc38 391
25219f3f
KE
392XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
393Most of these are built within the directory F<utils>.
64b9a139 394
25219f3f
KE
395[ List utility changes as a =head2 entry for each utility and =item
396entries for each change
397Use L<XXX> with program names to get proper documentation linking. ]
64b9a139 398
25219f3f 399=head2 L<XXX>
64b9a139 400
25219f3f 401=over 4
64b9a139
SH
402
403=item *
404
25219f3f 405XXX
64b9a139 406
e6a2e5ca
SH
407=back
408
25219f3f 409=head1 Configuration and Compilation
64b9a139 410
25219f3f
KE
411XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
412go here. Any other changes to the Perl build process should be listed here.
413However, any platform-specific changes should be listed in the
414L</Platform Support> section, instead.
e6a2e5ca 415
25219f3f 416[ List changes as an =item entry ].
64b9a139 417
e6a2e5ca 418=over 4
64b9a139
SH
419
420=item *
421
25219f3f 422XXX
f99042c8 423
a8d9a219
Z
424=item *
425
426Where an HTML version of the doucmentation is installed, the HTML
427documents now use relative links to refer to each other. Links from
428the index page of L<perlipc> to the individual section documents are
429now correct. [perl #110056]
430
e6a2e5ca
SH
431=back
432
25219f3f 433=head1 Testing
e6a2e5ca 434
25219f3f
KE
435XXX Any significant changes to the testing of a freshly built perl should be
436listed here. Changes which create B<new> files in F<t/> go here as do any
437large changes to the testing harness (e.g. when parallel testing was added).
438Changes to existing files in F<t/> aren't worth summarizing, although the bugs
439that they represent may be covered elsewhere.
e6a2e5ca 440
25219f3f 441XXX If there were no significant test changes, say this:
64b9a139 442
25219f3f
KE
443Tests were added and changed to reflect the other additions and changes
444in this release.
64b9a139 445
25219f3f 446XXX If instead there were significant changes, say this:
e6a2e5ca 447
25219f3f
KE
448Tests were added and changed to reflect the other additions and
449changes in this release. Furthermore, these significant changes were
450made:
e6a2e5ca 451
25219f3f 452[ List each test improvement as an =item entry ]
e6a2e5ca 453
e6a2e5ca 454=over 4
64b9a139 455
25219f3f 456=item *
dea26044 457
25219f3f 458XXX
dea26044 459
25219f3f 460=back
dea26044 461
25219f3f 462=head1 Platform Support
dea26044 463
25219f3f 464XXX Any changes to platform support should be listed in the sections below.
dea26044 465
25219f3f
KE
466[ Within the sections, list each platform as an =item entry with specific
467changes as paragraphs below it. ]
dea26044 468
25219f3f 469=head2 New Platforms
dea26044 470
25219f3f
KE
471XXX List any platforms that this version of perl compiles on, that previous
472versions did not. These will either be enabled by new files in the F<hints/>
473directories, or new subdirectories and F<README> files at the top level of the
474source tree.
dea26044 475
25219f3f 476=over 4
dea26044 477
25219f3f 478=item XXX-some-platform
dea26044 479
25219f3f 480XXX
dea26044
MB
481
482=back
e6a2e5ca 483
e6a2e5ca
SH
484=head2 Discontinued Platforms
485
25219f3f
KE
486XXX List any platforms that this version of perl no longer compiles on.
487
e6a2e5ca
SH
488=over 4
489
25219f3f 490=item XXX-some-platform
e6a2e5ca 491
25219f3f 492XXX
e6a2e5ca
SH
493
494=back
495
a8ba758d
JSA
496=head2 Platform-Specific Notes
497
25219f3f
KE
498XXX List any changes for specific platforms. This could include configuration
499and compilation changes or changes in portability/compatibility. However,
500changes within modules for platforms should generally be listed in the
501L</Modules and Pragmata> section.
502
a8ba758d 503=over 4
9ef07b78 504
04139aa0 505=item Windows
a8ba758d 506
04139aa0
SH
507We now set C<$Config{libpth}> correctly for 64-bit builds using Visual C++
508versions earlier than 14.1.
a8ba758d
JSA
509
510=back
511
e6a2e5ca
SH
512=head1 Internal Changes
513
25219f3f
KE
514XXX Changes which affect the interface available to C<XS> code go here. Other
515significant internal changes for future core maintainers should be noted as
516well.
8ed1839e 517
25219f3f 518=over 4
a8ba758d 519
ee5287f6
LM
520=item *
521
59eb8be1
KW
522XS modules can now automatically get reentrant versions of system
523functions on threaded perls.
524
525By saying
526
527 #define PERL_REENTRANT
528
529near the beginning of an C<XS> file, it will be compiled so that
530whatever reentrant functions perl knows about on that system will
531automatically and invisibly be used instead of the plain, non-reentrant
532versions. For example, if you write C<getpwnam()> in your code, on a
533system that has C<pwnam_r()> all calls to the former will be translated
534invisibly into the latter. This does not happen except on threaded
535perls, as they aren't needed otherwise. Be aware that which functions
536have reentrant versions varies from system to system.
ee5287f6 537
e6a2e5ca
SH
538=back
539
540=head1 Selected Bug Fixes
541
25219f3f
KE
542XXX Important bug fixes in the core language are summarized here. Bug fixes in
543files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
a155eb05 544
25219f3f 545[ List each fix as an =item entry ]
c2bb91f9 546
25219f3f 547=over 4
e6a2e5ca 548
4faa3060
TC
549=item *
550
25219f3f 551XXX
4faa3060 552
64072da0
Z
553=item *
554
66d3c925
Z
555Digits past the radix point in octal and binary floating point literals
556now have the correct weight on platforms where a floating point
557significand doesn't fit into an integer type.
558
559=item *
560
4dab62e3
Z
561C<exit(0)> in a C<UNITCHECK> or C<CHECK> block no longer permits the
562main program to run, and C<exit(0)> in a C<BEGIN> block no longer permits
563C<INIT> blocks to run before exiting. [perl #2754]
564
565=item *
566
1b16b015
Z
567The canonical truth value no longer has a spurious special meaning as
568a callable. It used to be a magic placeholder for a missing C<import>
569or C<unimport> method. It is now treated like any other string C<1>.
570[perl #126042]
571
572=item *
573
9a40fcb6
Z
574The C<readpipe()> built-in function now checks at compile time that
575it has only one parameter expression, and puts it in scalar context,
576thus ensuring that it doesn't corrupt the stack at runtime. [perl #4574]
577
578=item *
579
d679c20f
Z
580C<sort> now performs correct reference counting when aliasing C<$a> and
581C<$b>, thus avoiding premature destruction and leakage of scalars if they
582are re-aliased during execution of the sort comparator. [perl #92264]
583
584=item *
585
30f9405e
Z
586C<reverse> with no operand, reversing C<$_> by default, is no longer in
587danger of corrupting the stack. [perl #132544]
588
589=item *
590
222b5ca9
Z
591C<exec>, C<system>, et al are no longer liable to have their argument
592lists corrupted by reentrant calls and by magic such as tied scalars.
593[perl #129888]
594
595=item *
596
64072da0 597Perl's own C<malloc> no longer gets confused by attempts to allocate
7b9d2ba3 598more than a gigabyte on a 64-bit platform. [perl #119829]
64072da0 599
244d2682
FC
600=item *
601
8af6a5dc
Z
602Stacked file test operators in a sort comparator expression no longer
603cause a crash. [perl #129347]
604
605=item *
606
998753fe
Z
607An identity C<tr///> transformation on a reference is no longer mistaken
608for that reference for the purposes of deciding whether it can be
609assigned to. [perl #130578]
610
611=item *
612
53fff747
Z
613Lengthy hexadecimal, octal, or binary floating point literals no
614longer cause undefined behaviour when parsing digits that are of such
615low significance that they can't affect the floating point value.
616[perl #131894]
617
618=item *
619
244d2682
FC
620C<open $$scalarref...> and similar invocations no longer leak the file
621handle. [perl #115814]
622
623=item *
624
8f46363a
Z
625Some convoluted kinds of regexp no longer cause an arithmetic overflow
626when compiled. [perl #131893]
627
628=item *
629
244d2682
FC
630The default typemap, by avoiding C<newGVgen>, now no longer leaks when
631XSUBs return file handles (C<PerlIO *> or C<FILE *>). [perl #115814]
632
aa0c5741
Z
633=item *
634
635Creating a C<BEGIN> block as an XS subroutine with a prototype no longer
636crashes because of the early freeing of the subroutine.
637
25219f3f 638=back
4faa3060 639
25219f3f 640=head1 Known Problems
4faa3060 641
25219f3f
KE
642XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
643tests that had to be C<TODO>ed for the release would be noted here. Unfixed
644platform specific bugs also go here.
d1ac83c4 645
25219f3f 646[ List each fix as an =item entry ]
d1ac83c4 647
25219f3f 648=over 4
c4f4b223
Z
649
650=item *
651
25219f3f 652XXX
02d43d4f 653
e6a2e5ca
SH
654=back
655
e6a2e5ca
SH
656=head1 Errata From Previous Releases
657
658=over 4
8abafd33 659
e6a2e5ca
SH
660=item *
661
25219f3f
KE
662XXX Add anything here that we forgot to add, or were mistaken about, in
663the perldelta of a previous release.
8abafd33 664
e6a2e5ca 665=back
b2e49ab9 666
25219f3f 667=head1 Obituary
060724e5 668
25219f3f
KE
669XXX If any significant core contributor or member of the CPAN community has
670died, add a short obituary here.
060724e5 671
25219f3f 672=head1 Acknowledgements
060724e5 673
25219f3f 674XXX Generate this with:
060724e5 675
25219f3f 676 perl Porting/acknowledgements.pl v5.27.6..HEAD
f5b73711 677
44691e6f
AB
678=head1 Reporting Bugs
679
b5cbfe35
S
680If you find what you think is a bug, you might check the perl bug database
681at L<https://rt.perl.org/> . There may also be information at
682L<http://www.perl.org/> , the Perl Home Page.
44691e6f 683
e08634c5
SH
684If you believe you have an unreported bug, please run the L<perlbug> program
685included with your release. Be sure to trim your bug down to a tiny but
686sufficient test case. Your bug report, along with the output of C<perl -V>,
b5cbfe35 687will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f 688
87c118b9
DM
689If the bug you are reporting has security implications which make it
690inappropriate to send to a publicly archived mailing list, then see
c0ea3294
SH
691L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
692for details of how to report the issue.
44691e6f 693
390ae6f9
S
694=head1 Give Thanks
695
696If you wish to thank the Perl 5 Porters for the work we had done in Perl 5,
697you can do so by running the C<perlthanks> program:
698
699 perlthanks
700
701This will send an email to the Perl 5 Porters list with your show of thanks.
702
44691e6f
AB
703=head1 SEE ALSO
704
e08634c5
SH
705The F<Changes> file for an explanation of how to view exhaustive details on
706what changed.
44691e6f
AB
707
708The F<INSTALL> file for how to build Perl.
709
710The F<README> file for general stuff.
711
712The F<Artistic> and F<Copying> files for copyright information.
713
714=cut