This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Finalize perldelta
[perl5.git] / pod / perldelta.pod
index 8a4bfab..567f5ae 100644 (file)
@@ -2,79 +2,23 @@
 
 =head1 NAME
 
-perldelta - what is new for perl v5.21.8
+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
+=head1 Deprecations
 
-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.
+=head2 Making all warnings fatal is discouraged
 
-=head1 Core Enhancements
-
-=head2 The warnings pragma now supports warnings outside of "all"
-
-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>.
-
-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.
-
-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.
-
-=head2 Non-Capturing Regular Expression Flag
-
-Regular expressions now support a C</n> flag that disables capturing
-and filling in C<$1>, C<$2>, etc... inside of groups:
-
-  "hello" =~ /(hi|hello)/n; # $1 is not set
-
-This is equivalent to putting C<?:> at the beginning of every capturing group.
-
-See L<perlre/"n"> for more information.
-
-=head2 C<prototype> with no arguments
-
-C<prototype()> with no arguments now infers C<$_>.  [perl #123514]
-
-=head2 C<use re 'strict'>
-
-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>.
-
-=head2 New "const" subroutine attribute
-
-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>.
-
-=head1 Incompatible Changes
-
-=head2 sub signatures moved before attributes
-
-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.
+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.
 
 =head1 Modules and Pragmata
 
@@ -84,552 +28,369 @@ prototype would be found.
 
 =item *
 
-L<arybase> has been upgraded from version 0.09 to 0.10.
+L<attributes> has been upgraded from version 0.26 to 0.27.
 
 =item *
 
-L<attributes> has been upgraded from version 0.24 to 0.25.
-
-Minor internal change only.
+L<B> has been upgraded from version 1.57 to 1.58.
 
 =item *
 
-L<autodie> has been upgraded from version 2.25 to 2.26.
+L<B::Deparse> has been upgraded from version 1.34 to 1.35.
 
-=item *
-
-L<B> has been upgraded from version 1.54 to 1.55.
-
-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.
-
-The C<id> and C<outid> PADLIST methods have been added.
-
-=item *
-
-L<B::Deparse> has been upgraded from version 1.31 to 1.32.
-
-Deparsing C<BEGIN { undef &foo }> with the B<-w> switch enabled started to
-emit 'uninitialized' warnings in Perl 5.14.  This has been fixed.
-
-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.
+C<< <<>> >> is now correctly deparsed.
 
 =item *
 
-L<Compress::Raw::Bzip2> has been upgraded from version 2.067 to 2.068.
+L<Config::Perl::V> has been upgraded from version 0.23 to 0.24.
 
 =item *
 
-L<Compress::Raw::Zlib> has been upgraded from version 2.067 to 2.068.
+L<CPAN> has been upgraded from version 2.10 to 2.11.
 
 =item *
 
-L<CPAN::Meta::Requirements> has been upgraded from version 2.130 to 2.131.
+L<Cwd> has been upgraded from version 3.55 to 3.56.
 
 =item *
 
-L<Data::Dumper> has been upgraded from version 2.155 to 2.156.
+L<ExtUtils::Miniperl> has been upgraded from version 1.04 to 1.05.
 
 =item *
 
-L<DB_File> has been upgraded from version 1.834 to 1.835.
+L<ExtUtils::ParseXS> has been upgraded from version 3.27 to 3.28.
 
 =item *
 
-L<Devel::Peek> has been upgraded from version 1.20 to 1.21.
+L<ExtUtils::Typemaps> has been upgraded from version 3.25 to 3.28.
 
 =item *
 
-L<Devel::PPPort> has been upgraded from version 3.25 to 3.28.
+L<File::Spec> has been upgraded from version 3.55 to 3.56.
 
 =item *
 
-L<Digest::MD5> has been upgraded from version 2.53 to 2.54.
+L<if> has been upgraded from version 0.0603 to 0.0604.
 
-=item *
-
-L<Digest::SHA> has been upgraded from version 5.93 to 5.95.
+The documentation now notes that this module also works with C<no>.
 
 =item *
 
-L<DynaLoader> has been upgraded from version 1.29 to 1.30.
+L<IO::Socket::IP> has been upgraded from version 0.36 to 0.37.
 
 =item *
 
-L<ExtUtils::Command> has been upgraded from version 1.18 to 1.20.
+L<Module::CoreList> has been upgraded from version 5.20150320 to 5.20150420.
 
-=item *
-
-L<ExtUtils::Manifest> has been upgraded from version 1.69 to 1.70.
+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<File::Glob> has been upgraded from version 1.23 to 1.24.
+L<perl5db.pl> has been upgraded from 1.48 to 1.49.
 
-Avoid SvIV() expanding to call get_sv() three times in a few
-places. [perl #123606]
+The debugger would cause an assertion failure.
+L<[perl #124127]|https://rt.perl.org/Ticket/Display.html?id=124127>
 
 =item *
 
-L<Filter::Util::Call> has been upgraded from version 1.51 to 1.54.
+L<PerlIO::mmap> has been upgraded from version 0.013 to 0.014.
 
 =item *
 
-L<Getopt::Long> has been upgraded from version 2.42 to 2.43.
-
-=item *
-
-L<IO::Compress> has been upgraded from version 2.067 to 2.068.
-
-=item *
+L<utf8> has been upgraded from version 1.15 to 1.16.
 
-L<IO::Socket::IP> has been upgraded from version 0.34 to 0.36.
+Minor documentation update only.
 
 =item *
 
-L<MIME::Base64> has been upgraded from version 3.14 to 3.15.
+L<warnings> has been upgraded from version 1.31 to 1.32.
 
-=item *
-
-L<Module::CoreList> has been upgraded from version 5.20141220 to 5.20150120.
-
-=item *
-
-L<Module::Load::Conditional> has been upgraded from version 0.62 to 0.64.
-
-=item *
-
-L<Module::Metadata> has been upgraded from version 1.000024 to 1.000026.
-
-=item *
-
-L<Opcode> has been upgraded from version 1.30 to 1.31.
-
-=item *
-
-L<PerlIO::encoding> has been upgraded from version 0.20 to 0.21.
-
-=item *
-
-L<Pod::Simple> has been upgraded from version 3.28 to 3.29.
-
-=item *
-
-L<POSIX> has been upgraded from version 1.48 to 1.49.
-
-=item *
-
-L<re> has been upgraded from version 0.28 to 0.30.
-
-=item *
-
-L<Safe> has been upgraded from version 2.38 to 2.39.
-
-C<reval> was not propagating void context properly.
-
-=item *
+=back
 
-L<SDBM_File> has been upgraded from version 1.12 to 1.13.
+=head1 Documentation
 
-Simplified the build process.  [perl #123413]
+=head2 Changes to Existing Documentation
 
-=item *
+=head3 L<perlebcdic>
 
-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.
-
-=item *
+This document has been significantly updated in the light of recent
+improvements to EBCDIC support.
 
-L<Unicode::Collate> has been upgraded from version 1.09 to 1.10.
+=back
 
-=item *
+=head3 L<perlfunc>
 
-L<VMS::DCLsym> has been upgraded from version 1.05 to 1.06.
+=over 4
 
 =item *
 
-L<warnings> has been upgraded from version 1.29 to 1.30.
+Mention that C<study()> is currently a no-op.
 
 =back
 
-=head1 Documentation
-
-=head2 New Documentation
-
-=head3 L<perlunicook>
-
-This document, by Tom Christiansen, provides examples of handling Unicode in 
-Perl.
-
-=head1 Diagnostics
-
-The following additions or changes have been made to diagnostic output,
-including warnings and fatal error messages.  For the complete list of
-diagnostic messages, see L<perldiag>.
-
-=head2 New Diagnostics
-
-=head3 New Errors
+=head3 L<perlguts>
 
 =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.
+The OOK example has been updated to account for COW changes and a change in the
+storage of the offset.
 
 =back
 
-=head3 New Warnings
+=head3 L<perlhacktips>
 
 =over 4
 
 =item *
 
-L<:const is experimental|perldiag/":const is experimental">
+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.
 
-(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.
-
-=item *
+=back
 
-L<Non-finite repeat count does nothing|perldiag/"Non-finite repeat count does nothing">
+=head3 L<perlport>
 
-(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">
+Out-of-date VMS-specific information has been fixed/simplified.
 
-(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.
-
-=item *
-
-L<Unusual use of %s in void context|perldiag/"Unusual use of %s in void context">
+=back
 
-(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.
+=head3 L<perluniintro>
 
-Enabled as part of "extra" warnings, not in the "all" category. See
-L<warnings> for details
+=over 4
 
 =item *
 
-L<E<quot>use re 'strict'E<quot> is experimental|perldiag/"use re 'strict'" is experimental>
-
-(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.
-
-L<Wide character (U+%X) in %s|perldiag/"Wide character (U+%X) in %s">
-
-(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.
-
-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).
+Advice for how to make sure your strings and regular expression patterns are
+interpreted as Unicode has been revised to account for the new Perl 5.22 EBCDIC
+handling.
 
-=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/">
+=back
 
-(W regexp) (only under C<S<use re 'strict'>> or within C<(?[...])>)
+=head3 L<perlvms>
 
-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.
+=over 4
 
 =item *
 
-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>">
-
-(W regexp) (only under C<S<use re 'strict'>> or within C<(?[...])>)
+Out-of-date and/or incorrect material has been removed.
 
-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.
-
- [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
-
-(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.
-
-=item *
-
-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/">
+=back
 
-(W regexp) (only under C<S<use re 'strict'>> or within C<(?[...])>)
+=head1 Testing
 
-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.
+=over 4
 
 =item *
 
-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>>
-
-(W regexp) (only under C<S<use re 'strict'>> or within C<(?[...])>)
-
-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.
+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.
 
 =back
 
-=head2 Changes to Existing Diagnostics
+=head1 Platform Support
+
+=head2 Platform-Specific Notes
 
 =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.
+L<[perl #123976]|https://rt.perl.org/Ticket/Display.html?id=123976>
 
-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.
+C<test-prep> again depends on C<test-prep-gcc> for GCC builds.
+L<[perl #124221]|https://rt.perl.org/Ticket/Display.html?id=124221>
 
 =back
 
-=head1 Configuration and Compilation
+=head1 Internal Changes
 
 =over 4
 
 =item *
 
-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.
-
-=back
-
-=head1 Testing
+Perl 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:
 
 =over 4
 
 =item *
 
-A new test script, F<bigmem/subst.t>, has been added to test memory usage of
-subst on very large strings.
+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>.
 
 =item *
 
-A new test script, F<op/anonconst.t>, has been added to test experimental
-:const subroutines.
+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.
 
 =item *
 
-A new test script, F<re/reg_nocapture.t>, has been added to test the new
-C</n> regexp flag.
-
-=back
-
-=head1 Platform Support
-
-=head2 Platform-Specific Notes
-
-=over 4
-
-=item Win32
-
-=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 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 Perl 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
 
 =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.
+L<[perl #123971]|https://rt.perl.org/Ticket/Display.html?id=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.
+L<[perl #124127]|https://rt.perl.org/Ticket/Display.html?id=124127>
 
-=head1 Selected Bug Fixes
+=item *
 
-=over 4
+An assertion failure and subsequent crash with C<< *x=<y> >> has been fixed.
+L<[perl #123790]|https://rt.perl.org/Ticket/Display.html?id=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.
+L<[perl #124160]|https://rt.perl.org/Ticket/Display.html?id=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.
+L<[perl #123790]|https://rt.perl.org/Ticket/Display.html?id=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.
+L<[perl #124099]|https://rt.perl.org/Ticket/Display.html?id=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.
+L<[perl #124113]|https://rt.perl.org/Ticket/Display.html?id=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.
+L<[perl #124135]|https://rt.perl.org/Ticket/Display.html?id=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.
+L<[perl #123527]|https://rt.perl.org/Ticket/Display.html?id=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>.
+L<[perl #124109]|https://rt.perl.org/Ticket/Display.html?id=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.
+L<[perl #123619]|https://rt.perl.org/Ticket/Display.html?id=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
 
-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
+Perl 5.21.11 represents approximately 4 weeks of development since Perl 5.21.10
+and contains approximately 5,800 lines of changes across 240 files from 24
 authors.
 
 Excluding auto-generated files, documentation and release tools, there were
-approximately 13,000 lines of changes to 410 .pm, .t, .c and .h files.
+approximately 1,700 lines of changes to 160 .pm, .t, .c and .h files.
 
 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:
+of users and developers.  The following people are known to have contributed
+the improvements that became Perl 5.21.11:
 
-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.
+Alex Vandiver, Andreas König, Craig A. Berry, Dagfinn Ilmari Mannsåker, Daniel
+Dragan, David Golden, David Mitchell, Father Chrysostomos, H.Merijn Brand,
+Herbert Breunung, Hugo van der Sanden, James E Keenan, James McCoy, Karl
+Williamson, Matthew Horsfall, Max Maischein, Nicholas Clark, Rafael
+Garcia-Suarez, Randy Stauner, Ricardo Signes, Shirakata Kentaro, Steffen
+Müller, Steve Hay, Tony Cook.
 
 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
+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.
 
 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
+included in Perl's core.  We're grateful to the entire CPAN community for
 helping Perl to flourish.
 
 For a more complete list of all of Perl's historical contributors, please see