This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Correct pod syntax in perldelta
[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
FR
120
121=head1 Deprecations
122
ee0887a9
SH
123XXX Any deprecated features, syntax, modules etc. should be listed here.
124In particular, deprecated modules should be listed here even if they are
125listed as an updated module in the L</Modules and Pragmata> section.
85318b69 126
ee0887a9 127[ List each deprecation as a =head2 entry ]
4c793fe3
FR
128
129=head1 Performance Enhancements
130
ee0887a9
SH
131XXX Changes which enhance performance without changing behaviour go here. There
132may well be none in a stable release.
4c793fe3 133
ee0887a9 134[ List each enhancement as a =item entry ]
4c793fe3 135
ee0887a9 136=over 4
4c793fe3 137
e2babdfb
FR
138=item *
139
ee0887a9 140XXX
e2babdfb 141
4c793fe3
FR
142=back
143
144=head1 Modules and Pragmata
145
ee0887a9
SH
146XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
147go here. If Module::CoreList is updated, generate an initial draft of the
148following sections using F<Porting/corelist-perldelta.pl>, which prints stub
149entries to STDOUT. Results can be pasted in place of the '=head2' entries
150below. A paragraph summary for important changes should then be added by hand.
151In an ideal world, dual-life modules would have a F<Changes> file that could be
152cribbed.
fc1418b7 153
ee0887a9 154[ Within each section, list entries as a =item entry ]
df91fef1 155
ee0887a9 156=head2 New Modules and Pragmata
ccb45ef4 157
ee0887a9 158=over 4
df91fef1 159
ee0887a9 160=item *
df91fef1 161
ee0887a9 162XXX
e2babdfb 163
ee0887a9 164=back
e2babdfb 165
ee0887a9 166=head2 Updated Modules and Pragmata
fc1418b7 167
ee0887a9 168=over 4
fc1418b7 169
ee0887a9 170=item *
e2babdfb 171
75484d6b
FC
172C<Carp> has been upgraded from version 1.18 to 1.19.
173
174It no longer autovivifies the C<*CORE::GLOBAL::caller> glob, something it
175started doing in 1.18, which was released with perl 5.13.4
176L<[perl #78082]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=78082>
177
178=item *
179
e2941eb0
FC
180C<Data::Dumper> has been upgraded from version 2.128 to 2.129.
181
182C<Dumpxs> no longer crashes with globs returned by C<*$io_ref>
183L<[perl #72332]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=72332>.
184
185=item *
186
62d37bf0
FR
187C<Digest::MD5> has been upgraded from version 2.40 to 2.50.
188
189It is now safe to use this module in combination with threads.
190
191=item *
192
f5b89942
FC
193C<File::DosGlob> has been upgraded from version 1.02 to 1.03.
194
195It allows patterns containing literal parentheses (they no longer need to
196be escaped). On Windows, it no longer adds an extra F<./> to the file names
197returned when the pattern is a relative glob with a drive specification,
6481ebaf
FC
198like F<c:*.pl>
199L<[perl #71712]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=71712>.
f5b89942
FC
200
201=item *
202
4d1599c3
FC
203C<File::Find> has been upgraded from version 1.17 to 1.18.
204
205It improves handling of backslashes on Windows, so that paths such as
6481ebaf
FC
206F<c:\dir\/file> are no longer generated
207L<[perl #71710]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=71710>.
4d1599c3
FC
208
209=item *
210
f1c82292
CBW
211C<if> has been upgraded from version 0.05 to 0.06
212
213=item *
214
25e68b8b
FC
215C<IPC::Open3> has been upgraded from version 1.06 to 1.07.
216
217The internal C<xclose> routine now knows how to handle file descriptors, as
218documented, so duplicating STDIN in a child process using its file
219descriptor now works
220L<[perl #76474]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=71710>.
221
222=item *
223
9607a449
FC
224C<Locale::Maketext> has been upgraded from version 1.15 to 1.16.
225
226It fixes an infinite loop in C<Locale::Maketext::Guts::_compile()> when
227working with tainted values
228(L<CPAN RT #40727|https://rt.cpan.org/Public/Bug/Display.html?id=40727>).
229
230=item *
231
de0e3ce7
FR
232C<NEXT> has been upgraded from version 0.64 to 0.65.
233
234=item *
235
1c2dcb3e
CBW
236C<PathTools> has been upgraded from version 3.31_01 to 3.33.
237
238=item *
239
6481ebaf
FC
240C<sigtrap> has been upgraded from version 1.04 to 1.05.
241
242It no longer tries to modify read-only arguments when generating a
243backtrace
244L<[perl #72340]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=72340>.
245
246=item *
247
1393fe00
CBW
248C<Unicode::Collate> has been upgraded from version 0.59 to 0.60
249
250=item *
251
1c2dcb3e 252C<Unicode::Normalize> has been upgraded from version 1.06 to 1.07
c9a84c8b 253
ee0887a9 254=back
c9a84c8b 255
ee0887a9 256=head2 Removed Modules and Pragmata
c9a84c8b 257
ee0887a9 258=over 4
4c793fe3 259
ee0887a9 260=item *
48c1efd2 261
ee0887a9 262XXX
4c793fe3
FR
263
264=back
265
266=head1 Documentation
267
ee0887a9
SH
268XXX Changes to files in F<pod/> go here. Consider grouping entries by
269file and be sure to link to the appropriate page, e.g. L<perlfunc>.
4c793fe3 270
ee0887a9 271=head2 New Documentation
4c793fe3 272
ee0887a9 273XXX Changes which create B<new> files in F<pod/> go here.
4c793fe3 274
ee0887a9 275=head3 L<XXX>
4c793fe3 276
ee0887a9 277XXX Description of the purpose of the new file here
4c793fe3 278
ee0887a9 279=head2 Changes to Existing Documentation
fc1418b7 280
ee0887a9
SH
281XXX Changes which significantly change existing files in F<pod/> go here.
282However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
283section.
fc1418b7 284
ee0887a9 285=head3 L<XXX>
e2babdfb 286
7bc3efda
SH
287=over 4
288
289=item *
290
a7e93501
FC
291The documentation for the C<SvTRUE> macro was simply wrong in stating that
292get-magic is not processed. It has been corrected.
7bc3efda
SH
293
294=back
e2babdfb 295
4c793fe3
FR
296=head1 Diagnostics
297
298The following additions or changes have been made to diagnostic output,
299including warnings and fatal error messages. For the complete list of
300diagnostic messages, see L<perldiag>.
301
ee0887a9
SH
302XXX New or changed warnings emitted by the core's C<C> code go here. Also
303include any changes in L<perldiag> that reconcile it to the C<C> code.
4c793fe3 304
ee0887a9 305[ Within each section, list entries as a =item entry ]
4c793fe3 306
ee0887a9 307=head2 New Diagnostics
4c793fe3 308
ee0887a9 309XXX Newly added diagnostic messages go here
fc1418b7 310
ee0887a9 311=over 4
fc1418b7
SH
312
313=item *
314
ee0887a9 315XXX
ebce6c40 316
4c793fe3
FR
317=back
318
ee0887a9 319=head2 Changes to Existing Diagnostics
4c793fe3 320
ee0887a9 321XXX Changes (i.e. rewording) of diagnostic messages go here
4c793fe3
FR
322
323=over 4
324
325=item *
326
dc08898c
FC
327The 'Layer does not match this perl' error message has been replaced with
328these more helpful messages:
329
330=over 4
331
332=item *
333
334PerlIO layer function table size (%d) does not match size expected by this
335perl (%d)
336
337=item *
338
339PerlIO layer instance size (%d) does not match size expected by this perl
340(%d)
341
342=back
343
344L<[perl #73754]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=73754>
4c793fe3
FR
345
346=back
347
ee0887a9 348=head1 Utility Changes
4c793fe3 349
ee0887a9
SH
350XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
351here. Most of these are built within the directories F<utils> and F<x2p>.
4c793fe3 352
ee0887a9
SH
353[ List utility changes as a =head3 entry for each utility and =item
354entries for each change
355Use L<XXX> with program names to get proper documentation linking. ]
fc1418b7 356
ee0887a9 357=head3 L<XXX>
fc1418b7 358
ee0887a9 359=over 4
4c793fe3 360
44428a46
FC
361=item *
362
ee0887a9 363XXX
44428a46 364
4c793fe3
FR
365=back
366
ee0887a9 367=head1 Configuration and Compilation
4c793fe3 368
ee0887a9
SH
369XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
370go here. Any other changes to the Perl build process should be listed here.
371However, any platform-specific changes should be listed in the
372L</Platform Support> section, instead.
4c793fe3 373
ee0887a9 374[ List changes as a =item entry ].
4c793fe3 375
0c692eed
FR
376=over 4
377
378=item *
379
ee0887a9 380XXX
0c692eed
FR
381
382=back
4c793fe3 383
ee0887a9 384=head1 Testing
0c692eed 385
ee0887a9
SH
386XXX Any significant changes to the testing of a freshly built perl should be
387listed here. Changes which create B<new> files in F<t/> go here as do any
388large changes to the testing harness (e.g. when parallel testing was added).
389Changes to existing files in F<t/> aren't worth summarising, although the bugs
390that they represent may be covered elsewhere.
0c692eed 391
ee0887a9 392[ List each test improvement as a =item entry ]
0c692eed 393
ee0887a9 394=over 4
0c692eed
FR
395
396=item *
397
ee0887a9 398XXX
4c793fe3
FR
399
400=back
401
ee0887a9 402=head1 Platform Support
4c793fe3 403
ee0887a9 404XXX Any changes to platform support should be listed in the sections below.
4c793fe3 405
ee0887a9
SH
406[ Within the sections, list each platform as a =item entry with specific
407changes as paragraphs below it. ]
4c793fe3 408
ee0887a9 409=head2 New Platforms
0c692eed 410
ee0887a9
SH
411XXX List any platforms that this version of perl compiles on, that previous
412versions did not. These will either be enabled by new files in the F<hints/>
413directories, or new subdirectories and F<README> files at the top level of the
414source tree.
0c692eed 415
ee0887a9 416=over 4
0c692eed 417
ee0887a9 418=item XXX-some-platform
0c692eed 419
ee0887a9 420XXX
0c692eed 421
ee0887a9 422=back
0c692eed 423
ee0887a9 424=head2 Discontinued Platforms
4c793fe3 425
ee0887a9 426XXX List any platforms that this version of perl no longer compiles on.
8ebb9810 427
ee0887a9 428=over 4
8ebb9810 429
ee0887a9 430=item XXX-some-platform
48c1efd2 431
ee0887a9 432XXX
48c1efd2 433
ee0887a9 434=back
44428a46 435
ee0887a9 436=head2 Platform-Specific Notes
44428a46 437
ee0887a9
SH
438XXX List any changes for specific platforms. This could include configuration
439and compilation changes or changes in portability/compatibility. However,
440changes within modules for platforms should generally be listed in the
441L</Modules and Pragmata> section.
f4beb78f 442
ee0887a9 443=over 4
f4beb78f 444
2ffefa5a 445=item Windows
ccb45ef4 446
2ffefa5a
FC
447C<$Config{gccversion}> is now set correctly when perl is built using the
448mingw64 compiler from L<http://mingw64.org>
449L<[perl #73754]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=73754>.
450
451=back
ccb45ef4 452
ee0887a9 453=head1 Internal Changes
85318b69 454
ee0887a9
SH
455XXX Changes which affect the interface available to C<XS> code go here.
456Other significant internal changes for future core maintainers should
457be noted as well.
85318b69 458
ee0887a9 459[ List each test improvement as a =item entry ]
80b6a949 460
ee0887a9 461=over 4
80b6a949 462
e2babdfb
FR
463=item *
464
a5763045
FC
465See L</Regular expressions retain their localeness when interpolated>,
466above.
e2babdfb 467
a7e93501
FC
468=item *
469
470The C<sv_cmp_flags>, C<sv_cmp_locale_flags>, C<sv_eq_flags> and
471C<sv_collxfrm_flags> functions have been added. These are like their
472non-_flags counterparts, but allow one to specify whether get-magic is
473processed.
474
475The C<sv_cmp>, C<sv_cmp_locale>, C<sv_eq> and C<sv_collxfrm> functions have
476been replaced with wrappers around the new functions.
477
478=item *
479
480A new C<sv_2bool_flags> function has been added.
481
482This is like C<sv_2bool>, but it lets the calling code decide whether
483get-magic is handled. C<sv_2bool> is now a macro that calls the new
484function.
485
486=item *
487
488A new macro, C<SvTRUE_nomg>, has been added.
489
490This is like C<SvTRUE>, except that it does not process magic. It uses the
491new C<sv_2bool_flags> function.
492
493=item *
494
495C<sv_catsv_flags> no longer calls C<mg_get> on its second argument (the
496source string) if the flags passed to it do not include SV_GMAGIC. So it
497now matches what the documentation says it does.
498
ee0887a9 499=back
e2babdfb 500
ee0887a9 501=head1 Selected Bug Fixes
e2babdfb 502
ee0887a9
SH
503XXX Important bug fixes in the core language are summarised here.
504Bug fixes in files in F<ext/> and F<lib/> are best summarised in
505L</Modules and Pragmata>.
e2babdfb 506
ee0887a9 507[ List each fix as a =item entry ]
346e4e56 508
ee0887a9 509=over 4
346e4e56 510
78846812
FR
511=item *
512
4e9f151b
FC
513A regular expression match in the right-hand side of a global substitution
514(C<s///g>) that is in the same scope will no longer cause match variables
515to have the wrong values on subsequent iterations. This can happen when an
e54f3f30
FC
516array or hash subscript is interpolated in the right-hand side, as in
517C<s|(.)|@a{ print($1), /./ }|g>
518L<[perl #19078]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=19078>.
519
520=item *
521
522Constant-folding used to cause
523
524 $text =~ ( 1 ? /phoo/ : /bear/)
525
526to turn into
527
528 $text =~ /phoo/
529
530at compile time. Now it correctly matches against C<$_>
531L<[perl #20444]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=20444>.
78846812 532
a5763045
FC
533=item *
534
535Parsing Perl code (either with string C<eval> or by loading modules) from
536within a C<UNITCHECK> block no longer causes the interpreter to crash
537L<[perl #70614]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=70614>.
538
5a9a79a4
FC
539=item *
540
541When C<-d> is used on the shebang (C<#!>) line, the debugger now has access
542to the lines of the main program. In the past, this sometimes worked and
543sometimes did not, depending on what order things happened to be arranged
b45e2413
FC
544in memory
545L<[perl #71806]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=71806>.
5a9a79a4 546
a7e93501
FC
547=item *
548
549The C<y///> or C<tr///> operator now calls get-magic (e.g., the C<FETCH>
550method of a tie) on its left-hand side just once, not twice
551L<[perl #76814]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=76814>.
552
553=item *
554
555String comparison (C<eq>, C<ne>, C<lt>, C<gt>, C<le>, C<ge> and
556C<cmp>) and logical not (C<not> and C<!>) operators no longer call magic
557(e.g., tie methods) twice on their operands
558L<[perl #76814]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=76814>.
559
560This bug was introduced in an earlier 5.13 release, and does not affect
561perl 5.12.
562
563=item *
564
565When a tied (or other magic) variable is used as, or in, a regular
566expression, it no longer has its C<FETCH> method called twice
567L<[perl #76814]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=76814>.
568
569This bug was introduced in an earlier 5.13 release, and does not affect
570perl 5.12.
571
d4a59e54
FC
572=item *
573
8420a925 574The C<-C> command line option can now be followed by other options
d4a59e54
FC
575L<[perl #72434]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=72434>.
576
dc08898c
FC
577=item *
578
579Assigning a glob to a PVLV used to convert it to a plain string. Now it
580works correctly, and a PVLV can hold a glob. This would happen when a
581nonexistent hash or array element was passed to a subroutine:
582
583 sub { $_[0] = *foo }->($hash{key});
584 # $_[0] would have been the string "*main::foo"
585
586It also happened when a glob was assigned to, or returned from, an element
587of a tied array or hash
588L<[perl #36051]|http://rt.perl.org/rt3//Public/Bug/Display.html?id=36051>.
589
4c793fe3
FR
590=back
591
962fbe1d
SH
592=head1 Known Problems
593
ee0887a9
SH
594XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
595tests that had to be C<TODO>ed for the release would be noted here, unless
596they were specific to a particular platform (see below).
962fbe1d 597
ee0887a9
SH
598This is a list of some significant unfixed bugs, which are regressions
599from either 5.XXX.XXX or 5.XXX.XXX.
962fbe1d 600
ee0887a9
SH
601[ List each fix as a =item entry ]
602
603=over 4
08d032c0
SH
604
605=item *
606
ee0887a9 607XXX
962fbe1d
SH
608
609=back
610
ee0887a9 611=head1 Obituary
4c793fe3 612
ee0887a9
SH
613XXX If any significant core contributor has died, we've added a short obituary
614here.
0195fb5f 615
405fd67e
DG
616=head1 Errata
617
618=over 4
619
620=item *
621
622Fixed a typo in L<perl5135delta> regarding array slices and smart matching
623
624=back
625
ee0887a9 626=head1 Acknowledgements
0195fb5f 627
ee0887a9 628XXX The list of people to thank goes here.
4c793fe3
FR
629
630=head1 Reporting Bugs
631
632If you find what you think is a bug, you might check the articles
633recently posted to the comp.lang.perl.misc newsgroup and the perl
634bug database at http://rt.perl.org/perlbug/ . There may also be
635information at http://www.perl.org/ , the Perl Home Page.
636
637If you believe you have an unreported bug, please run the B<perlbug>
638program included with your release. Be sure to trim your bug down
639to a tiny but sufficient test case. Your bug report, along with the
640output of C<perl -V>, will be sent off to perlbug@perl.org to be
641analysed by the Perl porting team.
642
643If the bug you are reporting has security implications, which make it
644inappropriate to send to a publicly archived mailing list, then please send
ee0887a9 645it to perl5-security-report@perl.org. This points to a closed subscription
4c793fe3
FR
646unarchived mailing list, which includes all the core committers, who be able
647to help assess the impact of issues, figure out a resolution, and help
648co-ordinate the release of patches to mitigate or fix the problem across all
ee0887a9 649platforms on which Perl is supported. Please only use this address for
4c793fe3
FR
650security issues in the Perl core, not for modules independently
651distributed on CPAN.
652
653=head1 SEE ALSO
654
655The F<Changes> file for an explanation of how to view exhaustive details
656on what changed.
657
658The F<INSTALL> file for how to build Perl.
659
660The F<README> file for general stuff.
661
662The F<Artistic> and F<Copying> files for copyright information.
663
664=cut