d4fe20f29980ad090fc889a23bef26306f2a02b4
[p5sagit/p5-mst-13.2.git] / pod / perldelta.pod
1 =head1 NAME
2
3 perldelta - what's new for perl5.006 (as of 5.005_54)
4
5 =head1 DESCRIPTION
6
7 This document describes differences between the 5.005 release and this one.
8
9 =head1 Incompatible Changes
10
11 =head2 Perl Source Incompatibilities
12
13 None known at this time.
14
15 =head2 C Source Incompatibilities
16
17 =over 4
18
19 =item C<PERL_POLLUTE>
20
21 Release 5.005 grandfathered old global symbol names by providing preprocessor
22 macros for extension source compatibility.  As of release 5.006, these
23 preprocessor definitions are not available by default.  You need to explicitly
24 compile perl with C<-DPERL_POLLUTE> in order to get these definitions.
25
26 =item C<PL_na> and C<dTHR> Issues
27
28 The C<PL_na> global is now thread local, so a C<dTHR> declaration is needed
29 in the scope in which it appears.  XSUBs should handle this automatically,
30 but if you have used C<PL_na> in support functions, you either need to
31 change the C<PL_na> to a local variable (which is recommended), or put in
32 a C<dTHR>.
33
34 =back
35
36 =head2 Binary Incompatibilities
37
38 This release is not binary compatible with the 5.005 release and its
39 maintenance versions.
40
41 =head1 Core Changes
42
43 Todo.
44
45 =head1 Supported Platforms
46
47 Todo.
48
49 =head1 Modules and Pragmata
50
51 Todo.
52
53 =head1 Utility Changes
54
55 Todo.
56
57 =head1 Documentation Changes
58
59 Todo.
60
61 =head1 New Diagnostics
62
63 Todo.
64
65 =head1 Obsolete Diagnostics
66
67 Todo.
68
69 =head1 BUGS
70
71 If you find what you think is a bug, you might check the headers of
72 recently posted articles in the comp.lang.perl.misc newsgroup.
73 There may also be information at http://www.perl.com/perl/, the Perl
74 Home Page.
75
76 If you believe you have an unreported bug, please run the B<perlbug>
77 program included with your release.  Make sure you trim your bug down
78 to a tiny but sufficient test case.  Your bug report, along with the
79 output of C<perl -V>, will be sent off to <F<perlbug@perl.com>> to be
80 analysed by the Perl porting team.
81
82 =head1 SEE ALSO
83
84 The F<Changes> file for exhaustive details on what changed.
85
86 The F<INSTALL> file for how to build Perl.
87
88 The F<README> file for general stuff.
89
90 The F<Artistic> and F<Copying> files for copyright information.
91
92 =head1 HISTORY
93
94 Written by Gurusamy Sarathy <F<gsar@umich.edu>>, with many contributions
95 from The Perl Porters.
96
97 Send omissions or corrections to <F<perlbug@perl.com>>.
98
99 =cut