This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Upgrade Encode from version 2.67 to 2.68
[perl5.git] / pod / perldelta.pod
index dea404e..d61c055 100644 (file)
@@ -5,15 +5,15 @@
 [ 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.7
+perldelta - what is new for perl v5.21.9
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.21.6 release and the 5.21.7
+This document describes differences between the 5.21.8 release and the 5.21.9
 release.
 
-If you are upgrading from an earlier release such as 5.21.5, first read
-L<perl5216delta>, which describes differences between 5.21.5 and 5.21.6.
+If you are upgrading from an earlier release such as 5.21.7, first read
+L<perl5218delta>, which describes differences between 5.21.7 and 5.21.8.
 
 =head1 Notice
 
@@ -27,18 +27,6 @@ here, but most should go in the L</Performance Enhancements> section.
 
 [ List each enhancement as a =head2 entry ]
 
-=head2 C<fileno> now works on directory handles
-
-When the relevant support is available in the operating system, the
-C<fileno> builtin now works on directory handles, yielding the
-underlying file descriptor in the same way as for filehandles. On
-operating systems without such support, C<fileno> on a directory handle
-continues to return the undefined value, as before, but also sets C<$!> to
-indicate that the operation is not supported.
-
-Currently, this uses either a C<dd_fd> member in the OS C<DIR>
-structure, or a dirfd(3) function as specified by POSIX.1-2008.
-
 =head1 Security
 
 XXX Any security-related notices go here.  In particular, any security
@@ -57,19 +45,6 @@ XXX For a release on a stable branch, this section aspires to be:
 
 [ List each incompatible change as a =head2 entry ]
 
-=head2 C<&> prototype accepts only subs
-
-The C<&> prototype character now accepts only anonymous subs (C<sub {...}>)
-and things beginning with C<\&>.  Formerly it erroneously also allowed
-C<undef> and references to array, hashes, and lists.  [perl #4539]
-[perl #123062]
-
-=head2 C<use encoding> is now lexical
-
-The L<encoding> pragma's effect is now limited to lexical scope.  This
-pragma is deprecated, but in the meantime, it could adversely affect
-unrelated modules that are included in the same program.
-
 =head1 Deprecations
 
 XXX Any deprecated features, syntax, modules etc. should be listed here.
@@ -103,14 +78,6 @@ as an updated module in the L</Modules and Pragmata> section.
 
 [ List each other deprecation as a =head2 entry ]
 
-=head2 Setting C<${^ENCODING}> to anything but C<undef>
-
-This variable allows Perl scripts to be written in a non-ASCII,
-non-UTF-8 encoding.  However, it affects all modules globally, leading
-to wrong answers and segmentation faults.  New scripts should be written
-in UTF-8; old scripts should be converted to UTF-8, which is easily done
-with the L<encoding> pragma.
-
 =head1 Performance Enhancements
 
 XXX Changes which enhance performance without changing behaviour go here.
@@ -122,9 +89,7 @@ There may well be none in a stable release.
 
 =item *
 
-Win32 Perl uses 8 KB less of per-process memory than before for every perl
-process of this version. This data is now memory mapped from disk and shared
-between perl processes from the same perl binary.
+XXX
 
 =back
 
@@ -154,41 +119,9 @@ XXX
 
 =item *
 
-L<B> has been upgraded from version 1.53 to 1.54.
-
-Nulled COPs are now of class C<B::COP>, rather than C<B::OP>.
-
-=item *
-
-L<B::Deparse> has been upgraded from version 1.30 to 1.31.
-
-BEGIN blocks at the end of the enclosing scope are now deparsed in the
-right place.  [perl #77452]
-
-=item *
-
-L<ExtUtils::ParseXS> has been upgraded from version 3.26 to 3.27.
-
-Only declare C<file> unused if we actually define it.
-
-Improve generated C<RETVAL> code generation to avoid repeated
-references to C<ST(0)>.  [perl #123278]
-
-=item *
-
-The PathTools module collection has been upgraded from 3.52 to 3.53.
-
-Don't turn leading C<//> into C</> on Cygwin. [perl #122635]
+L<Encode> has been upgraded from version 2.67 to 2.68.
 
-=item *
-
-L<Locale::Maketext> has been upgraded from version 1.25 to 1.26.
-
-=item *
-
-L<XSLoader> has been upgraded from version 0.19 to 0.20
-
-Don't test twice for bootstrap file.
+Building in C++ mode on Windows now works.
 
 =back
 
@@ -367,13 +300,16 @@ XXX
 
 =head2 Platform-Specific Notes
 
-=head3 Win32
+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
+=over 4
 
-=item *
+=item XXX-some-platform
 
-Intel C builds are now always built with C99 mode on.
+XXX
 
 =back
 
@@ -404,21 +340,7 @@ files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 
 =item *
 
-On Win32, restoring in a child pseudo-process a variable that was
-C<local()>ed in a parent pseudo-process before the C<fork> happened caused
-memory corruption and a crash in the child pseudo-process (and therefore OS
-process). 
-
-=item *
-
-Calling C<write> on a format with a C<^**> field could produce a panic
-in sv_chop() if there were insufficient arguments or if the variable
-used to fill the field was empty.  [perl #123245]
-
-=item *
-
-Non-ASCII lexical sub names (use in error messages) on longer have extra
-junk on the end.
+XXX
 
 =back
 
@@ -458,7 +380,7 @@ here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.21.6..HEAD
+  perl Porting/acknowledgements.pl v5.21.8..HEAD
 
 =head1 Reporting Bugs