=encoding utf8
-=for comment
-A Windows-specific commit that may need mention (does this have any
-user-visible effects?):
-0c38a57 Remove exports of dummy set[ug]id functions on Windows
-
=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.17.5
+perldelta - what is new for perl v5.17.7
=head1 DESCRIPTION
-This document describes differences between the 5.17.4 release and the 5.17.5
+This document describes differences between the 5.17.6 release and the 5.17.7
release.
-If you are upgrading from an earlier release such as 5.17.3, first read
-L<perl5174delta>, which describes differences between 5.17.3 and 5.17.4.
+If you are upgrading from an earlier release such as 5.17.5, first read
+L<perl5176delta>, which describes differences between 5.17.5 and 5.17.6.
=head1 Notice
[ List each enhancement as a =head2 entry ]
-=head2 Upgrade to Unicode 6.2
-
-Perl now supports the final version of Unicode 6.2. Earlier releases in
-the 5.17 series supported Unicode 6.2 beta versions. There were no
-substantive changes in the final Unicode 6.2 version from the most
-recent beta, included in Perl 5.17.4. A list of changes from Unicode
-6.1 is at L<http://www.unicode.org/versions/Unicode6.2.0>.
-
=head1 Security
XXX Any security-related notices go here. In particular, any security
=head1 Incompatible Changes
-XXX For a release on a stable branch, this section aspires to be:
-
- There are no changes intentionally incompatible with 5.XXX.XXX
- If any exist, they are bugs, and we request that you submit a
- report. See L</Reporting Bugs> below.
-
-[ List each incompatible change as a =head2 entry ]
-
-=head2 New Restrictions in Multi-Character Case-Insensitive Matching in Regular Expression Bracketed Character Classes
-
-Unicode has now withdrawn their previous recommendation for regular
-expressions to automatically handle cases where a single character can
-match multiple characters case-insensitively; for example, the letter
-LATIN SMALL LETTER SHARP S and the sequence C<ss>. This is because
-it turns out to be impracticable to do this correctly in all
-circumstances. Because Perl has tried to do this as best it can, it
-will continue to do so. (We are considering an option to turn it off.)
-However, a new restriction is being added on such matches when they
-occur in [bracketed] character classes. People were specifying
-things such as C</[\0-\xff]/i>, and being surprised that it matches the
-two character sequence C<ss> (since LATIN SMALL LETTER SHARP S occurs in
-this range). This behavior is also inconsistent with the using a
-property instead of a range: C<\p{Block=Latin1}> also includes LATIN
-SMALL LETTER SHARP S, but C</[\p{Block=Latin1}]/i> does not match C<ss>.
-The new rule is that for there to be a multi-character case-insensitive
-match within a bracketed character class, the character must be
-explicitly listed, and not as an end point of a range. This more
-closely obeys the Principle of Least Astonishment. See
-L<perlrecharclass/Bracketed Character Classes>. Note that a bug [perl
-#89774], now fixed as part of this change, prevented the previous
-behavior from working fully.
-
-=head2 Change to Warnings About Lexical Subroutines
-
-The warnings category for lexical subroutines is now
-"experimental::lexical_subs", with two colons, not
-"experimental:lexical_subs";
+=head2 readline() with C<$/ = \N> now reads N characters, not N bytes
+
+Previously, when reading from a stream with I/O layers such as
+C<encoding>, the readline() function, otherwise known as the C<< <> >>
+operator, would read I<N> bytes from the top-most layer. [perl #79960]
+
+Now, I<N> characters are read instead.
+
+There is no change in behaviour when reading from streams with no
+extra layers, since bytes map exactly to characters.
+
+=head2 Lexical subroutine warnings have moved
+
+The warning about the use of an experimental feature emitted when lexical
+subroutines (added in 5.17.4) are used now happens when the subroutine
+itself is declared, not when the "lexical_subs" feature is activated via
+C<use feature>.
+
+This stops C<use feature ':all'> from warning, but causes
+C<my sub foo; my sub bar> to warn twice.
=head1 Deprecations
[ List each deprecation as a =head2 entry ]
+=head2 Various XS-callable functions are now deprecated
+
+The following functions will be removed from a future version of Perl,
+and should not be used. With participating C compilers (e.g., gcc),
+compiling any file that uses any of these will generate a warning.
+These were not intended for public use; there are equivalent, faster,
+macros for most of them. See L<perlapi/Character classes>:
+C<is_uni_ascii>,
+C<is_uni_ascii_lc>,
+C<is_uni_blank>,
+C<is_uni_blank_lc>,
+C<is_uni_cntrl>,
+C<is_uni_cntrl_lc>,
+C<is_uni_idfirst_lc>,
+C<is_uni_space>,
+C<is_uni_space_lc>,
+C<is_uni_xdigit>,
+C<is_uni_xdigit_lc>,
+C<is_utf8_ascii>,
+C<is_utf8_blank>,
+C<is_utf8_cntrl>,
+C<is_utf8_idcont>,
+C<is_utf8_idfirst>,
+C<is_utf8_perl_space>,
+C<is_utf8_perl_word>,
+C<is_utf8_posix_digit>,
+C<is_utf8_space>,
+C<is_utf8_xdigit>.
+C<is_utf8_xidcont>,
+C<is_utf8_xidfirst>,
+C<to_uni_lower_lc>,
+C<to_uni_title_lc>,
+and
+C<to_uni_upper_lc>.
+
=head1 Performance Enhancements
XXX Changes which enhance performance without changing behaviour go here.
=item *
-L<B::Deparse> has been upgraded from version 1.17 to 1.18. It no longer
-dies when deparsing C<sort> without arguments. It now correctly omits the
-comma for C<system $prog @args> and C<exec $prog @args>.
-
-=item *
-
-L<bignum>, L<bigint> and L<bigrat> have been upgraded from version 0.30 to
-0.31. The overrides for C<hex> and C<oct> have been rewritten, eliminating
-several problems, and making one incompatible change:
-
-=over
-
-=item *
-
-Formerly, whichever of C<use bigint> or C<use bigrat> was compiled later
-would take precedence over the other, causing C<hex> and C<oct> not to
-respect the other pragma when in scope.
-
-=item *
-
-Using any of these three pragmata would cause C<hex> and C<oct> anywhere
-else in the program to evalute their arguments in list context and prevent
-them from inferring $_ when called without arguments.
-
-=item *
-
-Using any of these three pragmata would make C<oct("1234")> return 1234
-(for any number not beginning with 0) anywhere in the program. Now "1234"
-is translated from octal to decimal, whether within the pragma's scope or
-not.
-
-=item *
-
-The global overrides that facilitate lexical use of C<hex> and C<oct> now
-respect any existing overrides that were in place before the new overrides
-were installed, falling back to them outside of the scope of C<use bignum>.
-
-=item *
-
-C<use bignum "hex">, C<use bignum "oct"> and similar invocations for bigint
-and bigrat now export a C<hex> or C<oct> function, instead of providing a
-global override.
-
-=back
-
-=item *
-
-L<Carp> has been upgraded from version 1.26 to 1.27. The C<longmess()> and
-C<shortmess()> functions are now documented.
-
-=item *
-
-L<ExtUtils::CBuilder> has been upgraded from version 0.280208 to 0.280209. A
-list of symbols to export can now be passed to C<link()> when on Windows, as on
-other OSes [perl #115100].
-
-=item *
-
-L<File::Glob> has been upgraded from version 1.17 to 1.18. A
-space-separated list of patterns return long lists of results no longer
-results in memory corruption or crashes. This bug was introduced in Perl
-5.16.0. [perl #114984]
-
-=item *
-
-L<PerlIO::encoding> has been upgraded from version 0.15 to 0.16. This is
-the module implementing the ":encoding(...)" I/O layer. It no longer
-corrupts memory or crashes when the encoding back-end reallocates the
-buffer or gives it a typeglob or shared hash key scalar.
+L<GDBM_File> has been upgraded from version 1.14 to 1.15. The undocumented
+optional fifth parameter to C<TIEHASH> has been removed. This was intended
+to provide control of the callback used by C<gdbm*> functions in case of
+fatal errors (such as filesystem problems), but did not work (and could
+never have worked). No code on CPAN even attempted to use it. The callback
+is now always the previous default, C<croak>. Problems on some platforms with
+how the C<C> C<croak> function is called have also been resolved.
=back
However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
section.
-=head3 L<XXX>
+=head3 L<perlapi/Character classes>
=over 4
=item *
-XXX Description of the change here
+There are quite a few macros callable from XS modules that classify
+characters into things like alphabetic, punctuation, etc. More of these
+are now documented, including ones which work on characters whose code
+points are outside the Latin-1 range.
=back
=item *
-The error produced when a module cannot be loaded now includes a hint that
-the module may need to be installed: "Can't locate hopping.pm in @INC (you
-may need to install the hopping module) (@INC contains: ...)"
+XXX Describe change here
=back
entries for each change
Use L<XXX> with program names to get proper documentation linking. ]
-=head3 L<h2xs>
+=head3 L<XXX>
=over 4
=item *
-F<h2xs> no longer produces invalid code for empty defines. [perl #20636]
+XXX
=back
=head2 Discontinued Platforms
-XXX List any platforms that this version of perl no longer compiles on.
-
=over 4
-=item MPE/IX
+=item BeOS
-Support for MPE/IX has been removed.
+Support for BeOS has been removed.
=back
=item *
-Case-insensitive matching inside a [bracketed] character class with a
-multi-character fold, no longer excludes one of the possibilities in the
-circumstances that it used to. [perl #89774].
-
-=item *
-
-C<PL_formfeed> has been removed.
-
-=item *
-
-The regular expression engine no longer reads one byte past the end of the
-target string. While for all internally well-formed scalars this should
-never have been a problem, this change facilitates clever tricks with
-string buffers in CPAN modules. [perl #73542]
-
-=item *
-
-Inside a BEGIN block, C<PL_compcv> now points to the currently-compiling
-subroutine, rather than the BEGIN block itself.
-
-=item *
+SvUPGRADE() is no longer an expression. Originally this macro (and its
+underlying function, sv_upgrade()) were documented as boolean, although
+in reality they always croaked on error and never returned false. In 2005
+the documentation was updated to specify a void return value, but
+SvUPGRADE() was left always returning 1 for backwards compatibility. This
+has now been removed, and SvUPGRADE() is now a statement with no return
+value.
-C<mg_length> has been deprecated.
-
-=item *
+So this is now a syntax error:
-C<sv_len> now always returns a byte count and C<sv_len_utf8> a character
-count. Previously, C<sv_len> and C<sv_len_utf8> were both buggy and would
-sometimes returns bytes and sometimes characters. C<sv_len_utf8> no longer
-assumes that its argument is in UTF8. Neither of these creates UTF8 caches
-for tied or overloaded values or for non-PVs any more.
+ if (!SvUPGRADE(sv)) { croak(...); }
-=item *
-
-C<sv_mortalcopy> now copies string buffers of shared hash key scalars when
-called from XS modules [perl #79824].
-
-=item *
+If you have code like that, simply replace it with
-C<RXf_SPLIT> and C<RXf_SKIPWHITE> are no longer used. They are now
-#defined as 0.
+ SvUPGRADE(sv);
-=item *
+or to to avoid compiler warnings with older perls, possibly
-The new C<RXf_MODIFIES_VARS> flag can be set by custom regular expression
-engines to indicate that the execution of the regular expression may cause
-variables to be modified. This lets C<s///> know to skip certain
-optimisations. Perl's own regular expression engine sets this flag for the
-special backtracking verbs that set $REGMARK and $REGERROR.
+ (void)SvUPGRADE(sv);
=back
=item *
-A bug, case-insensitive regex with UTF8-flagged strings, introduced
-earlier in the 5.17 series has been fixed. [perl #114982]
-
-=item *
-
-Attributes applied to lexical variables no longer leak memory.
-[perl #114764]
-
-=item *
-
-C<dump>, C<goto>, C<last>, C<next>, C<redo> or C<require> followed by a
-bareword (or version) and then an infix operator is no longer a syntax
-error. It used to be for those infix operators (like C<+>) that have a
-different meaning where a term is expected. [perl #105924]
-
-=item *
-
-C<require a::b . 1> and C<require a::b + 1> no longer produce erroneous
-ambiguity warnings. [perl #107002]
-
-=item *
-
-Class method calls are now allowed on any string, and not just strings
-beginning with an alphanumeric character. [perl #105922]
-
-=item *
-
-An empty pattern created with C<qr//> used in C<m///> no longer triggers
-the "empty pattern reuses last pattern" behaviour. [perl #96230]
-
-=item *
-
-Tying a hash during iteration no longer results in a memory leak.
-
-=item *
-
-Freeing a tied hash during iteration no longer results in a memory leak.
-
-=item *
-
-List assignment to a tied array or hash that dies on STORE no longer
-results in a memory leak.
-
-=item *
-
-If the hint hash (C<%^H>) is tied, compile-time scope entry (which copies
-the hint hash) no longer leaks memory if FETCH dies. [perl #107000]
-
-=item *
-
-Constant folding no longer inappropriately triggers the special
-C<split " "> behaviour. [perl #94490]
-
-=item *
-
-C<defined scalar(@array)>, C<defined do { &foo }>, and similar constructs
-now treat the argument to C<defined> as a simple scalar. [perl #97466]
-
-=item *
-
-Running a custom debugging that defines no C<*DB::DB> glob or provides a
-subroutine stub for C<&DB::DB> no longer results in a crash, but an error
-instead. [perl #114990]
-
-=item *
-
-C<reset ""> now matches its documentation. C<reset> only resets C<m?...?>
-patterns when called with no argument. An empty string for an argument now
-does nothing. (It used to be treated as no argument.) [perl #97958]
-
-=item *
-
-C<printf> with an argument returning an empty list no longer reads past the
-end of the stack, resulting in erratic behaviour. [perl #77094]
-
-=item *
-
-C<--subname> no longer produces erroneous ambiguity warnings.
-[perl #77240]
-
-=item *
-
-C<v10> is now allowed as a label or package name. This was inadvertently
-broken when v-strings were added in Perl 5.6. [perl #56880]
-
-=item *
-
-A regression introduced in 5.17.2 has been fixed, which made C</[\@\\]||/>
-result in a "panic" error. [perl #115050]
-
-=item *
-
-C<length>, C<pos>, C<substr> and C<sprintf> could be confused by ties,
-overloading, references and typeglobs if the stringification of such
-changed the internal representation to or from UTF8. [perl #114410]
-
-=item *
-
-utf8::encode now calls FETCH and STORE on tied variables. utf8::decode now
-calls STORE (it was already calling FETCH).
-
-=item *
-
-C<$tied =~ s/$non_utf8/$utf8/> no longer loops infinitely if the tied
-variable returns a Latin-1 string, shared hash key scalar, or reference or
-typeglob that stringifies as ASCII or Latin-1. This is a regression from
-5.12.x.
-
-=item *
-
-C<s///> without /e is now better at detecting when it needs to forego
-certain optimisations, fixing some buggy cases:
-
-=over
-
-=item *
-
-Match variables in certain constructs (C<&&>, C<||>, C<..> and others) in
-the replacement part; e.g., C<s/(.)/$l{$a||$1}/g>. [perl #26986]
-
-=item *
-
-Aliases to match variables in the replacement.
-
-=item *
-
-$REGERROR or $REGMARK in the replacement. [perl #49190]
-
-=item *
-
-An empty pattern (C<s//$foo/>) that causes the last-successful pattern to
-be used, when that pattern contains code blocks that modify the variables
-in the replacement.
-
-=back
-
-=item *
-
-The taintedness of the replacement string no longer affects the taintedness
-of the return value of C<s///e>.
+C<sort {undef} ...> under fatal warnings no longer crashes. It started
+crashing in Perl 5.16.
=item *
-The C<$|> autoflush variable is created on-the-fly when needed. If this
-happened (e.g., if it was mentioned in a module or eval) when the
-currently-selected filehandle was a typeglob with an empty IO slot, it used
-to crash. [perl #115206]
+Stashes blessed into each other
+(C<bless \%Foo::, 'Bar'; bless \%Bar::, 'Foo'>) no longer result in double
+frees. This bug started happening in Perl 5.16.
=item *
-Line numbers at the end of a string eval are no longer off by one.
-[perl #114658]
+Numerous memory leaks have been fixed, mostly involving fatal warnings and
+syntax errors.
=item *
-@INC filters (subroutines returned by subroutines in @INC) that set $_ to a
-copy-on-write scalar no longer cause the parser to modify that string
-buffer in place.
+Lexical constants (C<my sub answer () { 42 }>) no longer cause double
+frees.
=item *
-C<length($object)> no longer returns the undefined value if the object has
-string overloading that returns undef. [perl #115260]
+Constant subroutine redefinition warns by default, but lexical constants
+were accidentally exempt from default warnings. This has been corrected.
=back
XXX Generate this with:
- perl Porting/acknowledgements.pl v5.17.4..HEAD
+ perl Porting/acknowledgements.pl v5.17.6..HEAD
=head1 Reporting Bugs