This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for Term::ReadLine and AE
[perl5.git] / pod / perldelta.pod
index f980613..9c224eb 100644 (file)
@@ -1,26 +1,25 @@
 =encoding utf8
 
 =for comment
 =encoding utf8
 
 =for comment
-This has been completed up to 9ac8a16, except for:
-8629c11317 smueller Escape double-quotes in generated #line directives
-8dc67a69b  shlomif  perl -d: display lines inside subroutines.
-3dfd1b5cd2 leont    Export PerlIOBase_open
+This has been completed up to eb96f3fadee, except for:
+803e389        rurban  CYG17 utf8 paths
+d9298c1        rurban  mymalloc isn't thread safe
 
 =head1 NAME
 
 [ this is a template for a new perldelta file. Any text flagged as
 XXX needs to be processed before release. ]
 
 
 =head1 NAME
 
 [ this is a template for a new perldelta file. Any text flagged as
 XXX needs to be processed before release. ]
 
-perldelta - what is new for perl v5.15.7
+perldelta - what is new for perl v5.15.8
 
 =head1 DESCRIPTION
 
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.15.6 release and
-the 5.15.7 release.
+This document describes differences between the 5.15.7 release and
+the 5.15.8 release.
 
 
-If you are upgrading from an earlier release such as 5.15.5, first read
-L<perl5156delta>, which describes differences between 5.15.5 and
-5.15.6.
+If you are upgrading from an earlier release such as 5.15.6, first read
+L<perl5157delta>, which describes differences between 5.15.6 and
+5.15.7.
 
 =head1 Notice
 
 
 =head1 Notice
 
@@ -34,11 +33,38 @@ here, but most should go in the L</Performance Enhancements> section.
 
 [ List each enhancement as a =head2 entry ]
 
 
 [ List each enhancement as a =head2 entry ]
 
-=head2 C<use charnames> no longer needed for C<\N{I<name>}>
+=head2 Improved ability to mix locales and Unicode, including UTF-8 locales
 
 
-The C<charnames> module is now automatically loaded when needed as if
-the C<:full> and C<:short> options had been specified.  See
-L<charnames>.
+An optional parameter has been added to C<use locale>
+
+ use locale ':not_characters';
+
+which tells Perl to use all but the C<LC_CTYPE> and C<LC_COLLATE>
+portions of the current locale.  Instead, the character set is assumed
+to be Unicode.  This allows locales and Unicode to be seamlessly mixed,
+including the increasingly frequent UTF-8 locales.  When using this
+hybrid form of locales, the C<:locale> layer to the L<open> pragma can
+be used to interface with the file system, and there are CPAN modules
+available for ARGV and environment variable conversions.
+
+Full details are in L<perllocale>.
+
+=head2 New function C<fc> and corresponding escape sequence C<\F> for Unicode foldcase
+
+Unicode foldcase is an extension to lowercase that gives better results
+when comparing two strings case-insensitively.  It has long been used
+internally in regular expression C</i> matching.  Now it is available
+explicitly through the new C<fc> function call (enabled by
+S<C<"use feature 'fc'">>, or C<use v5.16>, or explicitly callable via
+C<CORE::fc>) or through the new C<\F> sequence in double-quotish
+strings.
+
+Full details are in L<perlfunc/fc>.
+
+=head2 C<_> in subroutine prototypes
+
+The C<_> character in subroutine prototypes is now allowed before C<@> or
+C<%>.
 
 =head1 Security
 
 
 =head1 Security
 
@@ -58,25 +84,32 @@ XXX For a release on a stable branch, this section aspires to be:
 
 [ List each incompatible change as a =head2 entry ]
 
 
 [ List each incompatible change as a =head2 entry ]
 
