=head1 NAME
-perldelta - what is new for perl v5.21.8
+[ 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.21.11
=head1 DESCRIPTION
-This document describes differences between the 5.21.7 release and the 5.21.8
+This document describes differences between the 5.21.10 release and the 5.21.11
release.
-If you are upgrading from an earlier release such as 5.21.6, first read
-L<perl5217delta>, which describes differences between 5.21.6 and 5.21.7.
+If you are upgrading from an earlier release such as 5.21.9, first read
+L<perl52110delta>, which describes differences between 5.21.9 and 5.21.10.
=head1 Notice
-With this release we are now in the contentious changes portion of the code
-freeze as we prepare for the next stable release of Perl 5.
+XXX Any important notices here
=head1 Core Enhancements
-=head2 The warnings pragma now supports warnings outside of "all"
+XXX New core language features go here. Summarize user-visible core language
+enhancements. Particularly prominent performance optimisations could go
+here, but most should go in the L</Performance Enhancements> section.
-Ever since perl v5.6.0 we've had no way of adding new warnings without
-retroactively adding them to all existing programs that used C<-w>,
-C<-W> or C<use warnings>.
+[ List each enhancement as a =head2 entry ]
-This caused us to not add new useful warnings out of fear that they
-might unduly burden users who just wanted to upgrade perl and didn't
-want to deal with a bunch of warnings from their existing code.
+=head1 Security
-We now support a way to have our cake and eat it too, and can add new
-warnings to the core going forward through other top-level warning
-categories. See L<the warnings documentation|warnings/Top-level
-warning categories & associated confusion> for details.
+XXX Any security-related notices go here. In particular, any security
+vulnerabilities closed should be noted here rather than in the
+L</Selected Bug Fixes> section.
-=head2 Non-Capturing Regular Expression Flag
+[ List each security issue as a =head2 entry ]
-Regular expressions now support a C</n> flag that disables capturing
-and filling in C<$1>, C<$2>, etc... inside of groups:
+=head1 Incompatible Changes
- "hello" =~ /(hi|hello)/n; # $1 is not set
+XXX For a release on a stable branch, this section aspires to be:
-This is equivalent to putting C<?:> at the beginning of every capturing group.
+ 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.
-See L<perlre/"n"> for more information.
+[ List each incompatible change as a =head2 entry ]
-=head2 C<prototype> with no arguments
+=head1 Deprecations
-C<prototype()> with no arguments now infers C<$_>. [perl #123514]
+XXX Any deprecated features, syntax, modules etc. should be listed here.
-=head2 C<use re 'strict'>
+=head2 Making all warnings fatal is discouraged
-This applies stricter syntax rules to regular expression patterns
-compiled within its scope, which hopefully will alert you to typos and
-other unintentional behavior that backwards-compatibility issues prevent
-us from doing in normal regular expression compilations. Because the
-behavior of this is subject to change in future Perl releases as we gain
-experience, using this pragma will raise a category
-C<experimental:re_strict> warning.
-See L<'strict' in re|re/'strict' mode>.
+The documentation for L<fatal warnings|warnings/Fatal Warnings> notes
+that C<< use warnings FATAL => 'all' >> is discouraged
+and provides stronger language about the risks of fatal warnings
+in general.
-=head2 New "const" subroutine attribute
+=head2 Module removals
-The "const" attribute can be applied to an anonymous subroutine. It causes
-it to be executed immediately when it is cloned. Its value is captured and
-used to create a new constant subroutine that is returned. This feature is
-experimental. See L<perlsub/Constant Functions>.
+XXX Remove this section if inapplicable.
-=head1 Incompatible Changes
+The following modules will be removed from the core distribution in a
+future release, and will at that time need to be installed from CPAN.
+Distributions on CPAN which require these modules will need to list them as
+prerequisites.
-=head2 sub signatures moved before attributes
+The core versions of these modules will now issue C<"deprecated">-category
+warnings to alert you to this fact. To silence these deprecation warnings,
+install the modules in question from CPAN.
-The experimental sub signatures feature, as introduced in 5.20, parsed
-signatures after attributes. In this release, the positioning has been
-moved such that signatures occur in exactly the same positioning a
-prototype would be found.
+Note that these are (with rare exceptions) fine modules that you are encouraged
+to continue to use. Their disinclusion from core primarily hinges on their
+necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
+not usually on concerns over their design.
-=head1 Modules and Pragmata
+=over
-=head2 Updated Modules and Pragmata
+=item XXX
-=over 4
+XXX Note that deprecated modules should be listed here even if they are listed
+as an updated module in the L</Modules and Pragmata> section.
-=item *
+=back
-L<arybase> has been upgraded from version 0.09 to 0.10.
+[ List each other deprecation as a =head2 entry ]
-=item *
+=head1 Performance Enhancements
-L<attributes> has been upgraded from version 0.24 to 0.25.
+XXX Changes which enhance performance without changing behaviour go here.
+There may well be none in a stable release.
-Minor internal change only.
+[ List each enhancement as a =item entry ]
+
+=over 4
=item *
-L<autodie> has been upgraded from version 2.25 to 2.26.
+XXX
-=item *
+=back
+
+=head1 Modules and Pragmata
-L<B> has been upgraded from version 1.54 to 1.55.
+XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
+go here. If Module::CoreList is updated, generate an initial draft of the
+following sections using F<Porting/corelist-perldelta.pl>. A paragraph summary
+for important changes should then be added by hand. In an ideal world,
+dual-life modules would have a F<Changes> file that could be cribbed.
-A bug where, after an ithread creation or psuedofork, special/immortal SVs in
-the child ithread/psuedoprocess did not have the correct class of
-C<B::SPECIAL>, has been fixed.
+[ Within each section, list entries as a =item entry ]
-The C<id> and C<outid> PADLIST methods have been added.
+=head2 New Modules and Pragmata
+
+=over 4
=item *
-L<B::Deparse> has been upgraded from version 1.31 to 1.32.
+XXX
-Deparsing C<BEGIN { undef &foo }> with the B<-w> switch enabled started to
-emit 'uninitialized' warnings in Perl 5.14. This has been fixed.
+=back
-Deparsing calls to subs with a C<(;+)> prototype resulted in an infinite
-loop. The C<(;$>) C<(_)> and C<(;_)> prototypes were given the wrong
-precedence, causing C<foo($aE<lt>$b)> to be deparsed without the parentheses.
+=head2 Updated Modules and Pragmata
+
+=over 4
=item *
-L<Compress::Raw::Bzip2> has been upgraded from version 2.067 to 2.068.
+L<attributes> has been upgraded from version 0.26 to 0.27.
=item *
-L<Compress::Raw::Zlib> has been upgraded from version 2.067 to 2.068.
+L<B> has been upgraded from version 1.57 to 1.58.
=item *
-L<CPAN::Meta::Requirements> has been upgraded from version 2.130 to 2.131.
+L<B::Deparse> has been upgraded from version 1.34 to 1.35.
+
+C<< <<>> >> is now correctly deparsed.
=item *
-L<Data::Dumper> has been upgraded from version 2.155 to 2.156.
+L<Config::Perl::V> has been upgraded from version 0.23 to 0.24.
=item *
-L<DB_File> has been upgraded from version 1.834 to 1.835.
+L<CPAN> has been upgraded from version 2.10 to 2.11.
=item *
-L<Devel::Peek> has been upgraded from version 1.20 to 1.21.
+L<Cwd> has been upgraded from version 3.55 to 3.56.
=item *
-L<Devel::PPPort> has been upgraded from version 3.25 to 3.28.
+L<ExtUtils::Miniperl> has been upgraded from version 1.04 to 1.05.
=item *
-L<Digest::MD5> has been upgraded from version 2.53 to 2.54.
+L<ExtUtils::ParseXS> has been upgraded from version 3.27 to 3.28.
=item *
-L<Digest::SHA> has been upgraded from version 5.93 to 5.95.
+L<ExtUtils::Typemaps> has been upgraded from version 3.25 to 3.28.
=item *
-L<DynaLoader> has been upgraded from version 1.29 to 1.30.
+L<File::Spec> has been upgraded from version 3.55 to 3.56.
=item *
-L<ExtUtils::Command> has been upgraded from version 1.18 to 1.20.
+L<if> has been upgraded from version 0.0603 to 0.0604.
+
+The documentation now notes that this module also works with C<no>.
=item *
-L<ExtUtils::Manifest> has been upgraded from version 1.69 to 1.70.
+L<IO::Socket::IP> has been upgraded from version 0.36 to 0.37.
=item *
-L<File::Glob> has been upgraded from version 1.23 to 1.24.
+L<Module::CoreList> has been upgraded from version 5.20150320 to 5.20150420.
-Avoid SvIV() expanding to call get_sv() three times in a few
-places. [perl #123606]
+Updated to cover the latest releases of Perl. Also fixes a fencepost error in
+is_core() and copes with versions that do not match x.yyyzzz.
=item *
-L<Filter::Util::Call> has been upgraded from version 1.51 to 1.54.
+L<perl5db.pl> has been upgraded from 1.48 to 1.49.
+
+The debugger would cause an assertion failure. [perl #124127]
=item *
-L<Getopt::Long> has been upgraded from version 2.42 to 2.43.
+L<PerlIO::mmap> has been upgraded from version 0.013 to 0.014.
=item *
-L<IO-Compress> has been upgraded from version 2.067 to 2.068.
+L<utf8> has been upgraded from version 1.15 to 1.16.
+
+Minor documentation update only.
=item *
-L<IO::Socket::IP> has been upgraded from version 0.34 to 0.36.
+L<warnings> has been upgraded from version 1.31 to 1.32.
-=item *
+=back
+
+=head2 Removed Modules and Pragmata
-L<MIME::Base64> has been upgraded from version 3.14 to 3.15.
+=over 4
=item *
-L<Module::CoreList> has been upgraded from version 5.20141220 to 5.20150120.
+XXX
-=item *
+=back
-L<Module::Load::Conditional> has been upgraded from version 0.62 to 0.64.
+=head1 Documentation
-=item *
+XXX Changes to files in F<pod/> go here. Consider grouping entries by
+file and be sure to link to the appropriate page, e.g. L<perlfunc>.
-L<Module::Metadata> has been upgraded from version 1.000024 to 1.000026.
+=head2 New Documentation
-=item *
+XXX Changes which create B<new> files in F<pod/> go here.
-L<Opcode> has been upgraded from version 1.30 to 1.31.
+=head3 L<XXX>
-=item *
+XXX Description of the purpose of the new file here
-L<PerlIO::encoding> has been upgraded from version 0.20 to 0.21.
+=head2 Changes to Existing Documentation
-=item *
+XXX Changes which significantly change existing files in F<pod/> go here.
+However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
+section.
-L<Pod::Simple> has been upgraded from version 3.28 to 3.29.
+=head3 L<perlebcdic>
+
+=over 4
=item *
-L<POSIX> has been upgraded from version 1.48 to 1.49.
+This document has been significantly updated in the light of recent
+improvements to EBCDIC support.
-=item *
+=back
-L<re> has been upgraded from version 0.28 to 0.30.
+=head3 L<perlfunc>
+
+=over 4
=item *
-L<Safe> has been upgraded from version 2.38 to 2.39.
+Mention that C<study()> is currently a no-op.
+
+=back
+
+=head3 L<perlguts>
-C<reval> was not propagating void context properly.
+=over 4
=item *
-L<SDBM_File> has been upgraded from version 1.12 to 1.13.
+The OOK example has been updated to account for COW changes and a change in the
+storage of the offset.
-Simplified the build process. [perl #123413]
+=back
-=item *
+=head3 L<perlhacktips>
-L<Test::Harness> has been upgraded from version 3.34 to 3.35.
+=over 4
=item *
-L<Test::Simple> has been upgraded from version 1.301001_090 to 1.301001_097.
+Documentation has been added illustrating the perils of assuming the contents of
+static memory pointed to by the return values of Perl wrappers for C library
+functions doesn't change.
-=item *
+=back
+
+=head3 L<perlport>
-L<Unicode::Collate> has been upgraded from version 1.09 to 1.10.
+=over 4
=item *
-L<VMS::DCLsym> has been upgraded from version 1.05 to 1.06.
+Out-of-date VMS-specific information has been fixed/simplified.
+
+=back
+
+=head3 L<perluniintro>
+
+=over 4
=item *
-L<warnings> has been upgraded from version 1.29 to 1.30.
+Advice for how to make sure your strings and regular expression patterns are
+interpreted as Unicode has been revised to account for the new 5.22 EBCDIC
+handling.
=back
-=head1 Documentation
+=head3 L<perlvms>
-=head2 New Documentation
+=over 4
+
+=item *
-=head3 L<perlunicook>
+Out-of-date and/or incorrect material has been removed.
-This document, by Tom Christiansen, provides examples of handling Unicode in
-Perl.
+=back
=head1 Diagnostics
including warnings and fatal error messages. For the complete list of
diagnostic messages, see L<perldiag>.
+XXX New or changed warnings emitted by the core's C<C> code go here. Also
+include any changes in L<perldiag> that reconcile it to the C<C> code.
+
=head2 New Diagnostics
+XXX Newly added diagnostic messages go under here, separated into New Errors
+and New Warnings
+
=head3 New Errors
=over 4
=item *
-L<Bad symbol for scalar|perldiag/"Bad symbol for scalar">
-
-(P) An internal request asked to add a scalar entry to something that
-wasn't a symbol table entry.
-
-=item *
-
-L<:const is not permitted on named subroutines|perldiag/":const is not permitted on named subroutines">
-
-(F) The "const" attribute causes an anonymous subroutine to be run and
-its value captured at the time that it is cloned. Names subroutines are
-not cloned like this, so the attribute does not make sense on them.
+XXX L<message|perldiag/"message">
=back
=item *
-L<:const is experimental|perldiag/":const is experimental">
+XXX L<message|perldiag/"message">
-(S experimental::const_attr) The "const" attribute is experimental.
-If you want to use the feature, disable the warning with C<no warnings
-'experimental::const_attr'>, but know that in doing so you are taking
-the risk that your code may break in a future Perl version.
+=back
-=item *
+=head2 Changes to Existing Diagnostics
-L<Non-finite repeat count does nothing|perldiag/"Non-finite repeat count does nothing">
+XXX Changes (i.e. rewording) of diagnostic messages go here
-(W numeric) You tried to execute the
-L<C<x>|perlop/Multiplicative Operators> repetition operator C<Inf> (or
-C<-Inf>) or C<NaN> times, which doesn't make sense.
+=over 4
=item *
-L<Useless use of attribute "const"|perldiag/Useless use of attribute "const">
+XXX Describe change here
-(W misc) The "const" attribute has no effect except
-on anonymous closure prototypes. You applied it to
-a subroutine via L<attributes.pm|attributes>. This is only useful
-inside an attribute handler for an anonymous subroutine.
+=back
-=item *
+=head1 Utility Changes
-L<Unusual use of %s in void context|perldiag/"Unusual use of %s in void context">
+XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
+Most of these are built within the directory F<utils>.
-(W void_unusual) Similar to the "Useless use of %s in void context"
-warning, but only turned on by the top-level "pedantic" warning
-category, used for e.g. C<grep> in void context, which may indicate a
-bug, but could also just be someone using C<grep> for its side-effects
-as a loop.
+[ List utility changes as a =head2 entry for each utility and =item
+entries for each change
+Use L<XXX> with program names to get proper documentation linking. ]
-Enabled as part of "extra" warnings, not in the "all" category. See
-L<warnings> for details
+=head2 L<XXX>
+
+=over 4
=item *
-L<E<quot>use re 'strict'E<quot> is experimental|perldiag/"use re 'strict'" is experimental>
+XXX
+
+=back
-(S experimental::re_strict) The things that are different when a regular
-expression pattern is compiled under C<'strict'> are subject to change
-in future Perl releases in incompatible ways. This means that a pattern
-that compiles today may not in a future Perl release. This warning is
-to alert you to that risk.
+=head1 Configuration and Compilation
-L<Wide character (U+%X) in %s|perldiag/"Wide character (U+%X) in %s">
+XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
+go here. Any other changes to the Perl build process should be listed here.
+However, any platform-specific changes should be listed in the
+L</Platform Support> section, instead.
-(W locale) While in a single-byte locale (I<i.e.>, a non-UTF-8
-one), a multi-byte character was encountered. Perl considers this
-character to be the specified Unicode code point. Combining non-UTF8
-locales and Unicode is dangerous. Almost certainly some characters
-will have two different representations. For example, in the ISO 8859-7
-(Greek) locale, the code point 0xC3 represents a Capital Gamma. But so
-also does 0x393. This will make string comparisons unreliable.
+[ List changes as a =item entry ].
-You likely need to figure out how this multi-byte character got mixed up
-with your single-byte locale (or perhaps you thought you had a UTF-8
-locale, but Perl disagrees).
+=over 4
=item *
-L<Both or neither range ends should be Unicode in regex; marked by E<lt>-- HERE in mE<sol>%sE<sol>|perldiag/"Both or neither range ends should be Unicode in regex; marked by <-- HERE in m/%s/">
+XXX
-(W regexp) (only under C<S<use re 'strict'>> or within C<(?[...])>)
+=back
-In a bracketed character class in a regular expression pattern, you
-had a range which has exactly one end of it specified using C<\N{}>, and
-the other end is specified using a non-portable mechanism. Perl treats
-the range as a Unicode range, that is, all the characters in it are
-considered to be the Unicode characters, and which may be different code
-points on some platforms Perl runs on. For example, C<[\N{U+06}-\x08]>
-is treated as if you had instead said C<[\N{U+06}-\N{U+08}]>, that is it
-matches the characters whose code points in Unicode are 6, 7, and 8.
-But that C<\x08> might indicate that you meant something different, so
-the warning gets raised.
+=head1 Testing
-=item *
+XXX Any significant changes to the testing of a freshly built perl should be
+listed here. Changes which create B<new> files in F<t/> go here as do any
+large changes to the testing harness (e.g. when parallel testing was added).
+Changes to existing files in F<t/> aren't worth summarizing, although the bugs
+that they represent may be covered elsewhere.
-L<Ranges of ASCII printables should be some subset of "0-9", "A-Z", or "a-z" in regex; marked by E<lt>-- HERE in mE<sol>%sE<sol>|perldiag/"Ranges of ASCII printables should be some subset of "0-9", "A-Z", or "a-z" in regex; marked by <-- HERE in mE<sol>%sE<sol>">
+[ List each test improvement as a =item entry ]
-(W regexp) (only under C<S<use re 'strict'>> or within C<(?[...])>)
+=over 4
-Stricter rules help to find typos and other errors. Perhaps you didn't
-even intend a range here, if the C<"-"> was meant to be some other
-character, or should have been escaped (like C<"\-">). If you did
-intend a range, the one that was used is not portable between ASCII and
-EBCDIC platforms, and doesn't have an obvious meaning to a casual
-reader.
+=item *
- [3-7] # OK; Obvious and portable
- [d-g] # OK; Obvious and portable
- [A-Y] # OK; Obvious and portable
- [A-z] # WRONG; Not portable; not clear what is meant
- [a-Z] # WRONG; Not portable; not clear what is meant
- [%-.] # WRONG; Not portable; not clear what is meant
- [\x41-Z] # WRONG; Not portable; not obvious to non-geek
+F<t/porting/re_context.t> has been added to test that L<utf8> and its
+dependencies only use the subset of the C<$1..$n> capture vars that
+Perl_save_re_context() is hard-coded to localize, because that function has no
+efficient way of determining at runtime what vars to localize.
-(You can force portability by specifying a Unicode range, which means that
-the endpoints are specified by
-L<C<\N{...}>|perlrecharclass/Character Ranges>, but the meaning may
-still not be obvious.)
-The stricter rules require that ranges that start or stop with an ASCII
-character that is not a control have all their endpoints be the literal
-character, and not some escape sequence (like C<"\x41">), and the ranges
-must be all digits, or all uppercase letters, or all lowercase letters.
+=back
-=item *
+=head1 Platform Support
-L<Ranges of digits should be from the same group in regex; marked by E<lt>-- HERE in mE<sol>%sE<sol>|perldiag/"Ranges of digits should be from the same group in regex; marked by <-- HERE in m/%s/">
+XXX Any changes to platform support should be listed in the sections below.
-(W regexp) (only under C<S<use re 'strict'>> or within C<(?[...])>)
+[ Within the sections, list each platform as a =item entry with specific
+changes as paragraphs below it. ]
-Stricter rules help to find typos and other errors. You included a
-range, and at least one of the end points is a decimal digit. Under the
-stricter rules, when this happens, both end points should be digits in
-the same group of 10 consecutive digits.
+=head2 New Platforms
-=item *
+XXX List any platforms that this version of perl compiles on, that previous
+versions did not. These will either be enabled by new files in the F<hints/>
+directories, or new subdirectories and F<README> files at the top level of the
+source tree.
-L<"%s" is more clearly written simply as "%s" in regex; marked by E<lt>-- HERE in mE<sol>%sE<sol>|perldiag/"%s" is more clearly written simply as "%s" in regex; marked by <-- HERE in mE<sol>%sE<sol>>
+=over 4
-(W regexp) (only under C<S<use re 'strict'>> or within C<(?[...])>)
+=item XXX-some-platform
-You specified a character that has the given plainer way of writing it,
-and which is also portable to platforms running with different character
-sets.
+XXX
=back
-=head2 Changes to Existing Diagnostics
+=head2 Discontinued Platforms
+
+XXX List any platforms that this version of perl no longer compiles on.
=over 4
-=item *
+=item XXX-some-platform
-The message
-L<Locale '%s' may not work well.%s|perldiag/"Locale '%s' may not work well.%s">
-is no longer raised unless the problemtatic locale is actually used in
-the Perl program. Previously it was raised if it merely was the
-underlying locale. All Perl programs have an underlying locale at all
-times, but something like a C<S<use locale>> is needed for that locale
-to actually have some effect. This message will not be raised when
-the underlying locale is hidden.
+XXX
=back
-=head1 Configuration and Compilation
+=head2 Platform-Specific Notes
+
+XXX List any changes for specific platforms. This could include configuration
+and compilation changes or changes in portability/compatibility. However,
+changes within modules for platforms should generally be listed in the
+L</Modules and Pragmata> section.
=over 4
-=item *
+=item Win32
+
+F<miniperl.exe> is now built with C<-fno-strict-aliasing>, allowing
+64-bit builds to complete on GCC 4.8. [perl #123976]
-pthreads and lcl will be linked by default if present. This allows XS modules
-that require threading to work on non-threaded perls. Note that you must still
-pass C<-Dusethreads> if you want a threaded perl.
+C<test-prep> again depends on C<test-prep-gcc> for GCC builds. [perl
+#124221]
=back
-=head1 Testing
+=head1 Internal Changes
=over 4
=item *
-A new test script, F<bigmem/subst.t>, has been added to test memory usage of
-subst on very large strings.
+5.21.2 introduced a new build option, C<-DPERL_OP_PARENT>, which causes
+the last C<op_sibling> pointer to refer back to the parent rather than
+being C<NULL>, and where instead a new flag indicates the end of the
+chain. In this release, the new implementation has been revised; in
+particular:
-=item *
-
-A new test script, F<op/anonconst.t>, has been added to test experimental
-:const subroutines.
+=over 4
=item *
-A new test script, F<re/reg_nocapture.t>, has been added to test the new
-C</n> regexp flag.
-
-=back
+On C<PERL_OP_PARENT> builds, the C<op_sibling> field has been renamed
+C<op_sibparent> to reflect its new dual purpose. Since the intention is that
+this field should primarily be accessed via macros, this change should be
+transparent for code written to work under C<PERL_OP_PARENT>.
-=head1 Platform Support
+=item *
-=head2 Platform-Specific Notes
+The newly-introduced C<op_lastsib> flag bit has been renamed C<op_moresib>
+and its logic inverted; i.e. it is initialised to zero in a new op, and is
+changed to 1 when an op gains a sibling.
-=over 4
-
-=item Win32
+=item *
-=over 4
+The function C<Perl_op_parent> is now only available on C<PERL_OP_PARENT>
+builds. Using it on a plain build will be a compile-timer error.
=item *
-Previously, on Visual C++ for Win64 built Perls only, when compiling every Perl
-XS module (including CPAN ones) and Perl aware .c file with a 64 bit Visual C++,
-would unconditionally have around a dozen warnings from hv_func.h. These
-warnings have been silenced. GCC all bitness and Visual C++ for Win32 were
-not affected.
+Three new macros, C<OpMORESIB_set>, C<OpLASTSIB_set>, C<OpMAYBESIB_set>
+have been added, which are intended to be be a low-level portable way to
+set C<op_sibling> / C<op_sibparent> while also updating C<op_moresib>.
+The first sets the sibling pointer to a new sibling, the second makes the
+op the last sibling, and the third conditionally does the first or second
+action. The C<op_sibling_splice()> function is retained as a higher-level
+interface that can also maintain consistency in the parent at the same time
+(e.g. by updating C<op_first> and C<op_last> where appropriate).
=item *
-Support for building without PerlIO has been removed from the Windows
-makefiles. Non-PerlIO builds were all but deprecated in Perl 5.18.0 and are
-already not supported by F<Configure> on POSIX systems.
+The macro C<OpSIBLING_set>, added in 5.21.2, has been removed. It didn't
+manipulate C<op_moresib> and has been superseded by C<OpMORESIB_set> et
+al.
=item *
-Between 2 and 6 ms and 7 I/O calls have been saved per attempt to open a perl
-module for each path in C<@INC>.
+The C<op_sibling_splice> function now accepts a null C<parent> argument
+where the splicing doesn't affect the first or last ops in the sibling
+chain, and thus where the parent doesn't need to be updated accordingly.
=back
+
=back
-=head1 Internal Changes
+=head1 Selected Bug Fixes
+
+XXX Important bug fixes in the core language are summarized here. Bug fixes in
+files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
+
+[ List each fix as a =item entry ]
=over 4
=item *
-Added Perl_sv_get_backrefs() to determine if an SV is a weak-referent.
+C<pack("D", $x)> and C<pack("F", $x)> now zero the padding on x86 long
+double builds. GCC 4.8 and later, under some build options, would
+either overwrite the zero-initialized padding, or bypass the
+initialized buffer entirely. This caused F<op/pack.t> to fail. [perl
+#123971]
-Function either returns an SV * of type AV, which contains the set of
-weakreferences which reference the passed in SV, or a simple RV * which
-is the only weakref to this item.
+=item *
-=back
+Extending an array cloned from a parent thread could result in
+"Modification of a read-only value attempted" errors when attempting
+to modify the new elements. [perl #124127]
-=head1 Selected Bug Fixes
+=item *
-=over 4
+An assertion failure and subsequent crash with C<< *x=<y> >> has been fixed.
+[perl #123790]
=item *
-A bug in regular expression patterns that could lead to segfaults and
-other crashes has been fixed. This occurred only in patterns compiled
-with C<"/i">, while taking into account the current POSIX locale (this usually
-means they have to be compiled within the scope of C<S<"use locale">>),
-and there must be a string of at least 128 consecutive bytes to match.
-[perl #123539]
+An optimization for state variable initialization introduced in Perl 5.21.6 has
+been reverted because it was found to exacerbate some other existing buggy
+behaviour. [perl #124160]
=item *
-C<s///> now works on very long strings instead of dying with 'Substitution
-loop'. [perl #103260] [perl #123071]
+The extension of another optimization to cover more ops in Perl 5.21 has also
+been reverted to its Perl 5.20 state as a temporary fix for regression issues
+that it caused. [perl #123790]
=item *
-C<gmtime> no longer crashes with not-a-number values. [perl #123495]
+New bitwise ops added in Perl 5.21.9 accidentally caused C<$^H |= 0x1c020000>
+to enable all features. This has now been fixed.
=item *
-C<\()> (reference to an empty list) and C<y///> with lexical $_ in scope
-could do a bad write past the end of the stack. They have been fixed
-to extend the stack first.
+A possible crashing/looping bug has been fixed. [perl #124099]
=item *
-C<prototype()> with no arguments used to read the previous item on the
-stack, so C<print "foo", prototype()> would print foo's prototype. It has
-been fixed to infer $_ instead. [perl #123514]
+UTF-8 variable names used in array indexes, unquoted UTF-8 HERE-document
+terminators and UTF-8 function names all now work correctly. [perl #124113]
=item *
-Some cases of lexical state subs inside predeclared subs could crash but no
-longer do.
+Breakage in C<require(VERSION)> (with parentheses), introduced in Perl 5.21.6,
+has been fixed. [perl #124135]
=item *
-Some cases of nested lexical state subs inside anonymous subs could cause
-'Bizarre copy' errors or possibly even crash.
+Wide char warnings, wrongly raised in UTF-8 locales since Perl 5.21.8, are now
+suppressed. [perl #123527]
=item *
-When trying to emit warnings, perl's default debugger (F<perl5db.pl>) was
-sometimes giving 'Undefined subroutine &DB::db_warn called' instead. This
-bug, which started to occur in Perl 5.18, has been fixed. [perl #123553]
+A subtle bug introduced in Perl 5.21.4 involving UTF-8 in regular expressions
+and sometimes causing a crash has been fixed. A new test script has been added
+to test this fix; see under L</Testing>. [perl #124109]
=item *
-Certain syntax errors in substitutions, such as C<< s/${E<lt>E<gt>{})// >>, would
-crash, and had done so since Perl 5.10. (In some cases the crash did not
-start happening till 5.16.) The crash has, of course, been fixed.
-[perl #123542]
+A change introduced in Perl 5.21.10 that broke the autovivification CPAN module
+has been reverted.
=item *
-A repeat expression like C<33 x ~3> could cause a large buffer
-overflow since the new output buffer size was not correctly handled by
-SvGROW(). An expression like this now properly produces a memory wrap
-panic. [perl 123554]
+A bug whereby C<< 'FOO'->f() >> lost the read-only status of C<FOO>, introduced
+in Perl 5.21.7, has been fixed. [perl #123619]
=item *
-C<< formline("@...", "a"); >> would crash. The C<FF_CHECKNL> case in
-pp_formline() didn't set the pointer used to mark the chop position,
-which led to the C<FF_MORE> case crashing with a segmentation fault.
-This has been fixed. [perl #123538]
+A regression in Perl 5.21 in the matching of C</[A-Z]/ai> has been fixed.
=back
-=head1 Acknowledgements
+=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. Unfixed
+platform specific bugs also go here.
+
+[ List each fix as a =item entry ]
+
+=over 4
+
+=item *
+
+XXX
-Perl 5.21.8 represents approximately 4 weeks of development since Perl 5.21.7
-and contains approximately 26,000 lines of changes across 750 files from 27
-authors.
+=back
-Excluding auto-generated files, documentation and release tools, there were
-approximately 13,000 lines of changes to 410 .pm, .t, .c and .h files.
+=head1 Errata From Previous Releases
-Perl continues to flourish into its third decade thanks to a vibrant community
-of users and developers. The following people are known to have contributed the
-improvements that became Perl 5.21.8:
+=over 4
-Aaron Crane, Andreas Voegele, Chad Granum, Chris 'BinGOs' Williams, Craig A.
-Berry, Daniel Dragan, David Mitchell, E. Choroba, Ed J, Father Chrysostomos,
-H.Merijn Brand, Hugo van der Sanden, James E Keenan, Jarkko Hietaniemi, Karen
-Etheridge, Karl Williamson, Matthew Horsfall, Max Maischein, Peter Martini,
-Rafael Garcia-Suarez, Ricardo Signes, Rostislav Skudnov, Slaven Rezic, Steve
-Hay, Tony Cook, Yves Orton, Ævar Arnfjörð Bjarmason.
+=item *
-The list above is almost certainly incomplete as it is automatically generated
-from version control history. In particular, it does not include the names of
-the (very much appreciated) contributors who reported issues to the Perl bug
-tracker.
+XXX Add anything here that we forgot to add, or were mistaken about, in
+the perldelta of a previous release.
+
+=back
+
+=head1 Obituary
+
+XXX If any significant core contributor has died, we've added a short obituary
+here.
+
+=head1 Acknowledgements
-Many of the changes included in this version originated in the CPAN modules
-included in Perl's core. We're grateful to the entire CPAN community for
-helping Perl to flourish.
+XXX Generate this with:
-For a more complete list of all of Perl's historical contributors, please see
-the F<AUTHORS> file in the Perl source distribution.
+ perl Porting/acknowledgements.pl v5.21.10..HEAD
=head1 Reporting Bugs
https://perl5.git.perl.org / perl5.git / blobdiff