pp_next/pp_last/pp_redo problems
[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 The length argument of C<syswrite()> is now optional.
44
45 Better 64-bit support -- but full support still a distant goal.  One
46 must Configure with -Duse64bits to get Configure to probe for the
47 extent of 64-bit support.  Depending on the platform (hints file) more
48 or less 64-awareness becomes available.  As of 5.005_54 at least
49 somewhat 64-bit aware platforms are HP-UX 11 or better, Solaris 2.6 or
50 better, IRIX 6.2 or better.  Naturally 64-bit platforms like Digital
51 UNIX and UNICOS also have 64-bit support.
52
53 =head1 Supported Platforms
54
55 VM/ESA is now supported.
56
57 Siemens BS200 is now supported.
58
59 The Mach CThreads (NeXTstep) are now supported by the Thread extension.
60
61 =head1 New tests
62
63 =over 4
64
65 =item   op/io_const
66
67 IO constants (SEEK_*, _IO*).
68         
69 =item   op/io_dir
70
71 Directory-related IO methods (new, read, close, rewind, tied delete).
72
73 =item   op/io_multihomed
74
75 INET sockets with multi-homed hosts.
76
77 =item   op/io_poll
78
79 IO poll().
80
81 =item   op/io_unix
82
83 UNIX sockets.
84
85 =item   op/filetest
86
87 File test operators.
88
89 =item   op/lex_assign
90
91 Guard against lexicals leaking (internal stuff).
92
93 =back
94
95 =head1 Modules and Pragmata
96
97 Lexical warnings pragma, "use warning;", to control optional warnings.
98
99 Filetest pragma, to control the behaviour of filetests (C<-r> C<-w> ...).
100 Currently only one subpragma implemented, "use filetest 'access';",
101 that enables the use of access(2) or equivalent to check the
102 permissions instead of using stat(2) as usual.  This matters
103 in filesystems where there are ACLs (access control lists), the
104 stat(2) might lie, while access(2) knows better.
105
106 Todo.
107
108 =head1 Utility Changes
109
110 Todo.
111
112 =head1 Documentation Changes
113
114 Todo.
115
116 =head1 New Diagnostics
117
118 Todo.
119
120 =head1 Obsolete Diagnostics
121
122 Todo.
123
124 =head1 BUGS
125
126 If you find what you think is a bug, you might check the headers of
127 recently posted articles in the comp.lang.perl.misc newsgroup.
128 There may also be information at http://www.perl.com/perl/, the Perl
129 Home Page.
130
131 If you believe you have an unreported bug, please run the B<perlbug>
132 program included with your release.  Make sure you trim your bug down
133 to a tiny but sufficient test case.  Your bug report, along with the
134 output of C<perl -V>, will be sent off to <F<perlbug@perl.com>> to be
135 analysed by the Perl porting team.
136
137 =head1 SEE ALSO
138
139 The F<Changes> file for exhaustive details on what changed.
140
141 The F<INSTALL> file for how to build Perl.
142
143 The F<README> file for general stuff.
144
145 The F<Artistic> and F<Copying> files for copyright information.
146
147 =head1 HISTORY
148
149 Written by Gurusamy Sarathy <F<gsar@umich.edu>>, with many contributions
150 from The Perl Porters.
151
152 Send omissions or corrections to <F<perlbug@perl.com>>.
153
154 =cut