This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Merge Storable::{is_storing,is_retrieving} using ALIAS.
[perl5.git] / pod / perldelta.pod
CommitLineData
4c793fe3
FR
1=encoding utf8
2
c39f7439 3=for comment
b293762b 4This has been completed up to 0b6a3b5adbe83, except for:
48ea5431
FC
504777d295957ad270188e4debf51b523e07cc5b0
6c565ab54dc649bb62cd4d57149d7b2abb21df5f3
a5e71717 71c8d11ca3d0ce8bc11562f159b94c2c7e62dea6c
c39f7439 8
4c793fe3
FR
9=head1 NAME
10
8f97a47a
TM
11[ this is a template for a new perldelta file. Any text flagged as
12XXX needs to be processed before release. ]
4c793fe3 13
8f97a47a 14perldelta - what is new for perl v5.13.7
a12cf05f 15
8f97a47a 16=head1 DESCRIPTION
fb121860 17
8f97a47a
TM
18This document describes differences between the 5.13.6 release and
19the 5.13.7 release.
eb32ee41 20
8f97a47a
TM
21If you are upgrading from an earlier release such as 5.13.5, first read
22L<perl5136delta>, which describes differences between 5.13.5 and
235.13.6.
eb32ee41 24
8f97a47a 25=head1 Notice
eb32ee41 26
8f97a47a 27XXX Any important notices here
5e26bbbe 28
8f97a47a 29=head1 Core Enhancements
5e26bbbe 30
8f97a47a
TM
31XXX New core language features go here. Summarise user-visible core language
32enhancements. Particularly prominent performance optimisations could go
33here, but most should go in the L</Performance Enhancements> section.
5e26bbbe 34
8f97a47a 35[ List each enhancement as a =head2 entry ]
4f65bc30 36
c035a075
DG
37=head2 Single term prototype
38
39The C<+> prototype is a special alternative to C<$> that will act like
40C<\[@%]> when given a literal array or hash variable, but will otherwise
41force scalar context on the argument. This is useful for functions which
42should accept either a literal array or an array reference as the argument:
43
44 sub smartpush (+@) {
45 my $aref = shift;
46 die "Not an array or arrayref" unless ref $aref eq 'ARRAY';
47 push @$aref, @_;
48 }
49
50When using the C<+> prototype, your function must check that the argument
51is of an acceptable type.
52
b7bd32cc
FC
53=head2 C<use re '/flags';>
54
55The C<re> pragma now has the ability to turn on regular expression flags
56till the end of the lexical scope:
57
58 use re '/x';
59 "foo" =~ / (.+) /; # /x implied
60
61See L<re/'/flags' mode> for details.
62
a5e71717
FC
63=head2 Statement labels can appear in more places
64
65Statement labels can now occur before any type of statement or declaration,
66such as C<package>.
67
9b7c43ba
KW
68=head2 C<use feature "unicode_strings"> now applies to more regex matching
69
70Another chunk of the L<perlunicode/The "Unicode Bug"> is fixed in this
71release. Now, regular expressions compiled within the scope of the
72"unicode_strings" feature (or under the "u" regex modifier (specifiable
73currently only with infix notation C<(?u:...)> or via C<use re '/u'>)
74will match the same whether or not the target string is encoded in utf8,
75with regard to C<[[:posix:]]> character classes
76
77Work is underway to add the case sensitive matching to the control of
78this feature, but was not complete in time for this dot release.
79
8f97a47a 80=head1 Security
4f65bc30 81
8f97a47a
TM
82XXX Any security-related notices go here. In particular, any security
83vulnerabilities closed should be noted here rather than in the
84L</Selected Bug Fixes> section.
0eec0a4c 85
8f97a47a 86[ List each security issue as a =head2 entry ]
0eec0a4c 87
4c793fe3
FR
88=head1 Incompatible Changes
89
8f97a47a 90XXX For a release on a stable branch, this section aspires to be:
9de15fec 91
8f97a47a
TM
92 There are no changes intentionally incompatible with 5.XXX.XXX. If any
93 exist, they are bugs and reports are welcome.
9de15fec 94
8f97a47a 95[ List each incompatible change as a =head2 entry ]
9de15fec 96
a638ba6f
FC
97=head2 Dereferencing typeglobs
98
99If you assign a typeglob to a scalar variable:
100
101 $glob = *foo;
102
103the glob that is copied to C<$glob> is marked with a special flag
104indicating that the glob is just a copy. This allows subsequent assignments
105to C<$glob> to overwrite the glob. The original glob, however, is
106immutable.
107
108Many Perl operators did not distinguish between these two types of globs.
109This would result in strange behaviour in edge cases: C<untie $scalar>
110would do nothing if the last thing assigned to the scalar was a glob
111(because it treated it as C<untie *$scalar>, which unties a handle).
0b6a3b5a 112Assignment to a glob slot (e.g., C<(*$glob) = \@some_array>) would simply
a638ba6f
FC
113assign C<\@some_array> to C<$glob>.
114
115To fix this, the C<*{}> operator (including the C<*foo> and C<*$foo> forms)
116has been modified to make a new immutable glob if its operand is a glob
117copy. Various operators that make a distinction between globs and scalars
118have been modified to treat only immutable globs as globs.
119
120This causes an incompatible change in code that assigns a glob to the
121return value of C<*{}> when that operator was passed a glob copy. Take the
122following code, for instance:
123
124 $glob = *foo;
125 *$glob = *bar;
126
127The C<*$glob> on the second line returns a new immutable glob. That new
128glob is made an alias to C<*bar>. Then it is discarded.
129
130The upside to this incompatible change is that bugs
131L<[perl #77496]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77496>,
132L<[perl #77502]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77502>,
133L<[perl #77508]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77508>,
134L<[perl #77688]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77688>,
135and
136L<[perl #77812]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77812>,
137and maybe others, too, have been fixed.
138
0b6a3b5a
FC
139See L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=77810> for even
140more detail.
a638ba6f 141
8f97a47a 142=head1 Deprecations
6904a83f 143
8f97a47a
TM
144XXX Any deprecated features, syntax, modules etc. should be listed here.
145In particular, deprecated modules should be listed here even if they are
146listed as an updated module in the L</Modules and Pragmata> section.
6904a83f 147
8f97a47a 148[ List each deprecation as a =head2 entry ]
afa74577 149
4c793fe3
FR
150=head1 Performance Enhancements
151
8f97a47a
TM
152XXX Changes which enhance performance without changing behaviour go here. There
153may well be none in a stable release.
4c793fe3 154
8f97a47a 155[ List each enhancement as a =item entry ]
e2babdfb 156
8f97a47a 157=over 4
e2babdfb 158
b141c43c
FR
159=item *
160
8f97a47a 161XXX
b141c43c 162
4c793fe3
FR
163=back
164
165=head1 Modules and Pragmata
166
8f97a47a
TM
167XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
168go here. If Module::CoreList is updated, generate an initial draft of the
169following sections using F<Porting/corelist-perldelta.pl>, which prints stub
170entries to STDOUT. Results can be pasted in place of the '=head2' entries
171below. A paragraph summary for important changes should then be added by hand.
172In an ideal world, dual-life modules would have a F<Changes> file that could be
173cribbed.
e2941eb0 174
8f97a47a 175[ Within each section, list entries as a =item entry ]
e2941eb0 176
8f97a47a 177=head2 New Modules and Pragmata
25e68b8b 178
8f97a47a 179=over 4
463da0ac
CBW
180
181=item *
182
539ce3d8
CBW
183C<Unicode::Collate::CJK::JISX0208> module was added by the C<Unicode::Collate>
184upgrade from 0.63 to 0.64. See below.
6481ebaf 185
8f97a47a 186=back
6481ebaf 187
8f97a47a 188=head2 Updated Modules and Pragmata
6481ebaf 189
8f97a47a 190=over 4
ac4c9720
CBW
191
192=item *
193
9f1eb87f
CBW
194C<Archive::Extract> has been upgraded from 0.44 to 0.46
195
196Resolves an issue with NetBSD-current and its new unzip
197executable.
198
199=item *
200
a5e71717
FC
201C<B> has been upgraded from 1.24 to 1.25.
202
203=item *
204
b7bd32cc
FC
205XXX What should the version be?
206
b293762b 207C<B::Deparse> has been upgraded from 0.99 to 1.01.
b7bd32cc
FC
208
209It fixes deparsing of C<our> followed by a variable with funny characters
210(as permitted under the C<utf8> pragma)
211L<[perl #33752]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=33752>.
212
213=item *
214
07be2ace
CBW
215C<CPAN> has been upgraded from 1.94_61 to 1.94_62
216
217=item *
218
59af3f66
CBW
219C<CPANPLUS> has been upgraded from 0.9007 to 0.9010
220
221Fixes for the SQLite source engine and resolving of issues with the
222testsuite when run under local::lib and/or cpanminus
223
224=item *
225
f5c34353
CBW
226C<CPANPLUS::Dist::Build> has been upgraded from 0.48 to 0.50
227
228=item *
229
48ea5431
FC
230C<ExtUtils::Constant> has been upgraded from 0.22 to 0.23.
231
232=item *
233
234C<Fcntl> has been upgraded from 1.09 to 1.10.
235
236=item *
237
238C<File::Glob> has been upgraded from 1.09 to 1.10.
239
240=item *
241
c39f7439
FC
242C<GDBM_File> has been upgraded from 1.11 to 1.12.
243
244This fixes a memory leak when DBM filters are used.
245
246=item *
247
48ea5431
FC
248C<Hash::Util> has been upgraded from 0.09 to 0.10.
249
b293762b
FC
250=item *
251
252C<Hash::Util::FieldHash> has been upgraded from 1.05 to 1.06.
48ea5431
FC
253
254=item *
255
256C<I18N::Langinfo> has been upgraded from 0.06 to 0.07.
257
258=item *
259
e1be28b4
TR
260C<Locale::Maketext> has been upgraded from 1.16 to 1.17
261
262=item *
263
b293762b
FC
264C<Math::BigInt::FastCalc> has been upgraded from 0.22 to 0.23.
265
266=item *
267
c39f7439
FC
268C<NDBM_File> has been upgraded from 1.09 to 1.10.
269
270This fixes a memory leak when DBM filters are used.
271
272=item *
273
274C<ODBM_File> has been upgraded from 1.08 to 1.09.
275
276This fixes a memory leak when DBM filters are used.
277
278=item *
279
48ea5431
FC
280C<POSIX> has been upgraded from 1.21 to 1.22.
281
282=item *
283
b7bd32cc
FC
284C<re> has been upgraded from 0.13 to 0.14, for the sake of the new
285C<use re "/flags"> pragma.
dfa4c013 286
48ea5431
FC
287=item *
288
289C<SDBM_File> has been upgraded from 1.07 to 1.08.
290
291=item *
292
a5e71717
FC
293C<SelfLoader> has been upgraded from 1.17 to 1.18.
294
295It now works in taint mode
296L<[perl #72062]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72062>.
297
298=item *
299
48ea5431
FC
300C<Socket> has been upgraded from 1.90 to 1.91.
301
a5e71717
FC
302=item *
303
304C<Sys::Hostname> has been upgraded from 1.13 to 1.14.
305
539ce3d8
CBW
306=item *
307
308C<Unicode::Collate> has been upgraded from 0.63 to 0.64
309
310This release newly adds locale C<ja> and the module
311C<Unicode::Collate::CJK::JISX0208> which makes tailoring of 6355 kanji
312(CJK Unified Ideographs) in the JIS X 0208 order.
313
8f97a47a 314=back
dfa4c013 315
8f97a47a 316=head2 Removed Modules and Pragmata
c02ee425 317
8f97a47a 318=over 4
1393fe00
CBW
319
320=item *
321
8f97a47a 322XXX
c9a84c8b 323
8f97a47a 324=back
918184d1 325
8f97a47a 326=head1 Documentation
918184d1 327
8f97a47a
TM
328XXX Changes to files in F<pod/> go here. Consider grouping entries by
329file and be sure to link to the appropriate page, e.g. L<perlfunc>.
918184d1 330
8f97a47a 331=head2 New Documentation
dca41e57 332
8f97a47a 333XXX Changes which create B<new> files in F<pod/> go here.
dca41e57 334
8f97a47a 335=head3 L<XXX>
c9a84c8b 336
8f97a47a 337XXX Description of the purpose of the new file here
4c793fe3 338
ee0887a9 339=head2 Changes to Existing Documentation
fc1418b7 340
8f97a47a
TM
341XXX Changes which significantly change existing files in F<pod/> go here.
342However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
343section.
344
7eb82171
DG
345=over
346
48ea5431
FC
347=item *
348
a5e71717 349Array and hash slices in scalar context are now documented in L<perldata>.
48ea5431 350
b293762b
FC
351=item *
352
353L<perlform> and L<perllocale> have been corrected to state that
354C<use locale> affects formats.
355
7eb82171
DG
356=back
357
8f97a47a 358=head3 L<XXX>
e2babdfb 359
7bc3efda
SH
360=over 4
361
362=item *
363
8f97a47a 364XXX Description of the change here
7bc3efda
SH
365
366=back
e2babdfb 367
4c793fe3
FR
368=head1 Diagnostics
369
370The following additions or changes have been made to diagnostic output,
371including warnings and fatal error messages. For the complete list of
372diagnostic messages, see L<perldiag>.
373
8f97a47a
TM
374XXX New or changed warnings emitted by the core's C<C> code go here. Also
375include any changes in L<perldiag> that reconcile it to the C<C> code.
4c793fe3 376
8f97a47a 377[ Within each section, list entries as a =item entry ]
4c793fe3 378
8f97a47a 379=head2 New Diagnostics
4c793fe3 380
8f97a47a 381XXX Newly added diagnostic messages go here
dc08898c
FC
382
383=over 4
384
385=item *
386
8f97a47a 387XXX
dc08898c
FC
388
389=back
390
8f97a47a 391=head2 Changes to Existing Diagnostics
4c793fe3 392
8f97a47a 393XXX Changes (i.e. rewording) of diagnostic messages go here
0c692eed 394
ee0887a9 395=over 4
0c692eed
FR
396
397=item *
398
8f97a47a 399XXX
4c793fe3
FR
400
401=back
402
8f97a47a 403=head1 Utility Changes
810f3b7c 404
8f97a47a
TM
405XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
406here. Most of these are built within the directories F<utils> and F<x2p>.
a9e68e41 407
8f97a47a
TM
408[ List utility changes as a =head3 entry for each utility and =item
409entries for each change
410Use L<XXX> with program names to get proper documentation linking. ]
a9e68e41 411
8f97a47a 412=head3 L<XXX>
85318b69 413
ee0887a9 414=over 4
80b6a949 415
e2babdfb
FR
416=item *
417
8f97a47a 418XXX
9ae8c3d9 419
ee0887a9 420=back
e2babdfb 421
8f97a47a 422=head1 Configuration and Compilation
e2babdfb 423
8f97a47a
TM
424XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
425go here. Any other changes to the Perl build process should be listed here.
426However, any platform-specific changes should be listed in the
427L</Platform Support> section, instead.
346e4e56 428
8f97a47a 429[ List changes as a =item entry ].
78846812 430
8f97a47a 431=over 4
e54f3f30
FC
432
433=item *
434
8f97a47a 435XXX
e54f3f30 436
8f97a47a 437=back
a5763045 438
8f97a47a 439=head1 Testing
5a9a79a4 440
8f97a47a
TM
441XXX Any significant changes to the testing of a freshly built perl should be
442listed here. Changes which create B<new> files in F<t/> go here as do any
443large changes to the testing harness (e.g. when parallel testing was added).
444Changes to existing files in F<t/> aren't worth summarising, although the bugs
445that they represent may be covered elsewhere.
5a9a79a4 446
8f97a47a 447[ List each test improvement as a =item entry ]
a7e93501 448
8f97a47a 449=over 4
a7e93501
FC
450
451=item *
452
8f97a47a 453XXX
a7e93501 454
8f97a47a 455=back
a7e93501 456
8f97a47a 457=head1 Platform Support
a7e93501 458
8f97a47a 459XXX Any changes to platform support should be listed in the sections below.
a7e93501 460
8f97a47a
TM
461[ Within the sections, list each platform as a =item entry with specific
462changes as paragraphs below it. ]
a7e93501 463
8f97a47a 464=head2 New Platforms
d4a59e54 465
8f97a47a
TM
466XXX List any platforms that this version of perl compiles on, that previous
467versions did not. These will either be enabled by new files in the F<hints/>
468directories, or new subdirectories and F<README> files at the top level of the
469source tree.
d4a59e54 470
8f97a47a 471=over 4
dc08898c 472
8f97a47a 473=item XXX-some-platform
dc08898c 474
8f97a47a 475XXX
dc08898c 476
8f97a47a 477=back
6904a83f 478
8f97a47a 479=head2 Discontinued Platforms
6904a83f 480
8f97a47a 481XXX List any platforms that this version of perl no longer compiles on.
6904a83f 482
8f97a47a 483=over 4
cffb3698 484
8f97a47a 485=item XXX-some-platform
ab4c2c27 486
8f97a47a 487XXX
ab4c2c27 488
8f97a47a 489=back
be1cc451 490
8f97a47a 491=head2 Platform-Specific Notes
be1cc451 492
8f97a47a
TM
493XXX List any changes for specific platforms. This could include configuration
494and compilation changes or changes in portability/compatibility. However,
495changes within modules for platforms should generally be listed in the
496L</Modules and Pragmata> section.
b20c4ee1 497
8f97a47a 498=over 4
b20c4ee1 499
b293762b 500=item Windows
afa74577 501
b293762b
FC
502Directory handles are now properly cloned when threads are created. In perl
5035.13.6, child threads simply stopped inheriting directory handles. In
504previous versions, threads would share handles, resulting in crashes.
afa74577 505
8f97a47a 506=back
c8bbf675 507
8f97a47a 508=head1 Internal Changes
c8bbf675 509
8f97a47a
TM
510XXX Changes which affect the interface available to C<XS> code go here.
511Other significant internal changes for future core maintainers should
512be noted as well.
07d5f7aa 513
8f97a47a 514[ List each test improvement as a =item entry ]
07d5f7aa 515
8f97a47a 516=over 4
07d5f7aa 517
9ae8c3d9
FC
518=item *
519
b7bd32cc
FC
520C<lex_start> has been added to the API, but is considered experimental.
521
522=item *
523
524A new C<parse_block> function has been added to the API
525L<[perl #78222]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78222>.
526
527=item *
528
c678e617 529A new, experimental API has been added for accessing the internal
b7bd32cc
FC
530structure that Perl uses for C<%^H>. See the functions beginning with
531C<cophh_> in L<perlapi>.
9ae8c3d9 532
a5e71717
FC
533=item *
534
535A stash can now have a list of effective names in addition to its usual
536name. These can be added and deleted via C<hv_ename_add> and
537C<hv_ename_delete>. The first effective name can be accessed via the
538C<HvENAME*> macros defined in F<hv.h>. These new functions and macros are
539I<not> part of the API.
540
b293762b
FC
541=item *
542
543The way the parser handles labels has been cleaned up and refactored. As a
544result, the C<newFOROP()> constructor function no longer takes a parameter
545stating what label is to go in the state op.
546
547=item *
548
549The C<newWHILEOP()> and C<newFOROP()> functions no longer accept a line
550number as a parameter.
551
552=item *
553
554A new C<parse_barestmt()> function has been added, for parsing a statement
555without a label.
556
557=item *
558
559A new C<parse_label()> function has been added, that parses a statement
560labels, separate from statements.
561
562=item *
563
564The C<CvSTASH()> macro can now only be used as an rvalue. C<CvSTASH_set()>
565has been added to replace assignment to C<CvSTASH()>. This is to ensure
566that backreferences are handled properly. These macros are not part of the
567API.
568
569=item *
570
571The C<op_scope()> and C<op_lvalue()> functions have been added to the API,
572but are considered experimental.
573
8f97a47a 574=back
825563b9 575
8f97a47a 576=head1 Selected Bug Fixes
825563b9 577
8f97a47a
TM
578XXX Important bug fixes in the core language are summarised here.
579Bug fixes in files in F<ext/> and F<lib/> are best summarised in
580L</Modules and Pragmata>.
825563b9 581
8f97a47a 582[ List each fix as a =item entry ]
825563b9 583
8f97a47a 584=over 4
825563b9 585
020fe755
AB
586=item *
587
b7bd32cc
FC
588The C<parse_stmt> C function added in earlier in the 5.13.x series has been
589fixed to work with statements ending with C<}>
590L<[perl #78222]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78222>.
591
592=item *
593
594The C<parse_fullstmt> C function added in 5.13.5 has been fixed to work
595when called while an expression is being parsed.
596
597=item *
598
599Characters in the Latin-1 non-ASCII range (0x80 to 0xFF) used not to match
600themselves if the string happened to be UTF8-encoded internally, the
601regular expression was not, and the character in the regular expression was
602inside a repeated group (e.g.,
c678e617 603C<Encode::decode_utf8("\303\200") =~ /(\xc0)+/>)
b7bd32cc
FC
604L<[perl #78464]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78464>.
605
606=item *
607
608The C<(?d)> regular expression construct now overrides a previous C<(?u)>
609or C<use feature "unicode_string">
610L<[perl #78508]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78508>.
611
612=item *
613
614A memory leak in C<do "file">, introduced in perl 5.13.6, has been fixed
615L<[perl #78488]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78488>.
020fe755 616
b293762b
FC
617=item *
618
619Various bugs related to typeglob dereferencing have been fixed. See
620L</Dereferencing typeglobs>, above.
621
622=item *
623
624The C<SvPVbyte> function available to XS modules now calls magic before
625downgrading the SV, to avoid warnings about wide characters
626L<[perl #72398]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=72398>.
627
628=item *
629
630The C<=> operator used to ignore magic (e.g., tie methods) on its
631right-hand side if the scalar happened to hold a typeglob. This could
632happen if a typeglob was the last thing returned from or assigned to a tied
633scalar
634L<[perl #77498]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=77498>.
635
636=item *
637
638C<sprintf> was ignoring locales when called with constant arguments
639L<[perl #78632]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=78632>.
640
9b7c43ba
KW
641=item *
642
643A non-ASCII character in the Latin-1 range could match both a Posix
644class, such as C<[[:alnum:]]>, and its inverse C<[[:^alnum:]]>. This is
645now fixed for regular expressions compiled under the C<"u"> modifier.
646See L</C<use feature "unicode_strings"> now applies to more regex matching>.
647L<[perl #18281]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=18281>.
648
8f97a47a 649=back
020fe755 650
8f97a47a 651=head1 Known Problems
020fe755 652
8f97a47a
TM
653XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
654tests that had to be C<TODO>ed for the release would be noted here, unless
655they were specific to a particular platform (see below).
62ff64ce 656
8f97a47a
TM
657This is a list of some significant unfixed bugs, which are regressions
658from either 5.XXX.XXX or 5.XXX.XXX.
62ff64ce 659
8f97a47a 660[ List each fix as a =item entry ]
62ff64ce 661
8f97a47a 662=over 4
62ff64ce
FC
663
664=item *
665
8f97a47a 666XXX
62ff64ce 667
4c793fe3
FR
668=back
669
8f97a47a 670=head1 Obituary
405fd67e 671
8f97a47a
TM
672XXX If any significant core contributor has died, we've added a short obituary
673here.
405fd67e 674
ee0887a9 675=head1 Acknowledgements
0195fb5f 676
8f97a47a 677XXX The list of people to thank goes here.
4c793fe3
FR
678
679=head1 Reporting Bugs
680
681If you find what you think is a bug, you might check the articles
682recently posted to the comp.lang.perl.misc newsgroup and the perl
683bug database at http://rt.perl.org/perlbug/ . There may also be
684information at http://www.perl.org/ , the Perl Home Page.
685
686If you believe you have an unreported bug, please run the B<perlbug>
687program included with your release. Be sure to trim your bug down
688to a tiny but sufficient test case. Your bug report, along with the
689output of C<perl -V>, will be sent off to perlbug@perl.org to be
690analysed by the Perl porting team.
691
692If the bug you are reporting has security implications, which make it
693inappropriate to send to a publicly archived mailing list, then please send
ee0887a9 694it to perl5-security-report@perl.org. This points to a closed subscription
4c793fe3
FR
695unarchived mailing list, which includes all the core committers, who be able
696to help assess the impact of issues, figure out a resolution, and help
697co-ordinate the release of patches to mitigate or fix the problem across all
ee0887a9 698platforms on which Perl is supported. Please only use this address for
4c793fe3
FR
699security issues in the Perl core, not for modules independently
700distributed on CPAN.
701
702=head1 SEE ALSO
703
704The F<Changes> file for an explanation of how to view exhaustive details
705on what changed.
706
707The F<INSTALL> file for how to build Perl.
708
709The F<README> file for general stuff.
710
711The F<Artistic> and F<Copying> files for copyright information.
712
713=cut