This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Upgrade Socket from 2.002 to 2.003
[perl5.git] / pod / perldelta.pod
CommitLineData
44691e6f
AB
1=encoding utf8
2
3=head1 NAME
4
e08634c5
SH
5[ this is a template for a new perldelta file. Any text flagged as XXX needs
6to be processed before release. ]
417a992d 7
4eabcf70 8perldelta - what is new for perl v5.17.3
e128ab2c 9
4eabcf70 10=head1 DESCRIPTION
6db9054f 11
e08634c5
SH
12This document describes differences between the 5.17.2 release and the 5.17.3
13release.
6db9054f 14
4eabcf70 15If you are upgrading from an earlier release such as 5.17.1, first read
e08634c5 16L<perl5172delta>, which describes differences between 5.17.1 and 5.17.2.
ef7131e9 17
4eabcf70 18=head1 Notice
ff3f295c 19
4eabcf70 20XXX Any important notices here
95c6c5c5 21
4eabcf70 22=head1 Core Enhancements
95c6c5c5 23
e08634c5
SH
24XXX New core language features go here. Summarize user-visible core language
25enhancements. Particularly prominent performance optimisations could go
4eabcf70 26here, but most should go in the L</Performance Enhancements> section.
4c77591b 27
4eabcf70 28[ List each enhancement as a =head2 entry ]
c506fc7e 29
6ed07037
FC
30=head2 Computed Labels
31
32The loop controls C<next>, C<last> and C<redo>, and the special C<dump>
33operator, now allow arbitrary expressions to be used to compute labels at
34run time. Previously, any argument that was not a constant was treated as
35the empty string.
36
4eabcf70 37=head1 Security
36ab1671 38
4eabcf70
TC
39XXX Any security-related notices go here. In particular, any security
40vulnerabilities closed should be noted here rather than in the
41L</Selected Bug Fixes> section.
36ab1671 42
4eabcf70 43[ List each security issue as a =head2 entry ]
36ab1671 44
4eabcf70 45=head1 Incompatible Changes
df2c1bb8 46
613c63b4 47[ List each incompatible change as a =head2 entry ]
df2c1bb8 48
e146574a 49=head2 C<$ENV{foo}=undef> deletes value from environ, like C<delete $ENV{foo}>
df2c1bb8 50
613c63b4
CS
51This facilitates use of C<local()> with C<%ENV> entries. In previous
52versions of Perl, C<undef> was converted to the empty string.
53
54=head2 Defined values stored in environment are forced to byte strings
55
56A value stored in an environment variable has always been stringified. In
57this release, it is converted to be only a byte string. First, it is forced
58to be a only a string. Then if the string is utf8 and the equivalent of
9c5f5e7a
SH
59C<utf8::downgrade()> works, that result is used; otherwise, the equivalent of
60C<utf8::encode()> is used, and a warning is issued about wide characters
613c63b4 61(L</Diagnostics>).
7ab2ea42 62
9c5f5e7a 63=head2 C<given> now aliases the global C<$_>
e7d41eaa 64
9c5f5e7a
SH
65Instead of assigning to an implicit lexical C<$_>, C<given> now makes the
66global C<$_> an alias for its argument, just like C<foreach>. However, it
67still uses lexical C<$_> if there is lexical C<$_> in scope (again, just like
e7d41eaa
FC
68C<foreach>).
69
4eabcf70 70=head1 Deprecations
7ab2ea42 71
e08634c5
SH
72XXX Any deprecated features, syntax, modules etc. should be listed here. In
73particular, deprecated modules should be listed here even if they are listed as
74an updated module in the L</Modules and Pragmata> section.
7ab2ea42 75
4eabcf70 76[ List each deprecation as a =head2 entry ]
7ab2ea42 77
4eabcf70 78=head1 Performance Enhancements
3be135d8 79
e08634c5
SH
80XXX Changes which enhance performance without changing behaviour go here.
81There may well be none in a stable release.
3be135d8 82
4eabcf70 83[ List each enhancement as a =item entry ]
6db9054f 84
4eabcf70 85=over 4
6db9054f 86
7ca04d94
TC
87=item *
88
4eabcf70 89XXX
7ca04d94 90
e96e0834 91=back
c506fc7e 92
4eabcf70 93=head1 Modules and Pragmata
95c6c5c5 94
4eabcf70
TC
95XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
96go here. If Module::CoreList is updated, generate an initial draft of the
97following sections using F<Porting/corelist-perldelta.pl>, which prints stub
98entries to STDOUT. Results can be pasted in place of the '=head2' entries
99below. A paragraph summary for important changes should then be added by hand.
100In an ideal world, dual-life modules would have a F<Changes> file that could be
101cribbed.
95c6c5c5 102
4eabcf70
TC
103[ Within each section, list entries as a =item entry ]
104
105=head2 New Modules and Pragmata
95c6c5c5 106
e96e0834 107=over 4
95c6c5c5
JL
108
109=item *
110
4eabcf70 111XXX
95c6c5c5 112
e96e0834 113=back
95c6c5c5 114
4eabcf70 115=head2 Updated Modules and Pragmata
95c6c5c5 116
e96e0834 117=over 4
95c6c5c5 118
95c6c5c5
JL
119=item *
120
9c5f5e7a
SH
121L<B> has been upgraded from version 1.36 to 1.37. All C<CVf_*> and C<GVf_*>
122and more SV-related flag values are now provided as constants in the C<B::>
123namespace and available for export. The default export list has not changed.
124
125=item *
126
014bf826 127L<B::Concise> has been upgraded from version 0.91 to 0.92. The C<-nobanner>
ed2b0264
SH
128option has been fixed, and C<format>s can now be dumped. When passed a sub
129name to dump, it will check also to see whether it is the name of a format. If
130a sub and a format share the same name, it will dump both.
e4afdb79 131
32ed16fc
FC
132=item *
133
134L<B::Deparse> has been upgraded from version 1.15 to 1.16. It now deparses
014bf826
SH
135loop controls with the correct precedence, and multiple statements in a
136C<format> line are also now deparsed correctly.
32ed16fc 137
63870e6d
FC
138=item *
139
014bf826
SH
140L<Compress::Raw::Bzip2> has been upgraded from version 2.05201 to 2.055. The
141misuse of Perl's "magic" API has been fixed.
9c5f5e7a
SH
142
143=item *
144
014bf826
SH
145L<Compress::Raw::Zlib> has been upgraded from version 2.05401 to 2.056. The
146misuse of Perl's "magic" API has been fixed.
9c5f5e7a
SH
147
148=item *
149
014bf826
SH
150L<Compress::Zlib> has been upgraded from version 2.052 to 2.055.
151C<compress()>, C<uncompress()>, C<memGzip()> and C<memGunzip()> have been
152speeded up by making parameter validation more efficient.
afae8808
SH
153
154=item *
155
9c5f5e7a
SH
156L<Data::Dumper> has been upgraded from version 2.135_06 to 2.135_07. It has
157been optimized to only build a seen-scalar hash as necessary, thereby speeding
158up serialization drastically.
159
160=item *
161
e146574a
SH
162L<Devel::Peek> has been upgraded from version 1.08 to 1.09. The only change
163has been to the test script, to account for changes to some flags in perl's
014bf826 164internals.
9c5f5e7a
SH
165
166=item *
167
fd172611 168L<Encode> has been upgraded from version 2.44 to 2.47. The Mac alias x-mac-ce
c856fe35
SH
169has been added, and various bugs have been fixed in Encode::Unicode,
170Encode::UTF7 and Encode::GSM0338.
9c5f5e7a
SH
171
172=item *
173
e146574a
SH
174L<Module::Build> has been upgraded from version 0.40 to 0.4002. A minor bug
175fix allows markup to be used around the leading "Name" in a POD "abstract"
176line, and some documentation improvements have been made.
9c5f5e7a
SH
177
178=item *
179
014bf826
SH
180L<Module::CoreList> has been upgraded from version 2.69 to 2.70. Version
181information is now stored as a delta, which greatly reduces the size of the
182F<CoreList.pm> file.
9c5f5e7a
SH
183
184=item *
185
014bf826
SH
186L<Module::Load::Conditional> has been upgraded from version 0.50 to 0.54.
187Various enhancements include the new use of Module::Metadata.
9c5f5e7a
SH
188
189=item *
190
014bf826 191L<Module::Metadata> has been upgraded from version 1.000009 to 1.000010. The
e146574a
SH
192creation of a Module::Metadata object for a typical module file has been sped
193up by about 40%.
9c5f5e7a
SH
194
195=item *
196
521f5ac7
SH
197L<Module::Pluggable> has been upgraded from version 4.0 to 4.2. Amongst other
198changes, triggers are now allowed on events, which gives a powerful way to
199modify behaviour.
ed2b0264
SH
200
201=item *
202
0ace302a
SH
203L<Pod::Simple> has been upgraded from version 3.20 to 3.23. Numerous
204improvements have been made, mostly to Pod::Simple::XHTML, which also has a
205compatibility change: the C<codes_in_verbatim> option is now disabled by
206default. See F<cpan/Pod-Simple/ChangeLog> for the full details.
207
208=item *
209
014bf826
SH
210L<re> has been upgraded from version 0.21 to 0.22. Single character [class]es
211like C</[s]/> or C</[s]/i> are now optimized as if they did not have the
212brackets, i.e. C</s/> or C</s/i>.
9c5f5e7a
SH
213
214=item *
215
d4ada64a
SH
216L<Socket> has been upgraded from version 2.002 to 2.003. Constants and
217functions required for IP multicast source group membership have been added.
218
219=item *
220
63870e6d
FC
221L<Storable> has been upgraded from version 2.37 to 2.38. It can now freeze
222and thaw vstrings correctly. This causes a slight incompatible change in
223the storage format, so the format version has increased to 2.9.
224
930a023a
SM
225=item *
226
33f804f6
SH
227L<Sys::Syslog> has been upgraded from version 0.29 to 0.30. An issue with
228C<POSIX::strftime()> on Windows and a build problem on Haiku-OS have been
229resolved, and <getservbyname()> is no longer called when the port is specified.
230
231=item *
232
014bf826
SH
233L<Time::Local> has been upgraded from version 1.2000 to 1.2300. Seconds values
234greater than 59 but less than 60 no longer cause C<timegm()> and C<timelocal()>
235to croak.
9c5f5e7a
SH
236
237=item *
238
014bf826
SH
239L<Unicode::UCD> has been upgraded from version 0.44 to 0.45. This has been
240modified slightly for reasons of perl internal use only.
9c5f5e7a
SH
241
242=item *
243
44db8156 244L<Win32> has been upgraded from version 0.44 to 0.45. New APIs have been added
ed2b0264 245for getting and setting the current code page.
44db8156
SH
246
247=item *
248
014bf826
SH
249L<Win32CORE> has been upgraded from version 0.02 to 0.03. The use of
250PERL_NO_GET_CONTEXT here has resulted in smaller machine code.
4f85bc45 251
4eabcf70 252=back
72267260 253
4eabcf70 254=head1 Documentation
72267260 255
e08634c5
SH
256XXX Changes to files in F<pod/> go here. Consider grouping entries by file and
257be sure to link to the appropriate page, e.g. L<perlfunc>.
4f85bc45 258
4eabcf70 259=head2 New Documentation
7d101ed1 260
4eabcf70 261XXX Changes which create B<new> files in F<pod/> go here.
e013ada0 262
4eabcf70 263=head3 L<XXX>
4f85bc45 264
4eabcf70 265XXX Description of the purpose of the new file here
e013ada0 266
4eabcf70 267=head2 Changes to Existing Documentation
95c6c5c5 268
4eabcf70
TC
269XXX Changes which significantly change existing files in F<pod/> go here.
270However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
271section.
95c6c5c5 272
be28af6e 273=head3 L<perlfunc>, L<perlop>
95c6c5c5 274
e96e0834 275=over 4
95c6c5c5
JL
276
277=item *
278
be28af6e
FC
279Loop control verbs (C<dump>, C<goto>, C<next>, C<last> and C<redo>) have
280always had the same precedence as assignment operators, but this was never
281documented until now.
95c6c5c5 282
e96e0834 283=back
95c6c5c5 284
4eabcf70 285=head1 Diagnostics
05c8f9ed 286
4eabcf70
TC
287The following additions or changes have been made to diagnostic output,
288including warnings and fatal error messages. For the complete list of
289diagnostic messages, see L<perldiag>.
ceb0881c 290
e08634c5 291XXX New or changed warnings emitted by the core's C<C> code go here. Also
4eabcf70 292include any changes in L<perldiag> that reconcile it to the C<C> code.
0998713f 293
4eabcf70 294=head2 New Diagnostics
42d72fc5 295
e08634c5
SH
296XXX Newly added diagnostic messages go under here, separated into New Errors
297and New Warnings
613c63b4 298
4eabcf70 299=head3 New Errors
8e125188 300
e96e0834 301=over 4
e128ab2c 302
e2f0c3bb
FC
303=item *
304
08b2a930
FC
305L<Unterminated delimiter for here document|perldiag/"Unterminated delimiter for here document">
306
9c5f5e7a
SH
307This message now occurs when a here document label has an initial quotation
308mark but the final quotation mark is missing.
08b2a930
FC
309
310This replaces a bogus and misleading error message about not finding the
311label itself [perl #114104].
16e4fcbf 312
4eabcf70 313=back
e2f0c3bb 314
4eabcf70 315=head3 New Warnings
90519d0f 316
4eabcf70 317=over 4
90519d0f
FC
318
319=item *
320
afae8808 321L<Wide character in setenv|perldiag/"Wide character in %s">
e08634c5
SH
322
323Attempts to put wide characters into environment variables via C<%ENV> now
324provoke this warning.
90519d0f 325
61174fb5 326=back
422287bf 327
4eabcf70
TC
328=head2 Changes to Existing Diagnostics
329
330XXX Changes (i.e. rewording) of diagnostic messages go here
2de6ba8d 331
e128ab2c
DM
332=over 4
333
334=item *
335
4eabcf70 336XXX Describe change here
e128ab2c 337
4eabcf70 338=back
8b1adbab 339
4eabcf70 340=head1 Utility Changes
8b1adbab 341
e08634c5
SH
342XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
343Most of these are built within the directories F<utils> and F<x2p>.
83f29afa 344
4eabcf70
TC
345[ List utility changes as a =head3 entry for each utility and =item
346entries for each change
347Use L<XXX> with program names to get proper documentation linking. ]
83f29afa 348
4eabcf70 349=head3 L<XXX>
0938f143 350
4eabcf70 351=over 4
0938f143 352
72267260
JL
353=item *
354
4eabcf70 355XXX
7a251f7a 356
4eabcf70 357=back
7a251f7a 358
4eabcf70 359=head1 Configuration and Compilation
21247d85 360
4eabcf70
TC
361XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
362go here. Any other changes to the Perl build process should be listed here.
363However, any platform-specific changes should be listed in the
364L</Platform Support> section, instead.
21247d85 365
4eabcf70 366[ List changes as a =item entry ].
2e4f8b82 367
4eabcf70 368=over 4
c95d4104 369
788505db
FC
370=item *
371
4eabcf70 372XXX
788505db 373
4eabcf70 374=back
2c2b9cf4 375
4eabcf70 376=head1 Testing
3cd56aaa 377
4eabcf70
TC
378XXX Any significant changes to the testing of a freshly built perl should be
379listed here. Changes which create B<new> files in F<t/> go here as do any
380large changes to the testing harness (e.g. when parallel testing was added).
e08634c5 381Changes to existing files in F<t/> aren't worth summarizing, although the bugs
4eabcf70 382that they represent may be covered elsewhere.
3cd56aaa 383
4eabcf70 384[ List each test improvement as a =item entry ]
3cd56aaa 385
4eabcf70 386=over 4
3cd56aaa
TC
387
388=item *
389
4eabcf70 390XXX
3cd56aaa 391
4eabcf70 392=back
3cd56aaa 393
4eabcf70 394=head1 Platform Support
3cd56aaa 395
4eabcf70 396XXX Any changes to platform support should be listed in the sections below.
3cd56aaa 397
4eabcf70
TC
398[ Within the sections, list each platform as a =item entry with specific
399changes as paragraphs below it. ]
3cd56aaa 400
4eabcf70 401=head2 New Platforms
3cd56aaa 402
4eabcf70 403XXX List any platforms that this version of perl compiles on, that previous
e08634c5 404versions did not . These will either be enabled by new files in the F<hints/>
4eabcf70
TC
405directories, or new subdirectories and F<README> files at the top level of the
406source tree.
3cd56aaa 407
4eabcf70 408=over 4
3cd56aaa 409
4eabcf70 410=item XXX-some-platform
3cd56aaa 411
4eabcf70 412XXX
c0c19433 413
4eabcf70 414=back
c0c19433 415
4eabcf70 416=head2 Discontinued Platforms
7ab2ea42 417
4eabcf70 418XXX List any platforms that this version of perl no longer compiles on.
7ab2ea42 419
4eabcf70 420=over 4
7ab2ea42 421
4eabcf70 422=item XXX-some-platform
7ab2ea42 423
4eabcf70 424XXX
90519d0f 425
4eabcf70 426=back
90519d0f 427
4eabcf70 428=head2 Platform-Specific Notes
90519d0f 429
e08634c5 430XXX List any changes for specific platforms. This could include configuration
4eabcf70
TC
431and compilation changes or changes in portability/compatibility. However,
432changes within modules for platforms should generally be listed in the
433L</Modules and Pragmata> section.
90519d0f 434
4eabcf70 435=over 4
90519d0f 436
4eabcf70 437=item XXX-some-platform
90519d0f 438
4eabcf70 439XXX
90519d0f 440
4eabcf70 441=back
90519d0f 442
4eabcf70 443=head1 Internal Changes
90519d0f 444
e08634c5
SH
445XXX Changes which affect the interface available to C<XS> code go here. Other
446significant internal changes for future core maintainers should be noted as
447well.
90519d0f 448
4eabcf70 449[ List each change as a =item entry ]
90519d0f 450
4eabcf70 451=over 4
90519d0f
FC
452
453=item *
454
4eabcf70 455XXX
90519d0f 456
4eabcf70 457=back
90519d0f 458
4eabcf70 459=head1 Selected Bug Fixes
90519d0f 460
e08634c5
SH
461XXX Important bug fixes in the core language are summarized here. Bug fixes in
462files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
90519d0f 463
4eabcf70 464[ List each fix as a =item entry ]
90519d0f 465
4eabcf70 466=over 4
90519d0f
FC
467
468=item *
469
7a4d6ad6
KW
470C<\w> now matches the code points U+200C (ZERO WIDTH NON-JOINER) and
471U+200D (ZERO WIDTH JOINER). C<\W> no longer matches these. This change
472is because Unicode corrected their definition of what C<\w> should match.
90519d0f 473
77f5d539
FC
474=item *
475
476C<dump LABEL> no longer leaks its label.
477
3e81bef2
FC
478=item *
479
9c5f5e7a
SH
480Constant folding no longer changes the behaviour of functions like C<stat()>
481and C<truncate()> that can take either filenames or handles.
3e81bef2
FC
482C<stat 1 ? foo : bar> nows treats its argument as a file name (since it is
483an arbitrary expression), rather than the handle "foo".
484
e9f497c4
FC
485=item *
486
487C<truncate FOO, $len> no longer falls back to treating "FOO" as a file name
488if the filehandle has been deleted. This was broken in Perl 5.16.0.
489
d7f7c515
FC
490=item *
491
492Subroutine redefinitions after sub-to-glob and glob-to-glob assignments no
493longer cause double frees or panic messages.
494
afc04f16
FC
495=item *
496
497C<s///> now turns vstrings into plain strings when performing a
498substitution, even if the resulting string is the same (C<s/a/a/>).
499
b4cf37f5
FC
500=item *
501
502Prototype mismatch warnings no longer erroneously treat constant subs as
503having no prototype when they actually have "".
504
505=item *
506
507Constant subroutines and forward declarations no longer prevent prototype
508mismatch warnings from omitting the sub name.
509
ea9f761d
FC
510=item *
511
512C<undef> on a subroutine now clears call checkers.
513
70306497
FC
514=item *
515
516The C<ref> operator started leaking memory on blessed objects in Perl
5175.16.0. This has been fixed [perl #114340].
518
63164165
FC
519=item *
520
521C<use> no longer tries to parse its arguments as a statement, making
522C<use constant { () };> a syntax error [perl #114222].
523
9da700a7
FC
524=item *
525
526On debugging builds, "uninitialized" warnings inside formats no longer
527cause assertion failures.
528
9702222b
FC
529=item *
530
e4963eb6
FC
531On debugging builds, subroutines nested inside formats no longer cause
532assertion failures [perl #78550].
533
534=item *
535
9702222b
FC
536C<print $x> and C<sub { print $x }->()> now always produce the same output.
537It was possible for the latter to refuse to close over $x if the variable
538was not active; e.g., if it was defined outside a currently-running named
539subroutine.
540
3e0c76ce
FC
541=item *
542
610c7be4
FC
543Similarly, C<print $x> and C<print eval '$x'> now produce the same output.
544This also allows "my $x if 0" variables to be seen in the debugger
545[perl #114018].
546
547=item *
548
3e0c76ce
FC
549Formats called recursively no longer stomp on their own lexical variables,
550but each recursive call has its own set of lexicals.
551
c58f5a32
FC
552=item *
553
554Attempting to free an active format or the handle associated with it no
555longer results in a crash.
556
a21a3918
FC
557=item *
558
559Format parsing no longer gets confused by braces, semicolons and
560low-precedence operators. It used to be possible to use braces as format
561delimiters (instead of C<=> and C<.>), but only sometimes. Semicolons and
562low-precedence operators in format argument lines no longer confuse the
563parser into ignoring the line's return value. In format argument lines,
564braces can now be used for anonymous hashes, instead of being treated
565always as C<do> blocks.
566
567=item *
568
569Formats can now be nested inside code blocks in regular expressions and
570other quoted constructs (C</(?{...})/> and C<qq/${...}/>) [perl #114040].
571
60ca243a
FC
572=item *
573
574Formats are no longer created after compilation errors.
575
4eabcf70 576=back
90519d0f 577
4eabcf70 578=head1 Known Problems
b8a55fe7 579
e08634c5
SH
580XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
581tests that had to be C<TODO>ed for the release would be noted here. Unfixed
4eabcf70 582platform specific bugs also go here.
b8a55fe7 583
4eabcf70 584[ List each fix as a =item entry ]
b8a55fe7 585
4eabcf70 586=over 4
b8a55fe7
FC
587
588=item *
589
4eabcf70 590XXX
b8a55fe7 591
4eabcf70 592=back
5073ffbd 593
4eabcf70 594=head1 Obituary
5073ffbd 595
4eabcf70
TC
596XXX If any significant core contributor has died, we've added a short obituary
597here.
e128ab2c 598
61174fb5 599=head1 Acknowledgements
d5dc7001 600
4eabcf70
TC
601XXX Generate this with:
602
603 perl Porting/acknowledgements.pl v5.17.2..HEAD
29cf780c 604
44691e6f
AB
605=head1 Reporting Bugs
606
e08634c5
SH
607If you find what you think is a bug, you might check the articles recently
608posted to the comp.lang.perl.misc newsgroup and the perl bug database at
609http://rt.perl.org/perlbug/ . There may also be information at
610http://www.perl.org/ , the Perl Home Page.
44691e6f 611
e08634c5
SH
612If you believe you have an unreported bug, please run the L<perlbug> program
613included with your release. Be sure to trim your bug down to a tiny but
614sufficient test case. Your bug report, along with the output of C<perl -V>,
615will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
44691e6f
AB
616
617If the bug you are reporting has security implications, which make it
e08634c5
SH
618inappropriate to send to a publicly archived mailing list, then please send it
619to perl5-security-report@perl.org. This points to a closed subscription
620unarchived mailing list, which includes all the core committers, who will be
621able to help assess the impact of issues, figure out a resolution, and help
f9001595 622co-ordinate the release of patches to mitigate or fix the problem across all
e08634c5
SH
623platforms on which Perl is supported. Please only use this address for
624security issues in the Perl core, not for modules independently distributed on
625CPAN.
44691e6f
AB
626
627=head1 SEE ALSO
628
e08634c5
SH
629The F<Changes> file for an explanation of how to view exhaustive details on
630what changed.
44691e6f
AB
631
632The F<INSTALL> file for how to build Perl.
633
634The F<README> file for general stuff.
635
636The F<Artistic> and F<Copying> files for copyright information.
637
638=cut