Removing pod boilerplate

[perl5.git] / pod / perl5113delta.pod

=head1 NAME

perldelta - what is new for perl v5.11.3

=head1 DESCRIPTION

This document describes differences between the 5.11.2 release and
the 5.11.3 release.

If you are upgrading from an earlier release such as 5.11.1, first read
the L<perl5112delta>, which describes differences between 5.11.1 and
5.11.2

=head1 Incompatible Changes

=over

=item Filehandles are blessed directly into C<IO::Handle::>, as C<FileHandle> is merely a wrapper around C<IO::Handle>.

The previous behaviour was to bless Filehandles into L<FileHandle/>
(an empty proxy class) if it was loaded into memory and otherwise
to bless them into C<IO::Handle::>.


=back

=head1 Core Enhancements

=head2 Unicode version

Perl is shipped with the latest Unicode version, 5.2, October 2009.  See
L<http://www.unicode.org/versions/Unicode5.2.0> for details about this release
of Unicode.  See L<perlunicode> for instructions on installing and using
older versions of Unicode.

=head2 Unicode properties

Perl can now handle every Unicode character property.  A new pod,
L<perluniprops>, lists all available non-Unihan character properties.  By
default the Unihan properties and certain others (deprecated and Unicode
internal-only ones) are not exposed.  See below for more details on
these; there is also a section in the pod listing them, and why they are
not exposed.

Perl now fully supports the Unicode compound-style of using C<=> and C<:>
in writing regular expressions: C<\p{property=value}> and
C<\p{property:value}> (both of which mean the same thing).

Perl now fully supports the Unicode loose matching rules for text
between the braces in C<\p{...}> constructs.  In addition, Perl also allows
underscores between digits of numbers.

All the Unicode-defined synonyms for properties and property values are
now accepted.

C<qr/\X/>, which matches a Unicode logical character, has been expanded to work
better with various Asian languages.  It now is defined as an C<extended
grapheme cluster>.  (See L<http://www.unicode.org/reports/tr29/>).  One change
due to this is that C<\X> will match the whole sequence C<S<CR LF>>.  Another
change is that C<\X> will match an isolated mark.  Marks generally come after a
base character, but it is possible in Unicode to have them in isolation, and
C<\X> will now handle that case.  Otherwise, this change should be transparent
for non-affected languages.

C<\p{...}> matches using the Canonical_Combining_Class property were
completely broken in previous Perls.  This is now fixed.

In previous Perls, the Unicode Decomposition_Type=Compat property and a
Perl extension had the same name, which led to neither matching all the
correct values (with more than 100 mistakes in one, and several thousand
in the other).  The Perl extension has now been renamed to be
Decomposition_Type=Noncanonical (short: dt=noncanon).  It has the same
meaning as was previously intended, namely the union of all the
non-canonical Decomposition types, with Unicode Compat being just one of
those.

C<\p{Uppercase}> and C<\p{Lowercase}> have been brought into line with the
Unicode definitions.  This means they each match a few more characters
than previously.

C<\p{Cntrl}> now matches the same characters as C<\p{Control}>.  This means it
no longer will match Private Use (gc=co), Surrogates (gc=cs), nor Format
(gc=cf) code points.  The Format code points represent the biggest
possible problem.  All but 36 of them are either officially deprecated
or strongly discouraged from being used.  Of those 36, likely the most
widely used are the soft hyphen (U+00AD), and BOM, ZWSP, ZWNJ, WJ, and
similar, plus Bi-directional controls.

C<\p{Alpha}> now matches the same characters as C<\p{Alphabetic}>.  The Perl
definition included a number of things that aren't really alpha (all
marks), while omitting many that were.  The Unicode definition is
clearly better, so we are switching to it.  As a direct consequence, the
definitions of C<\p{Alnum}> and C<\p{Word}> which depend on Alpha also change.

C<\p{Word}> also now doesn't match certain characters it wasn't supposed
to, such as fractions.

C<\p{Print}> no longer matches the line control characters: tab, lf, cr,
ff, vt, and nel.  This brings it in line with the documentation.

C<\p{Decomposition_Type=Canonical}> now includes the Hangul syllables

The Numeric type property has been extended to include the Unihan
characters.

There is a new Perl extension, the 'Present_In', or simply 'In'
property.  This is an extension of the Unicode Age property, but
C<\p{In=5.0}> matches any code point whose usage has been determined as of
Unicode version 5.0.  The C<\p{Age=5.0}> only matches code points added in 5.0.

