Put a watchdog on openpid.t: it has been found to hang in some Win32 smokes.
[perl.git] / pod / perl591delta.pod
1 =head1 NAME
2
3 perl591delta - what is new for perl v5.9.1
4
5 =head1 DESCRIPTION
6
7 This document describes differences between the 5.9.0 and the 5.9.1
8 development releases. See L<perl590delta> for the differences between
9 5.8.0 and 5.9.0.
10
11 =head1 Incompatible Changes
12
13 =head2 substr() lvalues are no longer fixed-length
14
15 The lvalues returned by the three argument form of substr() used to be a
16 "fixed length window" on the original string. In some cases this could
17 cause surprising action at distance or other undefined behaviour. Now the
18 length of the window adjusts itself to the length of the string assigned to
19 it.
20
21 =head2 The C<:unique> attribute is only meaningful for globals
22
23 Now applying C<:unique> to lexical variables and to subroutines will
24 result in a compilation error.
25
26 =head1 Core Enhancements
27
28 =head2 Lexical C<$_>
29
30 The default variable C<$_> can now be lexicalized, by declaring it like
31 any other lexical variable, with a simple
32
33     my $_;
34
35 The operations that default on C<$_> will use the lexically-scoped
36 version of C<$_> when it exists, instead of the global C<$_>.
37
38 In a C<map> or a C<grep> block, if C<$_> was previously my'ed, then the
39 C<$_> inside the block is lexical as well (and scoped to the block).
40
41 In a scope where C<$_> has been lexicalized, you can still have access to
42 the global version of C<$_> by using C<$::_>, or, more simply, by
43 overriding the lexical declaration with C<our $_>.
44
45 =head2 Tied hashes in scalar context
46
47 As of perl 5.8.2/5.9.0, tied hashes did not return anything useful in
48 scalar context, for example when used as boolean tests:
49
50         if (%tied_hash) { ... }
51
52 The old nonsensical behaviour was always to return false,
53 regardless of whether the hash is empty or has elements.
54
55 There is now an interface for the implementors of tied hashes to implement
56 the behaviour of a hash in scalar context, via the SCALAR method (see
57 L<perltie>).  Without a SCALAR method, perl will try to guess whether
58 the hash is empty, by testing if it's inside an iteration (in this case
59 it can't be empty) or by calling FIRSTKEY.
60
61 =head2 Formats
62
63 Formats were improved in several ways. A new field, C<^*>, can be used for
64 variable-width, one-line-at-a-time text. Null characters are now handled
65 correctly in picture lines. Using C<@#> and C<~~> together will now
66 produce a compile-time error, as those format fields are incompatible.
67 L<perlform> has been improved, and miscellaneous bugs fixed.
68
69 =head2 Stacked filetest operators
70
71 As a new form of syntactic sugar, it's now possible to stack up filetest
72 operators. You can now write C<-f -w -x $file> in a row to mean
73 C<-x $file && -w _ && -f _>. See L<perlfunc/-X>.
74
75 =head1 Modules and Pragmata
76
77 =over 4
78
79 =item Benchmark
80
81 In C<Benchmark>, cmpthese() and timestr() now use the time statistics of
82 children instead of parent when the selected style is 'nop'.
83
84 =item Carp
85
86 The error messages produced by C<Carp> now include spaces between the
87 arguments in function argument lists: this makes long error messages
88 appear more nicely in browsers and other tools.
89
90 =item Exporter
91
92 C<Exporter> will now recognize grouping tags (such as C<:name>) anywhere
93 in the import list, not only at the beginning.
94
95 =item FindBin
96
97 A function C<again> is provided to resolve problems where modules in different
98 directories wish to use FindBin.
99
100 =item List::Util
101
102 You can now weaken references to read only values.
103
104 =item threads::shared
105
106 C<cond_wait> has a new two argument form. C<cond_timedwait> has been added.
107
108 =back
109
110 =head1 Utility Changes
111
112 C<find2perl> now assumes C<-print> as a default action. Previously, it
113 needed to be specified explicitly.
114
115 A new utility, C<prove>, makes it easy to run an individual regression test
116 at the command line. C<prove> is part of Test::Harness, which users of earlier
117 Perl versions can install from CPAN.
118
119 The perl debugger now supports a C<save> command, to save the current
120 history to a file, and an C<i> command, which prints the inheritance tree
121 of its argument (if the C<Class::ISA> module is installed.)
122
123 =head1 Documentation
124
125 The documentation has been revised in places to produce more standard manpages.
126
127 The long-existing feature of C</(?{...})/> regexps setting C<$_> and pos()
128 is now documented.
129
130 =head1 Performance Enhancements
131
132 Sorting arrays in place (C<@a = sort @a>) is now optimized to avoid
133 making a temporary copy of the array.
134
135 The operations involving case mapping on UTF-8 strings (uc(), lc(),
136 C<//i>, etc.) have been greatly speeded up.
137
138 Access to elements of lexical arrays via a numeric constant between 0 and
139 255 is now faster. (This used to be only the case for global arrays.)
140
141 =head1 Selected Bug Fixes
142
143 =head2 UTF-8 bugs
144
145 Using substr() on a UTF-8 string could cause subsequent accesses on that
146 string to return garbage. This was due to incorrect UTF-8 offsets being
147 cached, and is now fixed.
148
149 join() could return garbage when the same join() statement was used to
150 process 8 bit data having earlier processed UTF-8 data, due to the flags
151 on that statement's temporary workspace not being reset correctly. This
152 is now fixed.
153
154 Using Unicode keys with tied hashes should now work correctly.
155
156 chop() and chomp() used to mangle UTF-8 strings.  This has been fixed.
157
158 sprintf() used to misbehave when the format string was in UTF-8. This is
159 now fixed.
160
161 =head2 Threading bugs
162
163 Hashes with the C<:unique> attribute weren't made read-only in new
164 threads. They are now.
165
166 =head2 More bugs
167
168 C<$a .. $b> will now work as expected when either $a or $b is C<undef>.
169
170 Reading $^E now preserves $!. Previously, the C code implementing $^E
171 did not preserve C<errno>, so reading $^E could cause C<errno> and therefore
172 C<$!> to change unexpectedly.
173
174 C<strict> wasn't in effect in regexp-eval blocks (C</(?{...})/>).
175
176 =head1 New or Changed Diagnostics
177
178 A new deprecation warning, I<Deprecated use of my() in false conditional>,
179 has been added, to warn against the use of the dubious and deprecated
180 construct
181
182     my $x if 0;
183
184 See L<perldiag>.
185
186 The fatal error I<DESTROY created new reference to dead object> is now
187 documented in L<perldiag>.
188
189 A new error, I<%ENV is aliased to %s>, is produced when taint checks are
190 enabled and when C<*ENV> has been aliased (and thus doesn't reflect the
191 program's environment anymore.)
192
193 =head1 Changed Internals
194
195 These news matter to you only if you either write XS code or like to
196 know about or hack Perl internals (using Devel::Peek or any of the
197 C<B::> modules counts), or like to run Perl with the C<-D> option.
198
199 =head2 Reordering of SVt_* constants
200
201 The relative ordering of constants that define the various types of C<SV>
202 have changed; in particular, C<SVt_PVGV> has been moved before C<SVt_PVLV>,
203 C<SVt_PVAV>, C<SVt_PVHV> and C<SVt_PVCV>.  This is unlikely to make any
204 difference unless you have code that explicitly makes assumptions about that
205 ordering. (The inheritance hierarchy of C<B::*> objects has been changed
206 to reflect this.)
207
208 =head2 Removal of CPP symbols
209
210 The C preprocessor symbols C<PERL_PM_APIVERSION> and
211 C<PERL_XS_APIVERSION>, which were supposed to give the version number of
212 the oldest perl binary-compatible (resp. source-compatible) with the
213 present one, were not used, and sometimes had misleading values. They have
214 been removed.
215
216 =head2 Less space is used by ops
217
218 The C<BASEOP> structure now uses less space. The C<op_seq> field has been
219 removed and replaced by two one-bit fields, C<op_opt> and C<op_static>.
220 C<opt_type> is now 9 bits long. (Consequently, the C<B::OP> class doesn't
221 provide an C<seq> method anymore.)
222
223 =head2 New parser
224
225 perl's parser is now generated by bison (it used to be generated by
226 byacc.) As a result, it seems to be a bit more robust.
227
228 =head1 Configuration and Building
229
230 C<Configure> now invokes callbacks regardless of the value of the variable
231 they are called for. Previously callbacks were only invoked in the
232 C<case $variable $define)> branch. This change should only affect platform
233 maintainers writing configuration hints files.
234
235 The portability and cleanliness of the Win32 makefiles has been improved.
236
237 =head1 Known Problems
238
239 There are still a couple of problems in the implementation of the lexical
240 C<$_>: it doesn't work inside C</(?{...})/> blocks and with regard to the
241 reverse() built-in used without arguments. (See the TODO tests in
242 F<t/op/mydef.t>.)
243
244 =head2 Platform Specific Problems
245
246 The test F<ext/IPC/SysV/t/ipcsysv.t> may fail on OpenBSD. This hasn't been
247 diagnosed yet.
248
249 On some configurations on AIX 5, one test in F<lib/Time/Local.t> fails.
250 When configured with long doubles, perl may fail tests 224-236 in
251 F<t/op/pow.t> on the same platform.
252
253 For threaded builds, F<ext/threads/shared/t/wait.t> has been reported to
254 fail some tests on HP-UX 10.20.
255
256 =head1 To-do for perl 5.10.0
257
258 This is a non-exhaustive, non-ordered, non-contractual and non-definitive
259 list of things to do (or nice to have) for perl 5.10.0 :
260
261 Clean up and finish support for assertions. See L<assertions>.
262
263 Reimplement the mechanism of lexical pragmas to be more extensible. Fix
264 current pragmas that don't work well (or at all) with lexical scopes or in
265 run-time eval(STRING) (C<sort>, C<re>, C<encoding> for example). MJD has a
266 preliminary patch that implements this.
267
268 Fix (or rewrite) the implementation of the C</(?{...})/> closures.
269
270 Conversions from byte strings to UTF-8 currently map high bit characters
271 to Unicode without translation (or, depending on how you look at it, by
272 implicitly assuming that the byte strings are in Latin-1). As perl assumes
273 the C locale by default, upgrading a string to UTF-8 may change the
274 meaning of its contents regarding character classes, case mapping, etc.
275 This should probably emit a warning (at least).
276
277 Introduce a new special block, UNITCHECK, which is run at the end of a
278 compilation unit (module, file, eval(STRING) block). This will correspond to
279 the Perl 6 CHECK. Perl 5's CHECK cannot be changed or removed because the
280 O.pm/B.pm backend framework depends on it.
281
282 Study the possibility of adding a new prototype character, C<_>, meaning
283 "this argument defaults to $_".
284
285 Make the peephole optimizer optional.
286
287 Allow lexical aliases (maybe via the syntax C<my \$alias = \$foo>.
288
289 Fix the bugs revealed by running the test suite with the C<-t> switch (via
290 C<make test.taintwarn>).
291
292 Make threads more robust.
293
294 Make C<no 6> and C<no v6> work (opposite of C<use 5.005>, etc.).
295
296 A test suite for the B module would be nice.
297
298 A ponie.
299
300 =head1 Reporting Bugs
301
302 If you find what you think is a bug, you might check the articles
303 recently posted to the comp.lang.perl.misc newsgroup and the perl
304 bug database at http://bugs.perl.org/ .  There may also be
305 information at http://www.perl.org/ , the Perl Home Page.
306
307 If you believe you have an unreported bug, please run the B<perlbug>
308 program included with your release.  Be sure to trim your bug down
309 to a tiny but sufficient test case.  Your bug report, along with the
310 output of C<perl -V>, will be sent off to perlbug@perl.org to be
311 analysed by the Perl porting team.
312
313 =head1 SEE ALSO
314
315 The F<Changes> file for exhaustive details on what changed.
316
317 The F<INSTALL> file for how to build Perl.
318
319 The F<README> file for general stuff.
320
321 The F<Artistic> and F<Copying> files for copyright information.
322
323 =cut