-=head1 Deprecations
+=head2 Special blocks called in void context
 
 
-XXX Any deprecated features, syntax, modules etc. should be listed here.
-In particular, deprecated modules should be listed here even if they are
-listed as an updated module in the L</Modules and Pragmata> section.
+Special blocks (C<BEGIN>, C<CHECK>, C<INIT>, C<UNITCHECK>, C<END>) are now
+called in void context.  This avoids wasteful copying of the result of the
+last statement [perl #108794].
 
 
-[ List each deprecation as a =head2 entry ]
+=head2 The C<overloading> pragma and regexp objects
 
 
-=head2 Deprecated Modules
+With C<no overloading>, regular expression objects returned by C<qr//> are
+now stringified as "Regexp=REGEXP(0xbe600d)" instead of the regular
+expression itself [perl #108780].
 
 
-=over
+=head2 Two XS typemap Entries removed
 
 
-=item L<Version::Requirements>
+Two presumably unused XS typemap entries have been removed from the
+core typemap: T_DATAUNIT and T_CALLBACK. If you are, against all odds,
+a user of these, please see the instructions on how to regain them
+in L<perlxstypemap>.
 
 
-Version::Requirements is now DEPRECATED, use CPAN::Meta::Requirements,
-which is a drop-in replacement. It will be deleted from perl.git blead
-in v5.17.0.
+=head1 Deprecations
 
 
-=back
+XXX Any deprecated features, syntax, modules etc. should be listed here.
+In particular, deprecated modules should be listed here even if they are
+listed as an updated module in the L</Modules and Pragmata> section.
+
+[ List each deprecation as a =head2 entry ]
 
 =head1 Performance Enhancements
 
 
 =head1 Performance Enhancements
 
@@ -89,8 +122,7 @@ may well be none in a stable release.
 
 =item *
 
 
 =item *
 
-Version declarations with the C<use> keyword (e.g., C<use 5.012>) are now
-faster, as they enable features without loading F<feature.pm>.
+XXX
 
 =back
 
 
 =back
 
@@ -122,122 +154,74 @@ XXX
 
 =item *
 
 
 =item *
 
-L<B::Deparse> has been upgraded from version 1.10 to version 1.11.
-
-It now deparses C<open('random string')> correctly.  It used to omit the
-quotation marks, which did not work if the string were not a valid
-identifier [perl #91416].
-
-A similar bug also affected hash and array elements such as
-C<< 'random string'->[0] >>, which would deparse as C<$random string[0]>.
-This has been fixed.
-
-Those same syntaxes used to drop the package name from variables beginning
-with a punctuation mark, as in C<< "foo::]"->{$key} >>.  This, too, has
-been fixed.
-
-B::Deparse no longer hangs when deparsing a program with stash
-circularities, such as C<BEGIN { *Acme::Acme:: = *Acme:: }> [perl #91384].
-
-C</$s[1]/> used to be deparsed as C<$s[1]> if @s were a lexical variable
-[perl #81424].  Similarly, C</$#s/> would be deparsed as C<$#s> for both
-lexical and package variables.  These has been fixed.
+L<B> has been upgraded from version 1.33 to version 1.34.
 
 
-The C</applaud> regular expression flags are no longer omitted.
-
-Feature hints are now deparsed with C<use feature> rather than C<%^H>
-assignments.
-
-A regression in 1.10 that caused C<ambient_pragmas> to disabled strict mode
-in obscure cases has been fixed.
-
-Strict mode is now fully deparsed, including subs and vars [perl #24027].
-
-The global variables C<$(>, C<$|> and C<$)> are now deparsed with braces
-(i.e., C<${(}>) in regular expressions [perl #86060].
+C<B::COP> now has a C<stashflags> method, corresponding to a new internal
+field added in 5.15.4 [perl #108860].
 
 =item *
 
 
 =item *
 
-L<CGI> has been upgraded from version 3.58 to version 3.59.
-
-We no longer read from STDIN when the Content-Length is not set, preventing
-requests with no Content-Length from freezing in some cases. This is consistent
-with the CGI RFC 3875, and is also consistent with CGI::Simple. However, the old
-behavior may have been expected by some command-line uses of CGI.pm.
+L<Compress::Raw::Bzip2> has been upgraded from version 2.045 to version 2.048.
 
 =item *
 
 
 =item *
 
-L<CPAN::Meta> has been upgraded from version 2.112621 to version 2.113640.
-
-Version::Requirements has now been merged as CPAN::Meta::Requirements.
+L<Compress::Raw::Zlib> has been upgraded from version 2.045 to version 2.048.
 
 =item *
 
 
 =item *
 
-L<CPANPLUS> has been upgraded from version 0.9113 to version 0.9116.
+L<Compress::Zlib> has been upgraded from version 2.046 to version 2.048.
 
 =item *
 
 
 =item *
 
-L<POSIX> has been upgraded from version 1.28 to version 1.29.
-C<POSIX::sleep> is now a direct call into the underlying OS C<sleep>
-function, instead of being a Perl wrapper on C<CORE::sleep>. C<POSIX::dup2>
-now returns the correct value on Win32 (I<i.e.> the file descriptor).
-C<POSIX::SigSet> C<sigsuspend> and C<sigpending> and C<POSIX::pause> now
-dispatch safe signals immediately before returning to their caller.
+L<DB_File> has been upgraded from version 1.824 to version 1.826.
 
 =item *
 
 
 =item *
 
-L<Data::Dumper> has been upgraded from version 2.135_01 to version
-2.135_03.
-
-It can now dump vstrings [perl #101162].
+L<diagnostics> has been upgraded from version 1.27 to version 1.28.
 
 
-The nameless typeglob (C<*{""}>) is now dumped properly.
+When searching for F<perldiag.pod>, it no longer uses paths that were only
+relevant on Perl 5.004 and earlier.
 
 =item *
 
 
 =item *
 
-L<diagnostics> has been upgraded from version 1.26 to version 1.27.
+L<ExtUtils::ParseXS> has been upgraded from version 3.12 to version 3.15.
 
 
-See the entry for splain in the L</Utility Changes> section, for the
-changes.  The diagnostics module and the splain utility are actually one
-and the same.
+The new version comes with important tools for sharing typemaps between
+different CPAN distributions.
 
 =item *
 
 
 =item *
 
-L<Module::Pluggable> has been upgraded from version 3.9 to version 4.0.
+L<IPC::Cmd> has been upgraded from version 0.72 to version 0.76.
 
 =item *
 
 
 =item *
 
-L<POSIX> has been upgraded from version 1.27 to version 1.28.
+L<Math::Complex> has been upgraded from version 1.58 to version 1.59.
 
 
-C<sigsuspend> and C<pause> now run signals handle before returning, as the
-whole point of these two functions is to wait until a signal has
-arrived, and then return I<after> it has been triggered.  Delayed, or
-"safe", signals were preventing that from happening, possibly resulting in
-race conditions [perl #107216].
+This avoids a new core warning.
 
 =item *
 
 
 =item *
 
-L<Term::UI> has been upgraded from version 0.26 to version 0.30.
+L<Pod::Parser> has been upgraded from version 1.37 to version 1.51.
 
 =item *
 
 
 =item *
 
-L<Tie::File> has been upgraded from version 0.96 to version 0.98.
+L<Term::ReadLine> has been upgraded from version 1.07 to version 1.08.
+
+Its C<tkRunning> method now supports L<AnyEvent> event loops, and not just
+L<Tk>.  A more general mechanism has been proposed, so this may be reverted
+before Perl 5.16 [perl #108470].
 
 =item *
 
 
 =item *
 
-L<Unicode::UCD> has been upgraded from version 0.37 to version 0.38.
-This changes the output of C<prop_invmap()> for the Name_Alias property
-to reflect the changes that are planned for Unicode 6.1, so that there
-won't be a format change when upgrading to 6.1.  Briefly, a second
-component of each alias is added that gives the type of alias it is.
-Examples are at L<Unicode::UCD/prop_invmap()>.
+L<Time::HiRes>  has been upgraded from version 1.9724 to version 1.9725.
+
+C<Time::HiRes::stat()> no longer corrupts the Perl stack.
 
 =item *
 
 
 =item *
 
-L<Version::Requirements> has been upgraded from version 0.101020 to version 0.101021.
+L<Unicode::UCD> has been upgraded from version 0.39 to 0.40.
 
 
-Version::Requirements is now DEPRECATED, use CPAN::Meta::Requirements,
-which is a drop-in replacement.
+The only change is to fix a formatting error in the Pod.
 
 =back
 
 
 =back
 
@@ -260,6 +244,12 @@ file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 
 XXX Changes which create B<new> files in F<pod/> go here.
 
 
 XXX Changes which create B<new> files in F<pod/> go here.
 
+=head3 L<perlxstypemap>
+
+The new manual describes the XS typemapping mechanism in unprecedented
+detail and combines new documentation with information extracted from
+L<perlxs> and the previously unofficial list of all core typemaps.
+
 =head3 L<XXX>
 
 XXX Description of the purpose of the new file here
 =head3 L<XXX>
 
 XXX Description of the purpose of the new file here
@@ -307,17 +297,7 @@ XXX Newly added diagnostic messages go here
 
 =item *
 
 
 =item *
 
-L<Cannot set tied @DB::args|perldiag/"Cannot set tied @DB::args">
-
-This error occurs when C<caller> tries to set C<@DB::args> but finds it
-tied.  Before this error was added, it used to crash instead.
-
-=item *
-
-L<Cannot tie unreifiable array|perldiag/"Cannot tie unreifiable array">
-
-This error is part of a safety check that the C<tie> operator does before
-tying a special array like C<@_>.  You should never see this message.
+XXX L<message|perldiag/"message">
 
 =back
 
 
 =back
 
@@ -352,35 +332,13 @@ here. Most of these are built within the directories F<utils> and F<x2p>.
 entries for each change
 Use L<XXX> with program names to get proper documentation linking. ]
 
 entries for each change
 Use L<XXX> with program names to get proper documentation linking. ]
 
-=head3 L<splain>
+=head3 L<XXX>
 
 =over 4
 
 =item *
 
 
 =over 4
 
 =item *
 
-splain no longer emits backtraces with the first line number repeated.
-This:
-
-    Uncaught exception from user code:
-            Cannot fwiddle the fwuddle at -e line 1.
-     at -e line 1
-            main::baz() called at -e line 1
-            main::bar() called at -e line 1
-            main::foo() called at -e line 1
-
-has become this:
-
-    Uncaught exception from user code:
-            Cannot fwiddle the fwuddle at -e line 1.
-            main::baz() called at -e line 1
-            main::bar() called at -e line 1
-            main::foo() called at -e line 1
-
-=item *
-
-Some error message consist of multiple lines that are listed as separate
-entries in L<perldiag>.  splain has been taught to find the separate
-entries in these cases, instead of simply failing to find the message.
+XXX
 
 =back
 
 
 =back
 
@@ -397,11 +355,7 @@ L</Platform Support> section, instead.
 
 =item *
 
 
 =item *
 
-The Pod files for the perl FAQ, L<perlxs>, L<perlxstut> and L<perldoc>
-are once again correctly installed in the same directory as the other core
-Pods.
-
-=for 5.16.0 This isn't a regression from 5.14.x, so don't mention this.
+XXX
 
 =back
 
 
 =back
 
@@ -419,11 +373,12 @@ that they represent may be covered elsewhere.
 
 =item *
 
 
 =item *
 
-F<t/porting/utils.t> now tests that various utility scripts compile cleanly.
-During development, this avoids the embarrassment of inadvertently pushing a
-commit which breaks code which isn't otherwise tested by the regression test
-suite. For example, F<installperl> and F<installman>, needed by
-C<make install>, are tested here.
+XXX
+
+=item *
+
+The test suite for typemaps has been extended to cover a larger fraction of
+the core typemaps.
 
 =back
 
 
 =back
 
@@ -488,26 +443,7 @@ be noted as well.
 
 =item *
 
 
 =item *
 
-There are now feature bundle hints in C<PL_hints> (C<$^H>) that version
-declarations use, to avoid having to load F<feature.pm>.  One setting of
-the hint bits indicates a "custom" feature bundle, which means that the
-entries in C<%^H> still apply.  F<feature.pm> uses that.
-
-The C<HINT_FEATURE_MASK> macro is defined in F<perl.h> along with other
-hints.  Other macros for setting and testing features and bundles are in
-the new F<feature.h>.  C<FEATURE_IS_ENABLED> (which has moved to
-F<feature.h>) is no longer used throughout the codebase, but more specific
-macros, e.g., C<FEATURE_SAY_IS_ENABLED>, that are defined in F<feature.h>.
-
-=item *
-
-F<lib/feature.pm> is now a generated file, created by the new
-F<regen/feature.pl> script, which also generates F<feature.h>.
-
-=item *
-
-Tied arrays are now always C<AvREAL>.  If C<@_> or C<DB::args> is tied, it
-is reified first, to make sure this is always the case.
+XXX
 
 =back
 
 
 =back
 
@@ -521,162 +457,61 @@ L</Modules and Pragmata>.
 
 =over 4
 
 
 =over 4
 
-=item * "b . COND" in the debugger has been fixed
-
-Breaking on the current line with C<b . COND> was broken by previous work and
-has now been fixed.
-
-=item * Tying C<%^H>
-
-Tying C<%^H> no longer causes perl to crash or ignore
-the contents of C<%^H> when entering a compilation
-scope [perl #106282].
-
-=item * C<~> on vstrings
-
-The bitwise complement operator (and possibly other operators, too) when
-passed a vstring would leave vstring magic attached to the return value,
-even though the string had changed.  This meant that
-C<< version->new(~v1.2.3) >> would create a version looking like "v1.2.3"
-even though the string passed to C<< version->new >> was actually
-"\376\375\374".  This also caused L<B::Deparse> to deparse C<~v1.2.3>
-incorrectly, without the C<~> [perl #29070].
-
-=item * Vstrings blowing away magic
-
-Assigning a vstring to a magic (e.g., tied, C<$!>) variable and then
-assigning something else used to blow away all the magic.  This meant that
-tied variables would come undone, C<$!> would stop getting updated on
-failed system calls, C<$|> would stop setting autoflush, and other
-mischief would take place.  This has been fixed.
-
-=item * C<newHVhv> and tied hashes
-
-The C<newHVhv> XS function now works on tied hashes, instead of crashing or
-returning an empty hash.
-
-=item * Hashes will null elements
-
-It is possible from XS code to create hashes with elements that have no
-values.  Perl itself sometimes creates such hashes, but they are rarely
-visible to Perl code.  The hash element and slice operators used to crash
-when handling these in lvalue context.  These have been fixed.  They now
-produce a "Modification of non-creatable hash value attempted" error
-message.
-
-=item * No warning for C<open(foo::bar)>
-
-When one writes C<open foo || die>, which used to work in Perl 4, a
-"Precedence problem" warning is produced.  This warning used erroneously to
-apply to fully-qualified bareword handle names as well.  This has been
-corrected.
-
-=item * C<select> and package aliasing
-
-After package aliasing (C<*foo:: = *bar::>), C<select> with 0 or 1 argument
-would sometimes return a name that could not be used to refer to the
-filehandle, or sometimes it would return C<undef> even when a filehandle
-was selected.  Now it returns a typeglob reference in such cases.
-
-=item * C<PerlIO::get_layers> and tied variables
-
-C<PerlIO::get_layers> no longer ignores FETCH on tied variables as it used
-to most of the time [perl #97956].
-
-=item * C<PerlIO::get_layers> and numbers
-
-C<PerlIO::get_layers> no longer ignores some arguments that it thinks are
-numeric, while treating others as filehandle names.  It is now consistent
-for flat scalars (i.e., not references).
-
-=item * Lvalue subs and strict mode
-
-Lvalue sub calls that are not determined to be such at compile time
-(C<&$name> or &{"name"}) are no longer exempt from strict refs if they
-occur in the last statement of an lvalue subroutine [perl #102486].
-
-=item * Non-lvalue sub calls in potentially lvalue context
-
-Sub calls whose subs are not visible at compile time, if
-they occurred in the last statement of an lvalue subroutine,
-would reject non-lvalue subroutines and die with "Can't modify non-lvalue
-subroutine call" [perl #102486].
-
-Non-lvalue sub calls whose subs I<are> visible at compile time exhibited
-the opposite bug.  If the call occurred in the last statement of an lvalue
-subroutine, there would be no error when the lvalue sub was called in
-lvalue context.  Perl would blindly assign to the temporary value returned
-by the non-lvalue subroutine.
-
-=item * AUTOLOADing lvalue subs
-
-C<AUTOLOAD> routines used to take precedence over the actual sub being
-called (i.e., when autoloading wasn't needed), for sub calls in lvalue or
-potential lvalue context, if the subroutine was not visible at compile
-time.
-
-=item * C<caller> and tied C<@DB::args>
+=item *
 
 
-C<caller> sets C<@DB::args> to the subroutine arguments when called from
-the DB package.  It used to crash when doing so if C<@DB::args> happened to
-be tied.  Now it croaks instead.
+C<~~> now correctly handles the precedence of Any~~Object, and is not tricked
+by an overloaded object on the left-hand side.
 
 
-=item * Tying C<@_>
+=item *
 
 
-Under debugging builds, this code:
+C<stat _> no longer warns about unopened filehandles [perl #71002].
 
 
-  sub TIEARRAY{bless[]}
-  sub {
-    tie @_, "";
-    \@_;
-  }->(1);
+=item *
 
 
-use to produce an "av_reify called on tied array" warning.  It doesn't any
-more.
+C<stat> on an unopened filehandle now warns consistently, instead of
+skipping the warning at times.
 
 
-=item * Unrecognised switches on C<#!> line
+=item *
 
 
-If a switch, such as B<-x>, that cannot occur on the C<#!> line is used
-there, perl dies with "Can’t emulate...".
+A change in an earlier 5.15 release caused warning hints to propagate into
+C<do $file>.  This has been fixed [rt.cpan.org #72767].
 
 
-It used to produce the same message for switches that perl did not
-recognise at all, whether on the command line or the C<#!> line.
+=item *
 
 
-Now it produces the "Unrecognized switch" error message [perl #104288].
+Starting with 5.12.0, Perl used to get its internal bookkeeping muddled up
+after assigning C<${ qr// }> to a hash element and locking it with
+L<Hash::Util>.  This could result in double frees, crashes or erratic
+behaviour.
 
 
-=item * C<system> and SIGCHLD
+=item *
 
 
-C<system> now temporarily blocks the SIGCHLD signal handler, to prevent the
-signal handler from stealing the exit status [perl #105700].
+In 5.15.7, some typeglobs in the CORE namespace were made read-only by
+mistake.  This has been fixed [rt.cpan.org #74289].
 
 
-=item * Deleting methods via C<delete>
+=item *
 
 
-Deletion of methods via C<delete $Class::{method}> syntax used to update
-method caches if called in void context, but not scalar or list context.
-Now it always updates those caches.
+C<-t> now works when stacked with other filetest operators [perl #77388].
 
 
-=item * Hash element deletion and destructors
+=item *
 
 
-When hash elements are deleted in void context, the internal hash entry is
-now freed before the value is freed, to prevent destructors call by that
-latter freeing from seeing the hash in an inconsistent state.  It was
-possible to cause double-frees if the destructor freed the hash itself
-[perl #100340].
+Stacked filetest operators now only call FETCH once on a tied argument.
 
 
-=item * C<(s)printf>'s %n formatting code
+=item *
 
 
-The %n formatting code, which causes the number of characters to be
-assigned to the next argument to C<printf> or C<sprintf> now actually
-assigns the number of characters, instead of the number of bytes.
+C</.*/g> would sometimes refuse to match at the end of a string that ends
+with "\n".  This has been fixed [perl #109206].
 
 
-It also works now with special lvalue functions like C<substr> and with
-nonexistent hash and array elements [perl #103492].
+=item *
 
 
-=item * Typeglobs and threads
+Method calls whose arguments were all surrounded with C<my()> or C<our()>
+(as in C<<$object->method(my($a,$b)) >>) used to force lvalue context on
+the subroutine.  This would prevent lvalue methods from returning certain
+values.  Due to lvalue fixes earlier in the 5.15.x series, it would also
+prevent non-lvalue methods from being called [perl #109264].
 
 
-Typeglobs returned from threads are no longer cloned if the parent thread
-already has a glob with the same name.  This means that returned
-subroutines will now assign to the right package variables [perl #107366].
+=for comment
+This bug I<did> affect earlier stable releases.  It is just the last
+sentence that does not apply to 5.14.
 
 =back
 
 
 =back
 
@@ -708,7 +543,7 @@ here.
 
 XXX Generate this with:
 
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.15.6..HEAD
+  perl Porting/acknowledgements.pl v5.15.7..HEAD
 
 =head1 Reporting Bugs
 
 
 =head1 Reporting Bugs