This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for ff4a442c79
[perl5.git] / pod / perldelta.pod
CommitLineData
4e9d771a
FC
1=for todo
2b47a847f62 win32/win32sck.c: dont close() a freed socket os handle
8ea7af8c 335e037e846 Commit 1735f6f started to escape all...
6dc3be8c 49b4bdfd44e fix chop formats with non PV vars
4e9d771a 5
44691e6f
AB
6=encoding utf8
7
8=head1 NAME
9
28ee95bc
SH
10[ this is a template for a new perldelta file. Any text flagged as XXX needs
11to be processed before release. ]
12
13perldelta - what is new for perl v5.19.6
e128ab2c 14
4eabcf70 15=head1 DESCRIPTION
6db9054f 16
28ee95bc 17This document describes differences between the 5.19.5 release and the 5.19.6
e08634c5 18release.
6db9054f 19
28ee95bc
SH
20If you are upgrading from an earlier release such as 5.19.4, first read
21L<perl5195delta>, which describes differences between 5.19.4 and 5.19.5.
a9c9e371 22
28ee95bc 23=head1 Notice
12ea29d9 24
28ee95bc 25XXX Any important notices here
12ea29d9 26
28ee95bc 27=head1 Core Enhancements
12ea29d9 28
28ee95bc
SH
29XXX New core language features go here. Summarize user-visible core language
30enhancements. Particularly prominent performance optimisations could go
31here, but most should go in the L</Performance Enhancements> section.
12ea29d9 32
28ee95bc 33[ List each enhancement as a =head2 entry ]
12ea29d9 34
05d9825a
FC
35=head2 $a and $b warnings exemption
36
37The special variables $a and $b, used in C<sort>, are now exempt from "used
38once" warnings, even where C<sort> is not used. This makes it easier for
39CPAN modules to provide functions using $a and $b for similar purposes.
40[perl #120462]
41
28ee95bc 42=head1 Security
eedb00fa 43
28ee95bc
SH
44XXX Any security-related notices go here. In particular, any security
45vulnerabilities closed should be noted here rather than in the
46L</Selected Bug Fixes> section.
eedb00fa 47
28ee95bc 48[ List each security issue as a =head2 entry ]
eedb00fa 49
ba03bc34 50=head1 Incompatible Changes
a3fb66a4 51
28ee95bc 52XXX For a release on a stable branch, this section aspires to be:
29b43da2 53
28ee95bc
SH
54 There are no changes intentionally incompatible with 5.XXX.XXX
55 If any exist, they are bugs, and we request that you submit a
56 report. See L</Reporting Bugs> below.
8c24c1f7 57
28ee95bc 58[ List each incompatible change as a =head2 entry ]
6ffbec2c 59
28ee95bc 60=head1 Deprecations
6ffbec2c 61
28ee95bc 62XXX Any deprecated features, syntax, modules etc. should be listed here.
d5dcec3a 63
28ee95bc 64=head2 Module removals
6ffbec2c 65
28ee95bc 66XXX Remove this section if inapplicable.
5565c738 67
28ee95bc
SH
68The following modules will be removed from the core distribution in a
69future release, and will at that time need to be installed from CPAN.
70Distributions on CPAN which require these modules will need to list them as
71prerequisites.
1944fb52 72
28ee95bc
SH
73The core versions of these modules will now issue C<"deprecated">-category
74warnings to alert you to this fact. To silence these deprecation warnings,
75install the modules in question from CPAN.
1944fb52 76
28ee95bc
SH
77Note that these are (with rare exceptions) fine modules that you are encouraged
78to continue to use. Their disinclusion from core primarily hinges on their
79necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
80not usually on concerns over their design.
1944fb52 81
28ee95bc 82=over
1981f814 83
23b56f29 84=item L<Package::Constants>
1981f814 85
28ee95bc 86=back
229563a9 87
28ee95bc 88[ List each other deprecation as a =head2 entry ]
82107948 89
28ee95bc 90=head1 Performance Enhancements
f90332ac 91
28ee95bc
SH
92XXX Changes which enhance performance without changing behaviour go here.
93There may well be none in a stable release.
f90332ac 94
28ee95bc 95[ List each enhancement as a =item entry ]
f90332ac 96
28ee95bc 97=over 4
f90332ac
SH
98
99=item *
100
3a4b75f8
FC
101Constant hash key lookups (C<$hash{key}> as opposed to C<$hash{$key}>) have
102long had the internal hash value computed at compile time, to speed up
103lookup. This optimisation has only now been applied to hash slices as
104well.
f90332ac 105
28ee95bc 106=back
f90332ac 107
28ee95bc 108=head1 Modules and Pragmata
f90332ac 109
28ee95bc
SH
110XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
111go here. If Module::CoreList is updated, generate an initial draft of the
112following sections using F<Porting/corelist-perldelta.pl>, which prints stub
113entries to STDOUT. Results can be pasted in place of the '=head2' entries
114below. A paragraph summary for important changes should then be added by hand.
115In an ideal world, dual-life modules would have a F<Changes> file that could be
116cribbed.
f90332ac 117
28ee95bc 118[ Within each section, list entries as a =item entry ]
f90332ac 119
28ee95bc 120=head2 New Modules and Pragmata
f90332ac 121
28ee95bc 122=over 4
f90332ac
SH
123
124=item *
125
28ee95bc 126XXX
f90332ac 127
28ee95bc 128=back
f90332ac 129
28ee95bc 130=head2 Updated Modules and Pragmata
f90332ac 131
28ee95bc 132=over 4
f90332ac
SH
133
134=item *
135
033960a1
FC
136L<B> has been upgraded from version 1.46 to 1.47.
137
138C<< B::PMOP->precomp >> now preserves the internal UTF8 flag correctly, so
139chr 256 remains chr 256, instead of turning into "\xc4\x80". This allows
140L<B::Deparse> to deparse Unicode regular expression correctly.
141[perl #120182]
142
ea3da4ad
TC
143C<< B::HV->ARRAY >> now preserves the UTF8 flag on returned hash keys.
144[perl #120535]
145
033960a1
FC
146=item *
147
23d5aa59
FC
148L<B::Concise> has been upgraded from version 0.99 to 0.991.
149
150B<-debug> output now includes C<op_other> pointers.
151
152=item *
153
3b5f976f
FC
154L<B::Deparse> has been upgraded from version 1.23 to 1.24.
155
156C<s//\(3)/e> is now deparsed in a way that does not issue warnings when
157parsed again. [perl #119807]
158
58731871
FC
159C<glob(my $x)> is now deparsed correctly, rather than as C<< <my $x> >> or
160similar.
161
162C<CORE::glob> is now deparsed correctly with the CORE:: prefix when there
163is a subroutine named "glob".
164
3b5f976f
FC
165=item *
166
12cd6c6b
TC
167L<IO::Select> has been upgraded from version 1.21 to 1.22.
168
169Removing a closed file handle from an IO::Select object now correctly
170updates its internal state and returns the correct value. [perl #75156]
171
172=item *
173
494bd897
SH
174L<Module::CoreList> has been upgraded from version 3.00 to 3.01.
175
176The list of Perl versions covered has been updated.
f90332ac 177
22f9c36a
FC
178=item *
179
f63abf92
FC
180L<PerlIO::scalar> has been upgraded from version 0.17 to 0.18.
181
182A bug fix in 0.17 caused references to be stringified as soon as a handle
183to it was opened, even if it was opened only for reading. It also croaked
184on read-only references. This has been fixed. [perl #119529]
185
186=item *
187
22f9c36a
FC
188L<Tie::StdHandle> has been upgraded from version 4.3 to 4.4.
189
190It no longer prints C<$\> twice. [perl #120202]
191
e61cab1a
FC
192It no longer ignores the offset passed to C<syswrite>.
193
28ee95bc 194=back
f90332ac 195
28ee95bc 196=head2 Removed Modules and Pragmata
f90332ac 197
28ee95bc 198=over 4
f90332ac
SH
199
200=item *
201
28ee95bc 202XXX
f90332ac 203
28ee95bc 204=back
f90332ac 205
28ee95bc 206=head1 Documentation
f90332ac 207
28ee95bc
SH
208XXX Changes to files in F<pod/> go here. Consider grouping entries by
209file and be sure to link to the appropriate page, e.g. L<perlfunc>.
f90332ac 210
28ee95bc 211=head2 New Documentation
82107948 212
28ee95bc 213XXX Changes which create B<new> files in F<pod/> go here.
82107948 214
28ee95bc 215=head3 L<XXX>
d05bf821 216
28ee95bc 217XXX Description of the purpose of the new file here
d05bf821 218
28ee95bc 219=head2 Changes to Existing Documentation
be08498a 220
28ee95bc
SH
221XXX Changes which significantly change existing files in F<pod/> go here.
222However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
223section.
be08498a 224
28ee95bc 225=head3 L<XXX>
be08498a 226
28ee95bc 227=over 4
52102bb4
SH
228
229=item *
230
28ee95bc 231XXX Description of the change here
b7c730ff 232
28ee95bc 233=back
d477c82b 234
28ee95bc 235=head1 Diagnostics
d477c82b 236
28ee95bc
SH
237The following additions or changes have been made to diagnostic output,
238including warnings and fatal error messages. For the complete list of
239diagnostic messages, see L<perldiag>.
d477c82b 240
28ee95bc
SH
241XXX New or changed warnings emitted by the core's C<C> code go here. Also
242include any changes in L<perldiag> that reconcile it to the C<C> code.
f90332ac 243
28ee95bc 244=head2 New Diagnostics
f90332ac 245
28ee95bc
SH
246XXX Newly added diagnostic messages go under here, separated into New Errors
247and New Warnings
f90332ac 248
28ee95bc 249=head3 New Errors
f90332ac 250
28ee95bc 251=over 4
f90332ac
SH
252
253=item *
254
28ee95bc 255XXX L<message|perldiag/"message">
2e0c8515 256
28ee95bc 257=back
2e0c8515 258
28ee95bc 259=head3 New Warnings
b7c730ff 260
28ee95bc 261=over 4
b7c730ff 262
befb5359
SH
263=item *
264
28ee95bc 265XXX L<message|perldiag/"message">
befb5359 266
28ee95bc 267=back
befb5359 268
28ee95bc 269=head2 Changes to Existing Diagnostics
f90332ac 270
28ee95bc 271XXX Changes (i.e. rewording) of diagnostic messages go here
411e93ce 272
28ee95bc 273=over 4
411e93ce
SH
274
275=item *
276
c7a31d00
FC
277L<%%s[%s] in scalar context better written as $%s[%s]|perldiag/"%%s[%s] in scalar context better written as $%s[%s]">:
278
279This warning now occurs for any C<%array[$index]> or C<%hash{key}> known to
280be in scalar context at compile time. Previously it was worded "Scalar
281value %%s[%s] better written as $%s[%s]".
f90332ac 282
28ee95bc 283=back
f90332ac 284
28ee95bc 285=head1 Utility Changes
f90332ac 286
28ee95bc
SH
287XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
288Most of these are built within the directories F<utils> and F<x2p>.
f90332ac 289
28ee95bc
SH
290[ List utility changes as a =head3 entry for each utility and =item
291entries for each change
292Use L<XXX> with program names to get proper documentation linking. ]
f90332ac 293
28ee95bc 294=head3 L<XXX>
8adfd064 295
28ee95bc 296=over 4
8adfd064
SH
297
298=item *
299
28ee95bc 300XXX
f90332ac 301
2d8e8368
SH
302=back
303
28ee95bc 304=head1 Configuration and Compilation
1944fb52 305
28ee95bc
SH
306XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
307go here. Any other changes to the Perl build process should be listed here.
308However, any platform-specific changes should be listed in the
309L</Platform Support> section, instead.
a3fb66a4 310
28ee95bc 311[ List changes as a =item entry ].
7c90aec3
SH
312
313=over 4
314
315=item *
316
28ee95bc 317XXX
7c90aec3
SH
318
319=back
320
28ee95bc 321=head1 Testing
7c90aec3 322
28ee95bc
SH
323XXX Any significant changes to the testing of a freshly built perl should be
324listed here. Changes which create B<new> files in F<t/> go here as do any
325large changes to the testing harness (e.g. when parallel testing was added).
326Changes to existing files in F<t/> aren't worth summarizing, although the bugs
327that they represent may be covered elsewhere.
7c90aec3 328
28ee95bc 329[ List each test improvement as a =item entry ]
2d8e8368
SH
330
331=over 4
332
333=item *
334
768cd72c 335F<ext/File-Find/t/find.t> has been converted from manual C<print>
eca6f539
JK
336statements to Test::More functions. Each test now has a description.
337[perl #120503]
2d8e8368
SH
338
339=back
340
28ee95bc 341=head1 Platform Support
1981f814 342
28ee95bc 343=head2 New Platforms
2b6950bd 344
28ee95bc 345=over 4
1981f814 346
79a18634 347=item Synology
1981f814 348
79a18634
MB
349Synology ships its NAS boxes with a lean Linux distribution (DSM) on relative
350cheap CPU's (like the Marvell Kirkwood mv6282 - ARMv5tel or Freescale QorIQ
351P1022 ppc - e500v2) not meant for workstations or development. These boxes
352should build now. The basic problems are the non-standard location for tools.
1981f814 353
12dcbffb 354=back
1310e590 355
28ee95bc 356=head2 Discontinued Platforms
a34da6c4 357
28ee95bc 358XXX List any platforms that this version of perl no longer compiles on.
ef947715 359
12dcbffb 360=over 4
21c01741 361
28ee95bc 362=item XXX-some-platform
467582e8 363
28ee95bc 364XXX
467582e8 365
ba03bc34 366=back
64da853d 367
28ee95bc 368=head2 Platform-Specific Notes
40d779aa 369
28ee95bc
SH
370XXX List any changes for specific platforms. This could include configuration
371and compilation changes or changes in portability/compatibility. However,
372changes within modules for platforms should generally be listed in the
373L</Modules and Pragmata> section.
40d779aa 374
28ee95bc 375=over 4
40d779aa 376
3e7c2d43
SH
377=item Windows
378
379Support for building with Visual C++ 2013 has been added. There are currently
380two possible test failures (see L<perlwin32/"Testing Perl on Windows">) which
381will hopefully be resolved soon.
382
f4a01e9c 383=item WinCE
40d779aa 384
f4a01e9c
SH
385Perl can now be built in one shot with no user intervention on WinCE by running
386C<nmake -f Makefile.ce all>.
387
388Support for building with EVC (Embedded Visual C++) 4 has been restored. Perl
389can also be built using Smart Devices for Visual C++ 2005 or 2008.
eaed284b 390
ba03bc34 391=back
0335212c 392
28ee95bc 393=head1 Internal Changes
0335212c 394
28ee95bc
SH
395XXX Changes which affect the interface available to C<XS> code go here. Other
396significant internal changes for future core maintainers should be noted as
397well.
398
399[ List each change as a =item entry ]
ee818f56 400
09f4604f 401=over 4
efcbb8b2 402
28ee95bc 403=item *
846aaad8 404
3895ffc7
FC
405Compiling with C<-Accflags=-PERL_BOOL_AS_CHAR> now allows C99 and C++
406compilers to emulate the aliasing of C<bool> to C<char> that perl does for
407C89 compilers. [perl #120314]
846aaad8 408
ba03bc34 409=back
efcbb8b2 410
ba03bc34 411=head1 Selected Bug Fixes
912a9a8f 412
28ee95bc
SH
413XXX Important bug fixes in the core language are summarized here. Bug fixes in
414files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
1144b44d 415
28ee95bc 416[ List each fix as a =item entry ]
1144b44d 417
28ee95bc 418=over 4
04380912
SH
419
420=item *
421
894b53fb
FC
422Perl 5.18.0 accidentally disallowed C<-bareword> under C<use strict> and
423C<use integer>. This has been fixed. [perl #120288]
508c1ff6 424
10513103
FC
425=item *
426
427C<-a> at the start of a line (or a hyphen with any single letter that is
428not a filetest operator) no longer produces an erroneous 'Use of "-a"
429without parentheses is ambiguous' warning. [perl #120288]
430
7269fba0
FC
431=item *
432
433Lvalue context is now properly propagated into bare blocks and C<if> and
434C<else> blocks in lvalue subroutines. Previously, arrays and hashes would
435sometimes incorrectly be flattened when returned in lvalue list context, or
436"Bizarre copy" errors could occur. [perl #119797]
437
9deee734
FC
438=item *
439
440Lvalue context is now propagated to the branches of C<||> and C<&&> (and
441their alphabetic equivalents, C<or> and C<and>). This means
442C<foreach (pos $x || pos $y) {...}> now allows C<pos> to be modified
443through $_.
444
9b3f1466
FC
445=item *
446
447C<*DB::DB = sub {} if 0> no longer stops Perl's debugging mode from finding
448C<DB::DB> subs declared thereafter.
449
fafe36c8
FC
450=item *
451
a766e67d
FC
452C<stat> and C<readline> remember the last handle used; the former
453for the special C<_> filehandle, the latter for C<${^LAST_FH}>.
454C<eval "*foo if 0"> where *foo was the last handle passed to C<stat>
455or C<readline> could cause that handle to be forgotten if the
fafe36c8
FC
456handle were not opened yet. This has been fixed.
457
326cf246
FC
458=item *
459
460Various cases of C<delete $::{a}>, C<delete $::{ENV}> etc. causing a crash
461have been fixed. [perl #54044]
462
336b9946
FC
463=item *
464
465Assigning another typeglob to C<*^R> no longer makes the regular expression
466engine crash.
467
e4e776a2
FC
468=item *
469
470C<%{'_<...'}> hashes now set breakpoints on the corresponding C<@{'_<...'}>
471rather than whichever array C<@DB::dbline> is aliased to. [perl #119799]
472
d4fec79a
FC
473=item *
474
475Setting C<$!> to EACCESS before calling C<require> could affect
476C<require>'s behaviour. This has been fixed.
477
b34b8721
FC
478=item *
479
480The "Can't use \1 to mean $1 in expression" warning message now only occurs
481on the right-hand (replacement) part of a substitution. Formerly it could
482happen in code embedded in the left-hand side, or in any other quote-like
483operator.
484
73f74d29
FC
485=item *
486
487The C<\N> regular expression escape, when used without the curly braces (to
488mean C<[^\n]>), was ignoring a following C<*> if followed by whitespace
489under /x. It had been this way since C<\N> to mean C<[^\n]> was introduced
490in 5.12.0.
491
49c74b45
FC
492=item *
493
494Blessing into a reference (C<bless $thisref, $thatref>) has long been
495disallowed, but magical scalars for the second like C<$/> and those tied
496were exempt. They no longer are. [perl #119809]
497
3db3aac2
FC
498=item *
499
500Blessing into a reference was accidentally allowed in 5.18 if the class
501argument were a blessed reference with stale method caches (i.e., whose
502class had had subs defined since the last method call). They are
503disallowed once more, as in 5.16.
504
1859dc90
FC
505=item *
506
507An undefined lexical sub used as an inherited method no longer crashes.
508
ed935cbf
FC
509=item *
510
511C<< $x->{key} >> where $x was declared as C<my Class $x> no longer crashes
512if a Class::FIELDS subroutine stub has been declared.
513
62ab5032
FC
514=item *
515
516C<@$obj{'key'}> and C<${$obj}{key}> used to be exempt from compile-time
517field checking ("No such class field"; see L<fields>) but no longer are.
518
ec52a187
FC
519=item *
520
79b30ab2
FC
521That compile-time field checking also applies now to the C<%$obj{'key'}>
522syntax, added recently in Perl 5.19.4.
523
524=item *
525
ec52a187
FC
526A nonexistent array element with a large index passed to a subroutine that
527ties the array and then tries to access the element no longer results in a
528crash.
529
d84b9c6a
FC
530=item *
531
532Declaring a subroutine stub named NEGATIVE_INDICES no longer makes negative
533array indices crash when the current package is a tied array class.
534
c9a5c63e
FC
535=item *
536
537Declaring a C<require>, C<glob>, or C<do> subroutine stub in the
538CORE::GLOBAL:: package no longer makes compilation of calls to the
539corresponding functions crash.
540
4105c9c0
FC
541=item *
542
543Aliasing CORE::GLOBAL:: functions to constants stopped working in Perl 5.10
544but has now been fixed.
545
ec636b69
FC
546=item *
547
548When C<`...`> or C<qx/.../> calls a C<readpipe> override, double-quotish
549interpolation now happens, as is the case when there is no override.
550Previously, the presence of an override would make these quote-like
551operators act like C<q{}>, suppressing interpolation. [perl #115330]
552
553=item *
554
555C<<<`...`> here-docs (with backticks as the delimiters) now call
556C<readpipe> overrides. [perl #119827]
557
a7b82b2f
FC
558=item *
559
560The presence of a lexical sub named "CORE" no longer stops the CORE::
561prefix from working.
562
03b7e81e
FC
563=item *
564
565C<&CORE::exit()> and C<&CORE::die()> now respect L<vmsish> hints.
566
d0fcfa00
FC
567=item *
568
569Undefining a glob that triggers a DESTROY method that undefines the same
570glob is now safe. It used to produce "Attempt to free unreferenced glob
571pointer" warnings and leak memory.
572
424623a2
FC
573=item *
574
575If subroutine redefinition (C<eval 'sub foo{}'> or C<newXS> for XS code)
576triggers a DESTROY method on the sub that is being redefined, and that
577method assigns a subroutine to the same slot (C<*foo = sub {}>), C<$_[0]>
e2aa288a
FC
578is no longer left pointing to a freed scalar. Now DESTROY is delayed until
579the new subroutine has been installed.
424623a2 580
812998f1
FC
581=item *
582
583C<s///>, C<tr///> and C<y///> now work when a wide character is used as the
584delimiter. [perl #120463]
585
28ee95bc 586=back
508c1ff6 587
28ee95bc 588=head1 Known Problems
7492c6c5 589
28ee95bc
SH
590XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
591tests that had to be C<TODO>ed for the release would be noted here. Unfixed
592platform specific bugs also go here.
254a1e67 593
28ee95bc 594[ List each fix as a =item entry ]
254a1e67 595
28ee95bc 596=over 4
254a1e67
SH
597
598=item *
599
a7b82b2f
FC
600C<do CORE()> used to call a sub named "CORE" and treat its return value as
601a file name to execute. A bug fix inadvertently caused it to be
602interpreted as the deprecated "do-SUB" construct. (Yes, C<do
603I<bareword>()> is inconsistent.) This will likely be changed back.
7492c6c5 604
09f4604f 605=back
cfbe45f9 606
28ee95bc 607=head1 Obituary
c84b5497 608
28ee95bc
SH
609XXX If any significant core contributor has died, we've added a short obituary
610here.
c84b5497 611
28ee95bc 612=head1 Acknowledgements
c84b5497 613
28ee95bc 614XXX Generate this with:
c84b5497 615
28ee95bc 616 perl Porting/acknowledgements.pl v5.19.5..HEAD
f5b73711 617
44691e6f
AB
618=head1 Reporting Bugs
619
e08634c5
SH
620If you find what you think is a bug, you might check the articles recently
621posted to the comp.lang.perl.misc newsgroup and the perl bug database at
622http://rt.perl.org/perlbug/ . There may also be information at
623http://www.perl.org/ , the Perl Home Page.
44691e6f 624
e08634c5
SH
625If you believe you have an unreported bug, please run the L<perlbug> program
626included with your release. Be sure to trim your bug down to a tiny but
627sufficient test case. Your bug report, along with the output of C<perl -V>,
628will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
629
630If the bug you are reporting has security implications, which make it
e08634c5
SH
631inappropriate to send to a publicly archived mailing list, then please send it
632to perl5-security-report@perl.org. This points to a closed subscription
633unarchived mailing list, which includes all the core committers, who will be
634able to help assess the impact of issues, figure out a resolution, and help
f9001595 635co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
636platforms on which Perl is supported. Please only use this address for
637security issues in the Perl core, not for modules independently distributed on
638CPAN.
44691e6f
AB
639
640=head1 SEE ALSO
641
e08634c5
SH
642The F<Changes> file for an explanation of how to view exhaustive details on
643what changed.
44691e6f
AB
644
645The F<INSTALL> file for how to build Perl.
646
647The F<README> file for general stuff.
648
649The F<Artistic> and F<Copying> files for copyright information.
650
651=cut