034a9274ae6d3dccc3c0c976b6d56db35bcc4467
[p5sagit/p5-mst-13.2.git] / pod / perl595delta.pod
1 =head1 NAME
2
3 perldelta - what is new for perl v5.9.5
4
5 =head1 DESCRIPTION
6
7 This document describes differences between the 5.9.4 and the 5.9.5
8 development releases. See L<perl590delta>, L<perl591delta>,
9 L<perl592delta>, L<perl593delta> and L<perl594delta> for the differences
10 between 5.8.0 and 5.9.4.
11
12 =head1 Incompatible Changes
13
14 =head2 Tainting and printf
15
16 When perl is run under taint mode, C<printf()> and C<sprintf()> will now
17 reject any tainted format argument. (Rafael Garcia-Suarez)
18
19 =head2 undef and signal handlers
20
21 Undefining or deleting a signal handler via C<undef $SIG{FOO}> is now
22 equivalent to setting it to C<'DEFAULT'>. (Rafael)
23
24 =head2 strictures and array/hash dereferencing in defined()
25
26 C<defined @$foo> and C<defined %$bar> are now subject to C<strict 'refs'>
27 (that is, C<$foo> and C<$bar> shall be proper references there.)
28 (Nicholas Clark)
29
30 (However, C<defined(@foo)> and C<defined(%bar)> are discouraged constructs
31 anyway.)
32
33 =head2 C<(?p{})> has been removed
34
35 The regular expression construct C<(?p{})>, which was deprecated in perl
36 5.8, has been removed. Use C<(??{})> instead. (Rafael)
37
38 =head2 Removal of the bytecode compiler and of perlcc
39
40 C<perlcc>, the byteloader and the supporting modules (B::C, B::CC,
41 B::Bytecode, etc.) are no longer distributed with the perl sources. Those
42 experimental tools have never worked reliably, and, due to the lack of
43 volunteers to keep them in line with the perl interpreter developments, it
44 was decided to remove them instead of shipping a broken version of those.
45 The last version of those modules can be found with perl 5.9.4.
46
47 However the B compiler framework stays supported in the perl core, as with
48 the more useful modules it has permitted (among others, B::Deparse and
49 B::Concise).
50
51 =head2 Removal of the JPL
52
53 The JPL (Java-Perl Linguo) has been removed from the perl sources tarball.
54
55 =head2 Recursive inheritance detected earlier
56
57 Perl will now immediately throw an exception if you modify any package's
58 C<@ISA> in such a way that it would cause recursive inheritance.
59
60 Previously, the exception would not occur until Perl attempted to make
61 use of the recursive inheritance while resolving a method or doing a
62 C<$foo-E<gt>isa($bar)> lookup.
63
64 =head1 Core Enhancements
65
66 =head2 Regular expressions
67
68 =over 4
69
70 =item Recursive Patterns
71
72 It is now possible to write recursive patterns without using the C<(??{})>
73 construct. This new way is more efficient, and in many cases easier to
74 read.
75
76 Each capturing parenthesis can now be treated as an independent pattern
77 that can be entered by using the C<(?PARNO)> syntax (C<PARNO> standing for
78 "parenthesis number"). For example, the following pattern will match
79 nested balanced angle brackets:
80
81     /
82      ^                      # start of line
83      (                      # start capture buffer 1
84         <                   #   match an opening angle bracket
85         (?:                 #   match one of:
86             (?>             #     don't backtrack over the inside of this group
87                 [^<>]+      #       one or more non angle brackets
88             )               #     end non backtracking group
89         |                   #     ... or ...
90             (?1)            #     recurse to bracket 1 and try it again
91         )*                  #   0 or more times.
92         >                   #   match a closing angle bracket
93      )                      # end capture buffer one
94      $                      # end of line
95     /x
96
97 Note, users experienced with PCRE will find that the Perl implementation
98 of this feature differs from the PCRE one in that it is possible to
99 backtrack into a recursed pattern, whereas in PCRE the recursion is
100 atomic or "possessive" in nature. (Yves Orton)
101
102 =item Named Capture Buffers
103
104 It is now possible to name capturing parenthesis in a pattern and refer to
105 the captured contents by name. The naming syntax is C<< (?<NAME>....) >>.
106 It's possible to backreference to a named buffer with the C<< \k<NAME> >>
107 syntax. In code, the new magical hashes C<%+> and C<%-> can be used to
108 access the contents of the capture buffers.
109
110 Thus, to replace all doubled chars, one could write
111
112     s/(?<letter>.)\k<letter>/$+{letter}/g
113
114 Only buffers with defined contents will be "visible" in the C<%+> hash, so
115 it's possible to do something like
116
117     foreach my $name (keys %+) {
118         print "content of buffer '$name' is $+{$name}\n";
119     }
120
121 The C<%-> hash is a bit more complete, since it will contain array refs
122 holding values from all capture buffers similarly named, if there should
123 be many of them.
124
125 C<%+> and C<%-> are implemented as tied hashes through the new module
126 C<Tie::Hash::NamedCapture>.
127
128 Users exposed to the .NET regex engine will find that the perl
129 implementation differs in that the numerical ordering of the buffers
130 is sequential, and not "unnamed first, then named". Thus in the pattern
131
132    /(A)(?<B>B)(C)(?<D>D)/
133
134 $1 will be 'A', $2 will be 'B', $3 will be 'C' and $4 will be 'D' and not
135 $1 is 'A', $2 is 'C' and $3 is 'B' and $4 is 'D' that a .NET programmer
136 would expect. This is considered a feature. :-) (Yves Orton)
137
138 =item Possessive Quantifiers
139
140 Perl now supports the "possessive quantifier" syntax of the "atomic match"
141 pattern. Basically a possessive quantifier matches as much as it can and never
142 gives any back. Thus it can be used to control backtracking. The syntax is
143 similar to non-greedy matching, except instead of using a '?' as the modifier
144 the '+' is used. Thus C<?+>, C<*+>, C<++>, C<{min,max}+> are now legal
145 quantifiers. (Yves Orton)
146
147 =item Backtracking control verbs
148
149 The regex engine now supports a number of special-purpose backtrack
150 control verbs: (*THEN), (*PRUNE), (*MARK), (*SKIP), (*COMMIT), (*FAIL)
151 and (*ACCEPT). See L<perlre> for their descriptions. (Yves Orton)
152
153 =item Relative backreferences
154
155 A new syntax C<\g{N}> or C<\gN> where "N" is a decimal integer allows a
156 safer form of back-reference notation as well as allowing relative
157 backreferences. This should make it easier to generate and embed patterns
158 that contain backreferences. See L<perlre/"Capture buffers">. (Yves Orton)
159
160 =item C<\K> escape
161
162 The functionality of Jeff Pinyan's module Regexp::Keep has been added to
163 the core. You can now use in regular expressions the special escape C<\K>
164 as a way to do something like floating length positive lookbehind. It is
165 also useful in substitutions like:
166
167   s/(foo)bar/$1/g
168
169 that can now be converted to
170
171   s/foo\Kbar//g
172
173 which is much more efficient. (Yves Orton)
174
175 =back
176
177 =head2 The C<_> prototype
178
179 A new prototype character has been added. C<_> is equivalent to C<$> (it
180 denotes a scalar), but defaults to C<$_> if the corresponding argument
181 isn't supplied. Due to the optional nature of the argument, you can only
182 use it at the end of a prototype, or before a semicolon.
183
184 This has a small incompatible consequence: the prototype() function has
185 been adjusted to return C<_> for some built-ins in appropriate cases (for
186 example, C<prototype('CORE::rmdir')>). (Rafael)
187
188 =head2 UNITCHECK blocks
189
190 C<UNITCHECK>, a new special code block has been introduced, in addition to
191 C<BEGIN>, C<CHECK>, C<INIT> and C<END>.
192
193 C<CHECK> and C<INIT> blocks, while useful for some specialized purposes,
194 are always executed at the transition between the compilation and the
195 execution of the main program, and thus are useless whenever code is
196 loaded at runtime. On the other hand, C<UNITCHECK> blocks are executed
197 just after the unit which defined them has been compiled. See L<perlmod>
198 for more information. (Alex Gough)
199
200 =head2 readpipe() is now overridable
201
202 The built-in function readpipe() is now overridable. Overriding it permits
203 also to override its operator counterpart, C<qx//> (a.k.a. C<``>).
204 Moreover, it now defaults to C<$_> if no argument is provided. (Rafael)
205
206 =head2 default argument for readline()
207
208 readline() now defaults to C<*ARGV> if no argument is provided. (Rafael)
209
210 =head2 UCD 5.0.0
211
212 The copy of the Unicode Character Database included in Perl 5.9 has
213 been updated to version 5.0.0.
214
215 =head2 Smart match
216
217 The smart match operator (C<~~>) is now available by default (you don't
218 need to enable it with C<use feature> any longer). (Michael G Schwern)
219
220 =head2 Implicit loading of C<feature>
221
222 The C<feature> pragma is now implicitly loaded when you require a minimal
223 perl version (with the C<use VERSION> construct) greater than, or equal
224 to, 5.9.5.
225
226 =head1 Modules and Pragmas
227
228 =head2 New Pragma, C<mro>
229
230 A new pragma, C<mro> (for Method Resolution Order) has been added. It
231 permits to switch, on a per-class basis, the algorithm that perl uses to
232 find inherited methods in case of a mutiple inheritance hierachy. The
233 default MRO hasn't changed (DFS, for Depth First Search). Another MRO is
234 available: the C3 algorithm. See L<mro> for more information.
235 (Brandon Black)
236
237 =head2 New Core Modules
238
239 =over 4
240
241 =item *
242
243 C<Locale::Maketext::Simple>, needed by CPANPLUS, is a simple wrapper around
244 C<Locale::Maketext::Lexicon>. Note that C<Locale::Maketext::Lexicon> isn't
245 included in the perl core; the behaviour of C<Locale::Maketext::Simple>
246 gracefully degrades when the later isn't present.
247
248 =item *
249
250 C<Params::Check> implements a generic input parsing/checking mechanism. It
251 is used by CPANPLUS.
252
253 =item *
254
255 C<Term::UI> simplifies the task to ask questions at a terminal prompt.
256
257 =item *
258
259 C<Object::Accessor> provides an interface to create per-object accessors.
260
261 =item *
262
263 C<Module::Pluggable> is a simple framework to create modules that accept
264 pluggable sub-modules.
265
266 =item *
267
268 C<Module::Load::Conditional> provides simple ways to query and possibly
269 load installed modules.
270
271 =item *
272
273 C<Time::Piece> provides an object oriented interface to time functions,
274 overriding the built-ins localtime() and gmtime().
275
276 =item *
277
278 C<IPC::Cmd> helps to find and run external commands, possibly
279 interactively.
280
281 =item *
282
283 C<File::Fetch> provide a simple generic file fetching mechanism.
284
285 =item *
286
287 C<Archive::Extract> is a generic archive extraction mechanism
288 for F<.tar> (plain, gziped or bzipped) or F<.zip> files.
289
290 =item *
291
292 C<CPANPLUS> provides an API and a command-line tool to access the CPAN
293 mirrors.
294
295 =back
296
297 =head2 Module changes
298
299 =over 4
300
301 =item C<base>
302
303 The C<base> pragma now warns if a class tries to inherit from itself.
304 (Curtis "Ovid" Poe)
305
306 =item C<strict> and C<warnings>
307
308 C<strict> and C<warnings> will now complain loudly if they are loaded via
309 incorrect casing (as in C<use Strict;>). (Johan Vromans)
310
311 =item C<warnings>
312
313 The C<warnings> pragma doesn't load C<Carp> anymore. That means that code
314 that used C<Carp> routines without having loaded it at compile time might
315 need to be adjusted; typically, the following (faulty) code won't work
316 anymore, and will require parentheses to be added after the function name:
317
318     use warnings;
319     require Carp;
320     Carp::confess "argh";
321
322 =item C<less>
323
324 C<less> now does something useful (or at least it tries to). In fact, it
325 has been turned into a lexical pragma. So, in your modules, you can now
326 test whether your users have requested to use less CPU, or less memory,
327 less magic, or maybe even less fat. See L<less> for more. (Joshua ben
328 Jore)
329
330 =item C<Attribute::Handlers>
331
332 C<Attribute::Handlers> can now report the caller's file and line number.
333 (David Feldman)
334
335 =item C<B::Lint>
336
337 C<B::Lint> is now based on C<Module::Pluggable>, and so can be extended
338 with plugins. (Joshua ben Jore)
339
340 =item C<B>
341
342 It's now possible to access the lexical pragma hints (C<%^H>) by using the
343 method B::COP::hints_hash(). It returns a C<B::RHE> object, which in turn
344 can be used to get a hash reference via the method B::RHE::HASH(). (Joshua
345 ben Jore)
346
347 =for p5p XXX document this in B.pm too
348
349 =back
350
351 =head1 Utility Changes
352
353 =head2 C<cpanp>
354
355 C<cpanp>, the CPANPLUS shell, has been added. (C<cpanp-run-perl>, an
356 helper for CPANPLUS operation, has been added too, but isn't intended for
357 direct use).
358
359 =head2 C<pod2html>
360
361 The output of C<pod2html> has been enhanced to be more customizable via
362 CSS. Some formatting problems were also corrected. (Jari Aalto)
363
364 =head1 Documentation
365
366 =head2 New manpage, perlunifaq
367
368 A new manual page, L<perlunifaq> (the Perl Unicode FAQ), has been added
369 (Juerd Waalboer).
370
371 =head1 Performance Enhancements
372
373 =head1 Installation and Configuration Improvements
374
375 =head2 C++ compatibility
376
377 Efforts have been made to make perl and the core XS modules compilable
378 with various C++ compilers (although the situation is not perfect with
379 some of the compilers on some of the platforms tested.)
380
381 =head2 Static build on Win32
382
383 It's now possible to build a C<perl-static.exe> that doesn't depend
384 on C<perl59.dll> on Win32. See the Win32 makefiles for details.
385 (Vadim Konovalov)
386
387 =head2 Ports
388
389 Perl has been reported to work on MidnightBSD.
390
391 =head1 Selected Bug Fixes
392
393 PerlIO::scalar will now prevent writing to read-only scalars. Moreover,
394 seek() is now supported with PerlIO::scalar-based filehandles, the
395 underlying string being zero-filled as needed. (Rafael, Jarkko Hietaniemi)
396
397 study() never worked for UTF-8 strings, but could lead to false results.
398 It's now a no-op on UTF-8 data. (Yves Orton)
399
400 The signals SIGILL, SIGBUS and SIGSEGV are now always delivered in an
401 "unsafe" manner (contrary to other signals, that are deferred until the
402 perl interpreter reaches a reasonably stable state; see
403 L<perlipc/"Deferred Signals (Safe Signals)">). (Rafael)
404
405 When a module or a file is loaded through an @INC-hook, and when this hook
406 has set a filename entry in %INC, __FILE__ is now set for this module
407 accordingly to the contents of that %INC entry. (Rafael)
408
409 The C<-w> and C<-t> switches can now be used together without messing
410 up what categories of warnings are activated or not. (Rafael)
411
412 Duping a filehandle which has the C<:utf8> PerlIO layer set will now
413 properly carry that layer on the duped filehandle. (Rafael)
414
415 =head1 New or Changed Diagnostics
416
417 =head2 Deprecations
418
419 Two deprecation warnings have been added: (Rafael)
420
421     Opening dirhandle %s also as a file
422     Opening filehandle %s also as a directory
423
424 =head1 Changed Internals
425
426 The anonymous hash and array constructors now take 1 op in the optree
427 instead of 3, now that pp_anonhash and pp_anonlist return a reference to
428 an hash/array when the op is flagged with OPf_SPECIAL (Nicholas Clark).
429
430 =for p5p XXX have we some docs on how to create regexp engine plugins, since that's now possible ? (perlreguts)
431
432 =for p5p XXX new BIND SV type, #29544, #29642
433
434 =head1 Known Problems
435
436 =head2 Platform Specific Problems
437
438 =head1 Reporting Bugs
439
440 If you find what you think is a bug, you might check the articles
441 recently posted to the comp.lang.perl.misc newsgroup and the perl
442 bug database at http://rt.perl.org/rt3/ .  There may also be
443 information at http://www.perl.org/ , the Perl Home Page.
444
445 If you believe you have an unreported bug, please run the B<perlbug>
446 program included with your release.  Be sure to trim your bug down
447 to a tiny but sufficient test case.  Your bug report, along with the
448 output of C<perl -V>, will be sent off to perlbug@perl.org to be
449 analysed by the Perl porting team.
450
451 =head1 SEE ALSO
452
453 The F<Changes> file for exhaustive details on what changed.
454
455 The F<INSTALL> file for how to build Perl.
456
457 The F<README> file for general stuff.
458
459 The F<Artistic> and F<Copying> files for copyright information.
460
461 =cut