A number of properties did not have the correct values for unassigned
code points.  This is now fixed.  The affected properties are
Bidi_Class, East_Asian_Width, Joining_Type, Decomposition_Type,
Hangul_Syllable_Type, Numeric_Type, and Line_Break.

The Default_Ignorable_Code_Point, ID_Continue, and ID_Start properties
have been updated to their current definitions.

Certain properties that are supposed to be Unicode internal-only were
erroneously exposed by previous Perls.  Use of these in regular
expressions will now generate a deprecated warning message, if those
warnings are enabled.  The properties are: Other_Alphabetic,
Other_Default_Ignorable_Code_Point, Other_Grapheme_Extend,
Other_ID_Continue, Other_ID_Start, Other_Lowercase, Other_Math, and
Other_Uppercase.

An installation can now fairly easily change which Unicode properties
Perl understands.  As mentioned above, certain properties are by default
turned off.  These include all the Unihan properties (which should be
accessible via the CPAN module Unicode::Unihan) and any deprecated or
Unicode internal-only property that Perl has never exposed.

XXX what does "files in the To directory" mean? -- dagolden, 2009-12-20

The files in the To directory are now more clearly marked as being
stable, directly usable by applications.  New hash entries in them give
the format of the normal entries which allows for easier machine
parsing.  Perl can generate files in this directory for any property,
though most are suppressed.  An installation can choose to change which
get written.   Instructions are in L<perluniprops>.

=head1 Modules and Pragmata

=head2 Pragmata Changes

=over 4

=item C<constant>

Upgraded from version 1.19 to 1.20.

=item C<diagnostics>

