/usr/share/perl5/pod
NameSizeModeActions
a2p.pod61070644editdlrm
perl.pod157480644editdlrm
perl56delta.pod1071840644editdlrm
perl58delta.pod1149080644editdlrm
perl561delta.pod1246970644editdlrm
perl570delta.pod216550644editdlrm
perl571delta.pod303820644editdlrm
perl572delta.pod255510644editdlrm
perl573delta.pod46440644editdlrm
perl581delta.pod380600644editdlrm
perl582delta.pod44700644editdlrm
perl583delta.pod63350644editdlrm
perl584delta.pod73630644editdlrm
perl585delta.pod58890644editdlrm
perl586delta.pod46510644editdlrm
perl587delta.pod83570644editdlrm
perl588delta.pod252670644editdlrm
perl589delta.pod539050644editdlrm
perl590delta.pod349510644editdlrm
perl591delta.pod111730644editdlrm
perl592delta.pod109540644editdlrm
perl593delta.pod170340644editdlrm
perl594delta.pod126610644editdlrm
perl595delta.pod189340644editdlrm
perl5004delta.pod562400644editdlrm
perl5005delta.pod342850644editdlrm
perl5100delta.pod539220644editdlrm
perl5101delta.pod438770644editdlrm
perlaix.pod181280644editdlrm
perlamiga.pod70310644editdlrm
perlapi.pod1694280644editdlrm
perlapio.pod193320644editdlrm
perlapollo.pod8290644editdlrm
perlartistic.pod68020644editdlrm
perlbeos.pod29390644editdlrm
perlbook.pod6630644editdlrm
perlboot.pod283550644editdlrm
perlbot.pod116750644editdlrm
perlbs2000.pod79290644editdlrm
perlcall.pod551730644editdlrm
perlce.pod92570644editdlrm
perlcheat.pod41530644editdlrm
perlclib.pod76840644editdlrm
perlcn.pod49150644editdlrm
perlcommunity.pod63980644editdlrm
perlcompile.pod95160644editdlrm
perlcygwin.pod281830644editdlrm
perldata.pod368790644editdlrm
perldbmfilter.pod49870644editdlrm
perldebguts.pod318870644editdlrm
perldebtut.pod213040644editdlrm
perldebug.pod375350644editdlrm
perldelta.pod438770644editdlrm
perldgux.pod28210644editdlrm
perldiag.pod1831510644editdlrm
perldoc.pod73100644editdlrm
perldos.pod108530644editdlrm
perldsc.pod254470644editdlrm
perlebcdic.pod666070644editdlrm
perlembed.pod380330644editdlrm
perlepoc.pod37790644editdlrm
perlfaq.pod248410644editdlrm
perlfaq1.pod177620644editdlrm
perlfaq2.pod216140644editdlrm
perlfaq3.pod385340644editdlrm
perlfaq4.pod814120644editdlrm
perlfaq5.pod492010644editdlrm
perlfaq6.pod385380644editdlrm
perlfaq7.pod375880644editdlrm
perlfaq8.pod461280644editdlrm
perlfaq9.pod241910644editdlrm
perlfilter.pod211400644editdlrm
perlfork.pod114400644editdlrm
perlform.pod168940644editdlrm
perlfreebsd.pod19500644editdlrm
perlfunc.pod2919090644editdlrm
perlglossary.pod1121390644editdlrm
perlgpl.pod188060644editdlrm
perlguts.pod1051820644editdlrm
perlhack.pod1215120644editdlrm
perlhaiku.pod15040644editdlrm
perlhist.pod387660644editdlrm
perlhpux.pod286500644editdlrm
perlhurd.pod19900644editdlrm
perlintern.pod264080644editdlrm
perlintro.pod214910644editdlrm
perliol.pod337550644editdlrm
perlipc.pod677610644editdlrm
perlirix.pod43970644editdlrm
perljp.pod80700644editdlrm
perlko.pod78920644editdlrm
perllexwarn.pod144350644editdlrm
perllinux.pod14920644editdlrm
perllocale.pod416160644editdlrm
perllol.pod82520644editdlrm
perlmachten.pod45000644editdlrm
perlmacos.pod21110644editdlrm
perlmacosx.pod113220644editdlrm
perlmint.pod95390644editdlrm
perlmod.pod244940644editdlrm
perlmodinstall.pod139290644editdlrm
perlmodlib.pod773330644editdlrm
perlmodstyle.pod211140644editdlrm
perlmpeix.pod150870644editdlrm
perlmroapi.pod29590644editdlrm
perlnetware.pod64880644editdlrm
perlnewmod.pod112140644editdlrm
perlnumber.pod83520644editdlrm
perlobj.pod218130644editdlrm
perlop.pod962250644editdlrm
perlopenbsd.pod12070644editdlrm
perlopentut.pod379970644editdlrm
perlos2.pod927830644editdlrm
perlos390.pod160740644editdlrm
perlos400.pod46180644editdlrm
perlothrtut.pod406570644editdlrm
perlpacktut.pod510470644editdlrm
perlperf.pod513280644editdlrm
perlplan9.pod51250644editdlrm
perlpod.pod216260644editdlrm
perlpodspec.pod677920644editdlrm
perlport.pod863020644editdlrm
perlpragma.pod43200644editdlrm
perlqnx.pod42460644editdlrm
perlre.pod827980644editdlrm
perlreapi.pod254270644editdlrm
perlrebackslash.pod201090644editdlrm
perlrecharclass.pod219090644editdlrm
perlref.pod264650644editdlrm
perlreftut.pod186700644editdlrm
perlreguts.pod368770644editdlrm
perlrepository.pod234530644editdlrm
perlrequick.pod176170644editdlrm
perlreref.pod119960644editdlrm
perlretut.pod1150050644editdlrm
perlriscos.pod15110644editdlrm
perlrun.pod499280644editdlrm
perlsec.pod235420644editdlrm
perlsolaris.pod291310644editdlrm
perlstyle.pod86180644editdlrm
perlsub.pod542220644editdlrm
perlsymbian.pod162220644editdlrm
perlsyn.pod310900644editdlrm
perlthrtut.pod465100644editdlrm
perltie.pod366650644editdlrm
perltoc.pod6429870644editdlrm
perltodo.pod483600644editdlrm
perltooc.pod514250644editdlrm
perltoot.pod686250644editdlrm
perltrap.pod411510644editdlrm
perltru64.pod77360644editdlrm
perltw.pod53840644editdlrm
perlunicode.pod561690644editdlrm
perlunifaq.pod128780644editdlrm
perluniintro.pod329730644editdlrm
perlunitut.pod79070644editdlrm
perlutil.pod98810644editdlrm
perluts.pod31800644editdlrm
perlvar.pod591330644editdlrm
perlvmesa.pod39520644editdlrm
perlvms.pod525450644editdlrm
perlvos.pod55670644editdlrm
perlwin32.pod408090644editdlrm
perlxs.pod741940644editdlrm
perlxstut.pod496700644editdlrm
Edit: /usr/share/perl5/pod/perl593delta.pod (17034B)
=head1 NAME perl593delta - what is new for perl v5.9.3 =head1 DESCRIPTION This document describes differences between the 5.9.2 and the 5.9.3 development releases. See L, L and L for the differences between 5.8.0 and 5.9.2. =head1 Incompatible Changes =head2 Parsing of C<-f _> The identifier C<_> is now forced to be a bareword after a filetest operator. This solves a number of misparsing issues when a global C<_> subroutine is defined. =head2 C C without arguments now defaults to C<$_>. =head2 Magic goto and eval The construct C is now disallowed. (Note that the similar construct, but with C instead, was already forbidden.) =head2 C<$#> has been removed The deprecated C<$#> variable (output format for numbers) has been removed. A new warning, C<$# is no longer supported>, has been added. =head2 C<:unique> The C<:unique> attribute has been made a no-op, since its current implementation was fundamentally flawed and not threadsafe. =head2 Scoping of the C pragma The C pragma is now lexically scoped. Its effect used to be global. =head1 Core Enhancements =head2 The C pragma The C pragma is used to enable new syntax that would break Perl's backwards-compatibility with older releases of the language. It's a lexical pragma, like C or C. Currently the following new features are available: C (adds a switch statement), C<~~> (adds a Perl 6-like smart match operator), C (adds a C built-in function), and C (adds an C keyword). Those features are described below. Note that C low-precedence defined-or operator used to be enabled by default (although as a weak keyword, meaning that any function would override it). It's now only recognized when explicitly turned on (and is then a regular keyword). Those features, and the C pragma itself, have been contributed by Robin Houston. =head2 Switch and Smart Match operator Perl 5 now has a switch statement. It's available when C is in effect. This feature introduces three new keywords, C, C, and C: given ($foo) { when (/^abc/) { $abc = 1; } when (/^def/) { $def = 1; } when (/^xyz/) { $xyz = 1; } default { $nothing = 1; } } A more complete description of how Perl matches the switch variable against the C conditions is given in L. This kind of match is called I, and it's also possible to use it outside of switch statements, via the new C<~~> operator (enabled via the C directive). See L. =head2 C say() is a new built-in, only available when C is in effect, that is similar to print(), but that implicitly appends a newline to the printed string. See L. =head2 C Perl has now support for the C special subroutine. Like C, C is called once per package; however, it is called just before cloning starts, and in the context of the parent thread. If it returns a true value, then no objects of that class will be cloned. See L for details. (Contributed by Dave Mitchell.) =head2 C<${^CHILD_ERROR_NATIVE}> A new internal variable, C<${^CHILD_ERROR_NATIVE}>, gives the native status returned by the last pipe close, backtick command, successful call to wait() or waitpid(), or from the system() operator. See L for details. (Contributed by Gisle Aas.) =head2 Assertions The support for assertions, introduced in perl 5.9.0, has been improved. The syntax for the C<-A> command-line switch has changed; it now accepts an optional module name, defaulting to C. See L and L. (Contributed by Salvador Fandiño García.) =head2 Unicode Character Database 4.1.0 The copy of the Unicode Character Database included in Perl 5.9 has been updated to 4.1.0. =head2 C You can now use C followed by a version number to specify that you want to use a version of perl older than the specified one. =head2 Recursive sort subs You can now use recursive subroutines with sort(), thanks to Robin Houston. =head2 Effect of pragmas in eval The compile-time value of the C<%^H> hint variable can now propagate into eval("")uated code. This makes it more useful to implement lexical pragmas. As a side-effect of this, the overloaded-ness of constants now propagates into eval(""). =head2 New B<-E> command-line switch B<-E> is equivalent to B<-e>, but it implicitly enables all optional features (like C). =head2 C, C and C on filehandles C, C and C can now work on filehandles as well as filenames, if the system supports respectively C, C and C, thanks to a patch provided by Gisle Aas. =head2 OS groups C<$(> and C<$)> now return groups in the order where the OS returns them, thanks to Gisle Aas. This wasn't previously the case. =head1 Modules and Pragmata =head2 New Core Modules =over 4 =item * A new pragma, C, has been added; see above in L. =item * C, also available on CPAN, allows the use of assertions on perl versions prior to 5.9.0 (that is the first one to natively support them). =item * C is an XS-enabled, and thus faster, version of C. =item * C is an interface to the zlib compression library. It comes with a bundled version of zlib, so having a working zlib is not a prerequisite to install it. It's used by C (see below). =item * C is an C-style interface to C. =item * C is a module to manipulate C archives. =item * C is a module used to calculate many types of SHA digests, has been included for SHA support in the CPAN module. =item * C and C have been added. =back =head1 Utility Changes =head2 C C is a pure perl implementation of C, that comes with C. =head2 C C is a small script used to generate a diff between the contents of a tar archive and a directory tree. Like C, it comes with C. =head2 C This command-line utility, used to print or to check SHA digests, comes with the new C module. =head2 C enhancements C implements a new option C<--use-xsloader> to force use of C even in backwards compatible modules. The handling of authors' names that had apostrophes has been fixed. Any enums with negative values are now skipped. =head2 C enhancements C no longer checks for F<*.ph> files by default. Use the new C<-a> option to run I tests. =head1 Documentation =head2 Perl Glossary The L manpage is a glossary of terms used in the Perl documentation, technical and otherwise, kindly provided by O'Reilly Media, Inc. L now lists a rough roadmap to Perl 5.10. =head1 Performance Enhancements =head2 XS-assisted SWASHGET Some pure-perl code that perl was using to retrieve Unicode properties and transliteration mappings has been reimplemented in XS. =head2 Constant subroutines The interpreter internals now support a far more memory efficient form of inlineable constants. Storing a reference to a constant value in a symbol table is equivalent to a full typeglob referencing a constant subroutine, but using about 400 bytes less memory. This proxy constant subroutine is automatically upgraded to a real typeglob with subroutine if necessary. The approach taken is analogous to the existing space optimisation for subroutine stub declarations, which are stored as plain scalars in place of the full typeglob. Several of the core modules have been converted to use this feature for their system dependent constants - as a result C now takes about 200K less memory. =head2 C The new compilation flag C, introduced as an option in perl 5.8.8, is turned on by default in perl 5.9.3. It prevents perl from creating an empty scalar with every new typeglob. See L for details. =head2 Weak references are cheaper Weak reference creation is now I rather than I, courtesy of Nicholas Clark. Weak reference deletion remains I, but if deletion only happens at program exit, it may be skipped completely. =head2 sort() enhancements Salvador Fandiño provided improvements to reduce the memory usage of C and to speed up some cases. =head1 Installation and Configuration Improvements =head2 Compilation improvements Parallel makes should work properly now, although there may still be problems if C is instructed to run in parallel. Building with Borland's compilers on Win32 should work more smoothly. In particular Steve Hay has worked to side step many warnings emitted by their compilers and at least one C compiler internal error. Perl extensions on Windows now can be statically built into the Perl DLL, thanks to a work by Vadim Konovalov. =head2 New Or Improved Platforms Perl is being ported to Symbian OS. See L for more information. The VMS port has been improved. See L. DynaLoader::dl_unload_file() now works on Windows. Portability of Perl on various recent compilers on Windows has been improved (Borland C++, Visual C++ 7.0). =head2 New probes C will now detect C and C, thanks to a patch from Alan Burlison. It will also probe for C (and use it internally if available), and whether C correctly returns the length of the formatted string. =head2 Module auxiliary files README files and changelogs for CPAN modules bundled with perl are no longer installed. =head1 Selected Bug Fixes =head2 C C was ignoring taking a hard reference in an argument to defined(), as in : use strict "refs"; my $x = "foo"; if (defined $$x) {...} This now correctly produces the run-time error C. (However, C and C are still allowed. Those constructs are discouraged anyway.) =head2 Calling CORE::require() CORE::require() and CORE::do() were always parsed as require() and do() when they were overridden. This is now fixed. =head2 Subscripts of slices You can now use a non-arrowed form for chained subscripts after a list slice, like in: ({foo => "bar"})[0]{foo} This used to be a syntax error; a C<< -> >> was required. =head2 Remove over-optimisation Perl 5.9.2 introduced a change so that assignments of C to a scalar, or of an empty list to an array or a hash, were optimised out. As this could cause problems when C jumps were involved, this change was backed out. =head2 sprintf() fixes Using the sprintf() function with some formats could lead to a buffer overflow in some specific cases. This has been fixed, along with several other bugs, notably in bounds checking. In related fixes, it was possible for badly written code that did not follow the documentation of C to have formatting vulnerabilities. C has been changed to protect people from poor quality third party code. =head2 no warnings 'category' works correctly with -w Previously when running with warnings enabled globally via C<-w>, selective disabling of specific warning categories would actually turn off all warnings. This is now fixed; now C will only turn off warnings in the C class. Previously it would erroneously turn off all warnings. =head2 Smaller fixes =over 4 =item * C now works better with directories where access rights are more restrictive than usual. =item * Several memory leaks in ithreads were closed. Also, ithreads were made less memory-intensive. =item * Trailing spaces are now trimmed from C<$!> and C<$^E>. =item * Operations that require perl to read a process' list of groups, such as reads of C<$(> and C<$)>, now dynamically allocate memory rather than using a fixed sized array. The fixed size array could cause C stack exhaustion on systems configured to use large numbers of groups. =item * C now works better with non-default C<$/> settings. =item * The C repetition operator is now able to operate on C lists. This used to raise a syntax error. =item * The debugger now traces correctly execution in eval("")uated code that contains #line directives. =item * The value of the C pragma is no longer ignored for three-argument opens. =item * Perl will now use the C library calls C and C if present to delete keys from C<%ENV> and delete C<%ENV> entirely, thanks to a patch from Alan Burlison. =back =head2 More Unicode Fixes =over 4 =item * chr() on a negative value now gives C<\x{FFFD}>, the Unicode replacement character, unless when the C pragma is in effect, where the low eight bytes of the value are used. =item * Some case insensitive matches between UTF-8 encoded data and 8 bit regexps, and vice versa, could give malformed character warnings. These have been fixed by Dave Mitchell and Yves Orton. =item * C and C could corrupt the string for certain cases where the length UTF-8 encoding of the string in lower case, upper case or title case differed. This was fixed by Nicholas Clark. =back =head1 New or Changed Diagnostics =head2 Attempt to set length of freed array This is a new warning, produced in situations like the following one: $r = do {my @a; \$#a}; $$r = 503; =head2 Non-string passed as bitmask This is a new warning, produced when number has been passed as a argument to select(), instead of a bitmask. # Wrong, will now warn $rin = fileno(STDIN); ($nfound,$timeleft) = select($rout=$rin, undef, undef, $timeout); # Should be $rin = ''; vec($rin,fileno(STDIN),1) = 1; ($nfound,$timeleft) = select($rout=$rin, undef, undef, $timeout); =head2 Search pattern not terminated or ternary operator parsed as search pattern This syntax error indicates that the lexer couldn't find the final delimiter of a C construct. Mentioning the ternary operator in this error message makes syntax diagnostic easier. =head2 "%s" variable %s masks earlier declaration This warning is now emitted in more consistent cases; in short, when one of the declarations involved is a C variable: my $x; my $x; # warns my $x; our $x; # warns our $x; my $x; # warns On the other hand, the following: our $x; our $x; now gives a C<"our" variable %s redeclared> warning. =head2 readdir()/closedir()/etc. attempted on invalid dirhandle These new warnings are now emitted when a dirhandle is used but is either closed or not really a dirhandle. =head1 Changed Internals In general, the source code of perl has been refactored, tied up, and optimized in many places. Also, memory management and allocation has been improved in a couple of points. Andy Lester supplied many improvements to determine which function parameters and local variables could actually be declared C to the C compiler. Steve Peters provided new C<*_set> macros and reworked the core to use these rather than assigning to macros in LVALUE context. Dave Mitchell improved the lexer debugging output under C<-DT>. A new file, F, has been added. It contains functions that are no longer used in the perl core, but that remain available for binary or source compatibility reasons. However, those functions will not be compiled in if you add C<-DNO_MATHOMS> in the compiler flags. The C macro has been removed. The C functions, used to manipulate arrays, no longer accept null C parameters. =head2 B:: modules inheritance changed The inheritance hierarchy of C modules has changed; C now inherits from C (it used to inherit from C). =head1 Reporting Bugs If you find what you think is a bug, you might check the articles recently posted to the comp.lang.perl.misc newsgroup and the perl bug database at http://bugs.perl.org/ . There may also be information at http://www.perl.org/ , the Perl Home Page. If you believe you have an unreported bug, please run the B program included with your release. Be sure to trim your bug down to a tiny but sufficient test case. Your bug report, along with the output of C, will be sent off to perlbug@perl.org to be analysed by the Perl porting team. =head1 SEE ALSO The F file for exhaustive details on what changed. The F file for how to build Perl. The F file for general stuff. The F and F files for copyright information. =cut