This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for [perl #75174] (dirp_dup)
[perl5.git] / pod / perldelta.pod
CommitLineData
4c793fe3
FR
1=encoding utf8
2
3=head1 NAME
4
ee0887a9
SH
5[ this is a template for a new perldelta file. Any text flagged as
6XXX needs to be processed before release. ]
4c793fe3 7
ee0887a9 8perldelta - what is new for perl v5.13.6
4c793fe3 9
ee0887a9 10=head1 DESCRIPTION
0c692eed 11
ee0887a9
SH
12This document describes differences between the 5.13.5 release and
13the 5.13.6 release.
0c692eed 14
ee0887a9
SH
15If you are upgrading from an earlier release such as 5.13.4, first read
16L<perl5135delta>, which describes differences between 5.13.4 and
175.13.5.
0c692eed 18
ee0887a9 19=head1 Notice
0c692eed 20
ee0887a9 21XXX Any important notices here
4c793fe3 22
ee0887a9 23=head1 Core Enhancements
85318b69 24
ee0887a9
SH
25XXX New core language features go here. Summarise user-visible core language
26enhancements. Particularly prominent performance optimisations could go
27here, but most should go in the L</Performance Enhancements> section.
85318b69 28
ee0887a9 29[ List each enhancement as a =head2 entry ]
85318b69 30
fb85c044
KW
31=head2 C<(?^...)> regex construct added to signify default modifiers
32
33A caret (also called a "cirumflex accent") C<"^"> immediately following
34a C<"(?"> in a regular expression now means that the subexpression is to
35not inherit the surrounding modifiers such as C</i>, but to revert to the
36Perl defaults. Any modifiers following the caret override the defaults.
37
38The stringification of regular expressions now uses this notation. The
39main purpose of this is to allow tests that rely on the stringification
40to not have to change when new modifiers are added. See
41L<perlre/Extended Patterns>.
42
9de15fec
KW
43=head2 C<"d">, C<"l">, and C<"u"> regex modifiers added
44
45These modifiers are currently only available within a C<(?...)> construct.
46
47The C<"l"> modifier says to compile the regular expression as if it were
48in the scope of C<use locale>, even if it is not.
49
50The C<"u"> modifier currently does nothing.
51
52The C<"d"> modifier is used in the scope of C<use locale> to compile the
53regular expression as if it were not in that scope.
54See L<perlre/(?dlupimsx-imsx)>.
55
fb121860
KW
56=head2 C<\N{...}> now handles Unicode named character sequences
57
58Unicode has a number of named character sequences, in which particular sequences
59of code points are given names. C<\N{...}> now recognizes these.
60See L<charnames>.
61
62=head2 New function C<charnames::string_vianame()>
63
64This function is a run-time version of C<\N{...}>, returning the string
65of characters whose Unicode name is its parameter. It can handle
66Unicode named character sequences, whereas the pre-existing
67C<charnames::vianame()> cannot, as the latter returns a single code
68point.
69See L<charnames>.
70
ee0887a9 71=head1 Security
85318b69 72
ee0887a9
SH
73XXX Any security-related notices go here. In particular, any security
74vulnerabilities closed should be noted here rather than in the
75L</Selected Bug Fixes> section.
85318b69 76
ee0887a9 77[ List each security issue as a =head2 entry ]
4c793fe3
FR
78
79=head1 Incompatible Changes
80
fb85c044
KW
81=head2 Stringification of regexes has changed
82
83Default regular expression modifiers are now notated by using
84C<(?^...)>. Code relying on the old stringification will fail. The
85purpose of this is so that when new modifiers are added, such code will
8477b9ba
KW
86not have to change (after this one time), as the stringification will
87automatically incorporate the new modifiers.
fb85c044
KW
88
89Code that needs to work properly with both old- and new-style regexes
e23837fb 90can avoid the whole issue by using (for Perls since 5.9.5):
8477b9ba
KW
91
92 use re qw(regexp_pattern);
93 my ($pat, $mods) = regexp_pattern($re_ref);
94
95where C<$re_ref> is a reference to a compiled regular expression. Upon
96return, C<$mods> will be a string containing all the non-default
97modifiers used when the regular expression was compiled, and C<$pattern>
98the actual pattern.
99
e23837fb
KW
100If the actual stringification is important, or older Perls need to be
101supported, you can use something like the following:
fb85c044
KW
102
103 # Accept both old and new-style stringification
104 my $modifiers = (qr/foobar/ =~ /\Q(?^/) ? '^' : '-xism';
44428a46 105
fb85c044 106And then use C<$modifiers> instead of C<-xism>.
44428a46 107
9de15fec
KW
108=head2 Regular expressions retain their localeness when interpolated
109
110Regular expressions compiled under C<"use locale"> now retain this when
111interpolated into a new regular expression compiled outside a
112C<"use locale">, and vice-versa.
113
114Previously, a regular expression interpolated into another one inherited
115the localeness of the surrounding one, losing whatever state it
116originally had. This is considered a bug fix, but may trip up code that
117has come to rely on the incorrect behavior.
118
ee0887a9 119[ List each incompatible change as a =head2 entry ]
4c793fe3 120
6904a83f
FC
121=head2 Directory handles not copied to threads
122
123On systems that do not have a C<fchdir> function, newly-created threads no
124longer inherit directory handles from their parent threads. Such programs
125would probably have crashed anyway
126L<[perl #75154]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75154>.
127
4c793fe3
FR
128=head1 Deprecations
129
ee0887a9
SH
130XXX Any deprecated features, syntax, modules etc. should be listed here.
131In particular, deprecated modules should be listed here even if they are
132listed as an updated module in the L</Modules and Pragmata> section.
85318b69 133
ee0887a9 134[ List each deprecation as a =head2 entry ]
4c793fe3
FR
135
136=head1 Performance Enhancements
137
ee0887a9
SH
138XXX Changes which enhance performance without changing behaviour go here. There
139may well be none in a stable release.
4c793fe3 140
ee0887a9 141[ List each enhancement as a =item entry ]
4c793fe3 142
ee0887a9 143=over 4
4c793fe3 144
e2babdfb
FR
145=item *
146
ee0887a9 147XXX
e2babdfb 148
4c793fe3
FR
149=back
150
151=head1 Modules and Pragmata
152
ee0887a9
SH
153XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
154go here. If Module::CoreList is updated, generate an initial draft of the
155following sections using F<Porting/corelist-perldelta.pl>, which prints stub
156entries to STDOUT. Results can be pasted in place of the '=head2' entries
157below. A paragraph summary for important changes should then be added by hand.
158In an ideal world, dual-life modules would have a F<Changes> file that could be
159cribbed.
fc1418b7 160
ee0887a9 161[ Within each section, list entries as a =item entry ]
df91fef1 162
ee0887a9 163=head2 New Modules and Pragmata
ccb45ef4 164
ee0887a9 165=over 4
df91fef1 166
ee0887a9 167=item *
df91fef1 168
ee0887a9 169XXX
e2babdfb 170
ee0887a9 171=back
e2babdfb 172
ee0887a9 173=head2 Updated Modules and Pragmata
fc1418b7 174
ee0887a9 175=over 4
fc1418b7 176
ee0887a9 177=item *
e2babdfb 178
75484d6b
FC
179C<Carp> has been upgraded from version 1.18 to 1.19.
180
181It no longer autovivifies the C<*CORE::GLOBAL::caller> glob, something it
182started doing in 1.18, which was released with perl 5.13.4
183L<[perl #78082]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=78082>
184
185=item *
186
e2941eb0
FC
187C<Data::Dumper> has been upgraded from version 2.128 to 2.129.
188
189C<Dumpxs> no longer crashes with globs returned by C<*$io_ref>
190L<[perl #72332]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=72332>.
191
192=item *
193
62d37bf0
FR
194C<Digest::MD5> has been upgraded from version 2.40 to 2.50.
195
196It is now safe to use this module in combination with threads.
197
198=item *
199
f5b89942
FC
200C<File::DosGlob> has been upgraded from version 1.02 to 1.03.
201
202It allows patterns containing literal parentheses (they no longer need to
203be escaped). On Windows, it no longer adds an extra F<./> to the file names
204returned when the pattern is a relative glob with a drive specification,
6481ebaf
FC
205like F<c:*.pl>
206L<[perl #71712]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=71712>.
f5b89942
FC
207
208=item *
209
4d1599c3
FC
210C<File::Find> has been upgraded from version 1.17 to 1.18.
211
212It improves handling of backslashes on Windows, so that paths such as
6481ebaf
FC
213F<c:\dir\/file> are no longer generated
214L<[perl #71710]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=71710>.
4d1599c3
FC
215
216=item *
217
f1c82292
CBW
218C<if> has been upgraded from version 0.05 to 0.06
219
220=item *
221
25e68b8b
FC
222C<IPC::Open3> has been upgraded from version 1.06 to 1.07.
223
224The internal C<xclose> routine now knows how to handle file descriptors, as
225documented, so duplicating STDIN in a child process using its file
226descriptor now works
227L<[perl #76474]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=71710>.
228
229=item *
230
9607a449
FC
231C<Locale::Maketext> has been upgraded from version 1.15 to 1.16.
232
233It fixes an infinite loop in C<Locale::Maketext::Guts::_compile()> when
234working with tainted values
235(L<CPAN RT #40727|https://rt.cpan.org/Public/Bug/Display.html?id=40727>).
236
237=item *
238
733e2929
FR
239C<Math::BigInt> has been upgraded from version 1.95 to 1.96.
240
241=item *
242
de0e3ce7
FR
243C<NEXT> has been upgraded from version 0.64 to 0.65.
244
245=item *
246
1c2dcb3e
CBW
247C<PathTools> has been upgraded from version 3.31_01 to 3.33.
248
249=item *
250
6481ebaf
FC
251C<sigtrap> has been upgraded from version 1.04 to 1.05.
252
253It no longer tries to modify read-only arguments when generating a
254backtrace
255L<[perl #72340]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=72340>.
256
257=item *
258
dfa4c013
JH
259C<threads> has been upgrade from version 1.77_03 to 1.81
260
261=item *
262
1393fe00
CBW
263C<Unicode::Collate> has been upgraded from version 0.59 to 0.60
264
265=item *
266
1c2dcb3e 267C<Unicode::Normalize> has been upgraded from version 1.06 to 1.07
c9a84c8b 268
ee0887a9 269=back
c9a84c8b 270
ee0887a9 271=head2 Removed Modules and Pragmata
c9a84c8b 272
ee0887a9 273=over 4
4c793fe3 274
ee0887a9 275=item *
48c1efd2 276
ee0887a9 277XXX
4c793fe3
FR
278
279=back
280
281=head1 Documentation
282
ee0887a9
SH
283XXX Changes to files in F<pod/> go here. Consider grouping entries by
284file and be sure to link to the appropriate page, e.g. L<perlfunc>.
4c793fe3 285
ee0887a9 286=head2 New Documentation
4c793fe3 287
ee0887a9 288XXX Changes which create B<new> files in F<pod/> go here.
4c793fe3 289
ee0887a9 290=head3 L<XXX>
4c793fe3 291
ee0887a9 292XXX Description of the purpose of the new file here
4c793fe3 293
ee0887a9 294=head2 Changes to Existing Documentation
fc1418b7 295
ee0887a9
SH
296XXX Changes which significantly change existing files in F<pod/> go here.
297However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
298section.
fc1418b7 299
ee0887a9 300=head3 L<XXX>
e2babdfb 301
7bc3efda
SH
302=over 4
303
304=item *
305
a7e93501
FC
306The documentation for the C<SvTRUE> macro was simply wrong in stating that
307get-magic is not processed. It has been corrected.
7bc3efda
SH
308
309=back
e2babdfb 310
4c793fe3
FR
311=head1 Diagnostics
312
313The following additions or changes have been made to diagnostic output,
314including warnings and fatal error messages. For the complete list of
315diagnostic messages, see L<perldiag>.
316
ee0887a9
SH
317XXX New or changed warnings emitted by the core's C<C> code go here. Also
318include any changes in L<perldiag> that reconcile it to the C<C> code.
4c793fe3 319
ee0887a9 320[ Within each section, list entries as a =item entry ]
4c793fe3 321
ee0887a9 322=head2 New Diagnostics
4c793fe3 323
ee0887a9 324XXX Newly added diagnostic messages go here
fc1418b7 325
ee0887a9 326=over 4
fc1418b7
SH
327
328=item *
329
ee0887a9 330XXX
ebce6c40 331
4c793fe3
FR
332=back
333
ee0887a9 334=head2 Changes to Existing Diagnostics
4c793fe3 335
ee0887a9 336XXX Changes (i.e. rewording) of diagnostic messages go here
4c793fe3
FR
337
338=over 4
339
340=item *
341
dc08898c
FC
342The 'Layer does not match this perl' error message has been replaced with
343these more helpful messages:
344
345=over 4
346
347=item *
348
349PerlIO layer function table size (%d) does not match size expected by this
350perl (%d)
351
352=item *
353
354PerlIO layer instance size (%d) does not match size expected by this perl
355(%d)
356
357=back
358
359L<[perl #73754]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=73754>
4c793fe3
FR
360
361=back
362
ee0887a9 363=head1 Utility Changes
4c793fe3 364
ee0887a9
SH
365XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
366here. Most of these are built within the directories F<utils> and F<x2p>.
4c793fe3 367
ee0887a9
SH
368[ List utility changes as a =head3 entry for each utility and =item
369entries for each change
370Use L<XXX> with program names to get proper documentation linking. ]
fc1418b7 371
ee0887a9 372=head3 L<XXX>
fc1418b7 373
ee0887a9 374=over 4
4c793fe3 375
44428a46
FC
376=item *
377
ee0887a9 378XXX
44428a46 379
4c793fe3
FR
380=back
381
ee0887a9 382=head1 Configuration and Compilation
4c793fe3 383
ee0887a9
SH
384XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
385go here. Any other changes to the Perl build process should be listed here.
386However, any platform-specific changes should be listed in the
387L</Platform Support> section, instead.
4c793fe3 388
ee0887a9 389[ List changes as a =item entry ].
4c793fe3 390
0c692eed
FR
391=over 4
392
393=item *
394
ee0887a9 395XXX
0c692eed
FR
396
397=back
4c793fe3 398
ee0887a9 399=head1 Testing
0c692eed 400
ee0887a9
SH
401XXX Any significant changes to the testing of a freshly built perl should be
402listed here. Changes which create B<new> files in F<t/> go here as do any
403large changes to the testing harness (e.g. when parallel testing was added).
404Changes to existing files in F<t/> aren't worth summarising, although the bugs
405that they represent may be covered elsewhere.
0c692eed 406
ee0887a9 407[ List each test improvement as a =item entry ]
0c692eed 408
ee0887a9 409=over 4
0c692eed
FR
410
411=item *
412
ee0887a9 413XXX
4c793fe3
FR
414
415=back
416
ee0887a9 417=head1 Platform Support
4c793fe3 418
ee0887a9 419XXX Any changes to platform support should be listed in the sections below.
4c793fe3 420
ee0887a9
SH
421[ Within the sections, list each platform as a =item entry with specific
422changes as paragraphs below it. ]
4c793fe3 423
ee0887a9 424=head2 New Platforms
0c692eed 425
ee0887a9
SH
426XXX List any platforms that this version of perl compiles on, that previous
427versions did not. These will either be enabled by new files in the F<hints/>
428directories, or new subdirectories and F<README> files at the top level of the
429source tree.
0c692eed 430
ee0887a9 431=over 4
0c692eed 432
ee0887a9 433=item XXX-some-platform
0c692eed 434
ee0887a9 435XXX
0c692eed 436
ee0887a9 437=back
0c692eed 438
ee0887a9 439=head2 Discontinued Platforms
4c793fe3 440
ee0887a9 441XXX List any platforms that this version of perl no longer compiles on.
8ebb9810 442
ee0887a9 443=over 4
8ebb9810 444
ee0887a9 445=item XXX-some-platform
48c1efd2 446
ee0887a9 447XXX
48c1efd2 448
ee0887a9 449=back
44428a46 450
ee0887a9 451=head2 Platform-Specific Notes
44428a46 452
ee0887a9
SH
453XXX List any changes for specific platforms. This could include configuration
454and compilation changes or changes in portability/compatibility. However,
455changes within modules for platforms should generally be listed in the
456L</Modules and Pragmata> section.
f4beb78f 457
ee0887a9 458=over 4
f4beb78f 459
6034bceb
FC
460=item Mac OS X
461
462Early versions of Mac OS X (Darwin) had buggy implementations of the
463C<setregid>, C<setreuid>, C<setrgid> and C<setruid> functions, so perl
464would pretend they did not exist.
465
466These functions are now recognised on Mac OS 10.5 (Leopard; Darwin 9) and
467higher, as they have been fixed
468L<[perl #72990]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=72990>.
469
2ffefa5a 470=item Windows
ccb45ef4 471
2ffefa5a
FC
472C<$Config{gccversion}> is now set correctly when perl is built using the
473mingw64 compiler from L<http://mingw64.org>
474L<[perl #73754]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=73754>.
475
476=back
ccb45ef4 477
ee0887a9 478=head1 Internal Changes
85318b69 479
ee0887a9
SH
480XXX Changes which affect the interface available to C<XS> code go here.
481Other significant internal changes for future core maintainers should
482be noted as well.
85318b69 483
ee0887a9 484[ List each test improvement as a =item entry ]
80b6a949 485
ee0887a9 486=over 4
80b6a949 487
e2babdfb
FR
488=item *
489
a5763045
FC
490See L</Regular expressions retain their localeness when interpolated>,
491above.
e2babdfb 492
a7e93501
FC
493=item *
494
495The C<sv_cmp_flags>, C<sv_cmp_locale_flags>, C<sv_eq_flags> and
496C<sv_collxfrm_flags> functions have been added. These are like their
497non-_flags counterparts, but allow one to specify whether get-magic is
498processed.
499
500The C<sv_cmp>, C<sv_cmp_locale>, C<sv_eq> and C<sv_collxfrm> functions have
501been replaced with wrappers around the new functions.
502
503=item *
504
505A new C<sv_2bool_flags> function has been added.
506
507This is like C<sv_2bool>, but it lets the calling code decide whether
508get-magic is handled. C<sv_2bool> is now a macro that calls the new
509function.
510
511=item *
512
513A new macro, C<SvTRUE_nomg>, has been added.
514
515This is like C<SvTRUE>, except that it does not process magic. It uses the
516new C<sv_2bool_flags> function.
517
518=item *
519
520C<sv_catsv_flags> no longer calls C<mg_get> on its second argument (the
521source string) if the flags passed to it do not include SV_GMAGIC. So it
522now matches what the documentation says it does.
523
ee0887a9 524=back
e2babdfb 525
ee0887a9 526=head1 Selected Bug Fixes
e2babdfb 527
ee0887a9
SH
528XXX Important bug fixes in the core language are summarised here.
529Bug fixes in files in F<ext/> and F<lib/> are best summarised in
530L</Modules and Pragmata>.
e2babdfb 531
ee0887a9 532[ List each fix as a =item entry ]
346e4e56 533
ee0887a9 534=over 4
346e4e56 535
78846812
FR
536=item *
537
4e9f151b
FC
538A regular expression match in the right-hand side of a global substitution
539(C<s///g>) that is in the same scope will no longer cause match variables
540to have the wrong values on subsequent iterations. This can happen when an
e54f3f30
FC
541array or hash subscript is interpolated in the right-hand side, as in
542C<s|(.)|@a{ print($1), /./ }|g>
543L<[perl #19078]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=19078>.
544
545=item *
546
547Constant-folding used to cause
548
549 $text =~ ( 1 ? /phoo/ : /bear/)
550
551to turn into
552
553 $text =~ /phoo/
554
555at compile time. Now it correctly matches against C<$_>
556L<[perl #20444]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=20444>.
78846812 557
a5763045
FC
558=item *
559
560Parsing Perl code (either with string C<eval> or by loading modules) from
561within a C<UNITCHECK> block no longer causes the interpreter to crash
562L<[perl #70614]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=70614>.
563
5a9a79a4
FC
564=item *
565
566When C<-d> is used on the shebang (C<#!>) line, the debugger now has access
567to the lines of the main program. In the past, this sometimes worked and
568sometimes did not, depending on what order things happened to be arranged
b45e2413
FC
569in memory
570L<[perl #71806]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=71806>.
5a9a79a4 571
a7e93501
FC
572=item *
573
574The C<y///> or C<tr///> operator now calls get-magic (e.g., the C<FETCH>
575method of a tie) on its left-hand side just once, not twice
576L<[perl #76814]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=76814>.
577
578=item *
579
580String comparison (C<eq>, C<ne>, C<lt>, C<gt>, C<le>, C<ge> and
581C<cmp>) and logical not (C<not> and C<!>) operators no longer call magic
582(e.g., tie methods) twice on their operands
583L<[perl #76814]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=76814>.
584
585This bug was introduced in an earlier 5.13 release, and does not affect
586perl 5.12.
587
588=item *
589
590When a tied (or other magic) variable is used as, or in, a regular
591expression, it no longer has its C<FETCH> method called twice
592L<[perl #76814]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=76814>.
593
594This bug was introduced in an earlier 5.13 release, and does not affect
595perl 5.12.
596
d4a59e54
FC
597=item *
598
8420a925 599The C<-C> command line option can now be followed by other options
d4a59e54
FC
600L<[perl #72434]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=72434>.
601
dc08898c
FC
602=item *
603
604Assigning a glob to a PVLV used to convert it to a plain string. Now it
605works correctly, and a PVLV can hold a glob. This would happen when a
606nonexistent hash or array element was passed to a subroutine:
607
608 sub { $_[0] = *foo }->($hash{key});
609 # $_[0] would have been the string "*main::foo"
610
611It also happened when a glob was assigned to, or returned from, an element
612of a tied array or hash
613L<[perl #36051]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=36051>.
614
6904a83f
FC
615=item *
616
617Creating a new thread when directory handles were open used to cause a
618crash, because the handles were not cloned, but simply passed to the new
619thread, resulting in a double free.
620
621Now directory handles are properly, on systems that have a C<fchdir>
622function. On other systems, new threads simply do not inherit directory
623handles from their parent threads
624L<[perl #75154]|http://rt.perl.org/rt3/Public/Bug/Display.html?id=75154>.
625
4c793fe3
FR
626=back
627
962fbe1d
SH
628=head1 Known Problems
629
ee0887a9
SH
630XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
631tests that had to be C<TODO>ed for the release would be noted here, unless
632they were specific to a particular platform (see below).
962fbe1d 633
ee0887a9
SH
634This is a list of some significant unfixed bugs, which are regressions
635from either 5.XXX.XXX or 5.XXX.XXX.
962fbe1d 636
ee0887a9
SH
637[ List each fix as a =item entry ]
638
639=over 4
08d032c0
SH
640
641=item *
642
ee0887a9 643XXX
962fbe1d
SH
644
645=back
646
ee0887a9 647=head1 Obituary
4c793fe3 648
ee0887a9
SH
649XXX If any significant core contributor has died, we've added a short obituary
650here.
0195fb5f 651
405fd67e
DG
652=head1 Errata
653
654=over 4
655
656=item *
657
658Fixed a typo in L<perl5135delta> regarding array slices and smart matching
659
660=back
661
ee0887a9 662=head1 Acknowledgements
0195fb5f 663
ee0887a9 664XXX The list of people to thank goes here.
4c793fe3
FR
665
666=head1 Reporting Bugs
667
668If you find what you think is a bug, you might check the articles
669recently posted to the comp.lang.perl.misc newsgroup and the perl
670bug database at http://rt.perl.org/perlbug/ . There may also be
671information at http://www.perl.org/ , the Perl Home Page.
672
673If you believe you have an unreported bug, please run the B<perlbug>
674program included with your release. Be sure to trim your bug down
675to a tiny but sufficient test case. Your bug report, along with the
676output of C<perl -V>, will be sent off to perlbug@perl.org to be
677analysed by the Perl porting team.
678
679If the bug you are reporting has security implications, which make it
680inappropriate to send to a publicly archived mailing list, then please send
ee0887a9 681it to perl5-security-report@perl.org. This points to a closed subscription
4c793fe3
FR
682unarchived mailing list, which includes all the core committers, who be able
683to help assess the impact of issues, figure out a resolution, and help
684co-ordinate the release of patches to mitigate or fix the problem across all
ee0887a9 685platforms on which Perl is supported. Please only use this address for
4c793fe3
FR
686security issues in the Perl core, not for modules independently
687distributed on CPAN.
688
689=head1 SEE ALSO
690
691The F<Changes> file for an explanation of how to view exhaustive details
692on what changed.
693
694The F<INSTALL> file for how to build Perl.
695
696The F<README> file for general stuff.
697
698The F<Artistic> and F<Copying> files for copyright information.
699
700=cut