This pragma no longer suppresses C<Use of uninitialized value in range (or flip)> warnings. [perl #71204]

=item C<feature>

Upgraded from 1.13 to 1.14.  Added the C<unicode_strings> feature:

    use feature "unicode_strings";

This pragma turns on Unicode semantics for the case-changing operations
(uc/lc/ucfirst/lcfirst) on strings that don't have the internal UTF-8 flag set,
but that contain single-byte characters between 128 and 255.

=item C<legacy>

The experimental C<legacy> pragma, introduced in 5.11.2, has been removed,
and its functionality replaced by the new feature pragma, C<use feature
"unicode_strings">.

=item C<threads>

Upgraded from version 1.74 to 1.75.

=item C<warnings>

Upgraded from 1.07 to 1.08.  Added new C<warnings::fatal_enabled()> function.

=back

=head2 Updated Modules

=over 4

=item C<Archive::Extract>

Upgraded from version 0.34 to 0.36.

=item C<CPAN>

Upgraded from version 1.94_51 to 1.94_53.  Includes better bzip2 support,
improved FirstTime experience with auto-selection of CPAN mirrors, proper
handling of modules removed from the Perl core, and an updated 'cpan'
utility script

=item C<CPANPLUS>

Upgraded from version 0.89_09 to 0.90.

=item C<ExtUtils::MakeMaker>

Upgraded from version 6.55_02 to 6.56.  Adds new BUILD_REQUIRES key to
indicate build-only prerequisites.  Also adds support for
mingw64 and the new "package NAME VERSION" syntax.

=item C<File::Path>

Upgraded from version 2.08 to 2.08_01.

=item C<Module::Build>

Upgraded from version 0.35_09 to 0.36.  Compared to 0.35, this version has a
new 'installdeps' action, supports the PERL_MB_OPT environment variable, adds a
'share_dir' property for L<File::ShareDir> support, support the "package NAME
VERSION" syntax and has many other enhancements and bug fixes.  The
'passthrough' style of Module::Build::Compat has been deprecated.

=item C<Module::CoreList>

Upgraded from version 2.23 to 2.24.

=item C<POSIX>

Upgraded from version 1.18 to 1.19. Error codes for C<getaddrinfo()> and C<getnameinfo()> are now
available.

=item C<Pod::Simple>

Upgraded from version 3.10 to 3.13.

=item C<Safe>

Upgraded from version 2.19 to 2.20.

=back

=head1 Utility Changes

=over 4

=item F<perlbug>

No longer reports "Message sent" when it hasn't actually sent the message

=back

=head1 Changes to Existing Documentation

The Pod specification (L<perlpodspec>) has been updated to bring the
specification in line with modern usage already supported by most Pod systems.
A parameter string may now follow the format name in a "begin/end" region.
Links to URIs with a text description are now allowed.  The usage of
C<LE<lt>"section"E<gt>> has been marked as deprecated.

L<if.pm|if> has been documented in L<perlfunc/use> as a means to get
conditional loading of modules despite the implicit BEGIN block around C<use>.



=head1 Installation and Configuration Improvements

XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
go here.

=head2 Configuration improvements

XXX

=head2 Compilation improvements

    Make distclean work again
XXX

=head2 Testing improvements

=over 4

=item It's now possible to override C<PERL5OPT> and friends in F<t/TEST>

=back

=head2 Platform Specific Changes

=over 4

=item Win32

=over 4

=item *

Always add a manifest resource to C<perl.exe> to specify the <trustInfo>
settings for Windows Vista and later.  Without this setting Windows
will treat C<perl.exe> as a legacy application and apply various
heuristics like redirecting access to protected file system areas
(like the "Program Files" folder) to the users "VirtualStore"
instead of generating a proper "permission denied" error.

For VC8 and VC9 this manifest setting is automatically generated by
the compiler/linker (together with the binding information for their
respective runtime libraries); for all other compilers we need to
embed the manifest resource explicitly in the external resource file.

This change also requests the Microsoft Common-Controls version 6.0
(themed controls introduced in Windows XP) via the dependency list
in the assembly manifest.  For VC8 and VC9 this is specified using the
C</manifestdependency> linker commandline option instead.

=back

=item cygwin

=over 4

=item Enable IPv6 support on cygwin 1.7 and newer

=back

=item OpenVMS

=over 4

=item Make -UDEBUGGING the default on VMS for 5.12.0.

Like it has been everywhere else for ages and ages.  Also make
command-line selection of -UDEBUGGING and -DDEBUGGING work in
configure.com; before the only way to turn it off was by saying
no in answer to the interactive question.

=back

=back

=head1 Selected Bug Fixes

XXX Important bug fixes in the core language are summarised here.
Bug fixes in files in F<ext/> and F<lib/> are best summarised in
L</Modules and Pragmata>.

=over 4

=item *

Ensure that pp_qr returns a new regexp SV each time. Resolves RT #69852.

Instead of returning a(nother) reference to the (pre-compiled) regexp in the
optree, use reg_temp_copy() to create a copy of it, and return a reference to
that. This resolves issues about Regexp::DESTROY not being called in a timely
fashion (the original bug tracked by RT #69852), as well as bugs related to
blessing regexps, and of assigning to regexps, as described in correspondence
added to the ticket.

It transpires that we also need to undo the SvPVX() sharing when ithreads
cloning a Regexp SV, because mother_re is set to NULL, instead of a cloned
copy of the mother_re. This change might fix bugs with regexps and threads in
certain other situations, but as yet neither tests nor bug reports have
indicated any problems, so it might not actually be an edge case that it's
possible to reach.

=item  *

Several compilation errors and segfaults when perl was built with C<-Dmad> were fixed.

=item *

Fixes for lexer API changes in 5.11.2 which broke NYTProf's savesrc option.

=item *

F<-t> should only return TRUE for file handles connected to a TTY

The Microsoft C version of isatty() returns TRUE for all
character mode devices, including the /dev/null style "nul"
device and printers like "lpt1".

=item *

Fixed a regression caused by commit fafafbaf which caused a panic during parameter passing [perl #70171]


=item *

On systems which in-place edits without backup files, -i'*' now works as the documentation says it does [perl #70802]

=item *

Numerous bugfixes catch small issues caused by the recently-added Lexer API.

=item *

Smart match against C<@_> sometimes gave false negatives negatives. [perl #71078]

=item *

C<$@> may now be assigned a read-only value (without error or busting the stack).

=back

=head1 New or Changed Diagnostics

XXX New or changed warnings emitted by the core's C<C> code go here.

=over 4

=item C<XXX>

    Make split warn in void context
XXX

=back

=head1 Changed Internals

XXX Changes which affect the interface available to C<XS> code go here.

=over 4

=item *

XXX

=back

=head1 New Tests

Many modules updated from CPAN incorporate new tests.

=over 4

=item t/comp/final_line_num.t

See if line numbers are correct at EOF

=item t/comp/form_scope.t

See if format scoping works

=item t/comp/line_debug.t

See if @{"_<$file"} works

=item t/op/filetest_t.t

See if -t file test works

=item t/op/qr.t

See if qr works

=item t/op/utf8cache.t

Tests malfunctions of utf8 cache

=item t/re/uniprops.t

Test unicode \p{} regex constructs

=back

=head1 Known Problems

XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
tests that had to be C<TODO>ed for the release would be noted here, unless
they were specific to a particular platform (see below).

This is a list of some significant unfixed bugs, which are regressions
from either 5.11.3 or 5.11.3.

=over 4

=item *

XXX

=back

=head1 Deprecations

XXX Add any new known deprecations here.

The following items are now deprecated.

=over 4

=item Use of "goto" to jump into a construct is deprecated

Using C<goto> to jump from an outer scope into an inner
scope is now deprecated. This rare use case was causing
problems in the implementation of scopes.

=back

=head1 Platform Specific Notes

XXX Any changes specific to a particular platform. VMS and Win32 are the usual
stars here. It's probably best to group changes under the same section layout
as the main perldelta

=head1 Obituary

XXX If any significant core contributor has died, we've added a short obituary
here.

=head1 Acknowledgements

XXX The list of people to thank goes here.


=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://rt.perl.org/perlbug/ .  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<perlbug>
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<perl -V>, will be sent off to perlbug@perl.org to be
analysed by the Perl porting team.

If the bug you are reporting has security implications, which make it
inappropriate to send to a publicly archived mailing list, then please send
it to perl5-security-report@perl.org. This points to a closed subscription
unarchived mailing list, which includes all the core committers, who be able
to help assess the impact of issues, figure out a resolution, and help
co-ordinate the release of patches to mitigate or fix the problem across all
platforms on which Perl is supported. Please only use this address for
security issues in the Perl core, not for modules independently
distributed on CPAN.

=head1 SEE ALSO

The F<Changes> file for an explanation of how to view exhaustive details
on what changed.

The F<INSTALL> file for how to build Perl.

The F<README> file for general stuff.

The F<Artistic> and F<Copying> files for copyright information.

=cut




All changes through commit b4178430270dbe109e7609d0b50d6d54bf9e95d8
One "triage" pass done.

A second triage pass is still needed to remove unimportant changes

commit 9307c420fad2f6f5bd314f9ed66dd53288703e09
Author: Jan Dubois <jand@activestate.com>
Date:   Thu Dec 17 18:28:16 2009 -0800

    Export PL_curinterp symbol for MULTIPLICITY without USE_ITHREADS

    This is necessary for XS extensions that define PERL_CORE.  In that
    situation PERL_GET_CONTEXT will resolve to PL_curinterp, which is
    normally not exported (extensions call Perl_Gcurinterp_ptr() to get a
    pointer to PL_curinterp instead). With USE_ITHREADS defined
    PERL_GET_CONTEXT will expand to Perl_get_context() even inside the
    core because the context needs to be fetched from threadlocal storage.

commit 2ab54efd6265713df5cd4bd0927024245675c1c2

    fix bug 67156: overload: nomethod(..., '!') return value inverted

commit 69dc4b30f4725ad5f212d45d3c856ac1caaacf17
Author: Father Chrysostomos <sprout@cpan.org>
Date:   Mon Dec 14 12:19:35 2009 +0100

    [perl #70764] $' fails to initialized for pre-compiled regular expression matches

    The match vars are associated with the regexp that last matched
    successfully. In the case of $str =~ $qr or /$qr/, since the $qr could
    be used in multiple scopes that need their own sets of match vars, the
    $qr is cloned by Perl_reg_temp_copy as of change 30677/28d8d7f. This
    happens in pp_regcomp before pp_match has stringified the LHS, hence the
    bug. In short, /$gror/ is not equivalent to
    ($which = !$which) ? /$gror/ : /$gror/, which is weird.



    Document config_args limitations reported in [perl #70912]

    proper error on "grep $x (1,2,3)". Solves [perl #37314]

commit 8a27a13e89107aaf68c0748b68ee71fbd86d774b

    [perl #71076] sort with active sub (5.10 regression)

    One of the tests in sort.t causes a bus error (or sometimes â\80\98Undefined
    subroutine calledâ\80\99) if run multiple times. This is because sort
    decreases the refcount of an active sub used as a comparison routine.

commit 69c3dccf5322a59cb855347c04712ba11b65328f



    [perl #71000] Wrong variable name in warning ; Add a new warning "Missing argument in %s"

    preserve readonly flag when saving and restoring magic flags

commit 576b33a19ccaf98d4dfe201d529c55c3747f0cb6

    [rt.cpan.org #51574] Safe.pm sort {} bug accessing $a and $b with -Dusethreads

commit ee6ba15dedda3e88eb66891eaf387c00a4c0a2fb

    Fix -DPERL_NO_UTF16_FILTER