[ 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.33.1
+perldelta - what is new for perl v5.35.3
=head1 DESCRIPTION
-This document describes differences between the 5.33.0 release and the 5.33.1
+This document describes differences between the 5.35.2 release and the 5.35.3
release.
-If you are upgrading from an earlier release such as 5.32.0, first read
-L<perl5330delta>, which describes differences between 5.32.0 and 5.33.0.
+If you are upgrading from an earlier release such as 5.35.1, first read
+L<perl5352delta>, which describes differences between 5.35.1 and 5.35.2.
=head1 Notice
=over 4
-=item * ExtUtils::PL2Bat
+=item *
-This module is a generalization of the pl2bat script. It being a script has lead
-to at least two forks of this code, this modules will unify them under one
-implemention with tests.
+XXX Remove this section if not applicable.
=back
=over 4
-=item * L<feature> has been upgraded from version 1.58 to 1.60.
-
-A new C<multidimensional> feature has been added, which is enabled by
-default but allows turning off L<multi-dimensional array
-emulation|perldata/Multi-dimensional array emulation>.
-
=item *
-L<IO> has been upgraded from version 1.43 to 1.44.
-
-The C<error> method now reports the error state for both the input and
-output streams for sockets and character devices. Similarly
-C<clearerr> now clears the error state for both streams.
-
-=item * L<IPC::SysV> has been upgraded from version 2.07 to 2.08.
-
-=over 4
-
-=item - RT #129387: IPC::SysV memory operations limited to 31-bit offsets
-
-=item - Add strict and warnings to the test suite
-
-=item - Switch IPC::SysV to use XSLoader
-
-=item - Dont require ppport.h to build when inside perl core
-
-=back
-
-=item * L<JSON::PP> has been upgraded from version 4.04 to 4.05.
-
-Enforce strict and warnings in test suite
-
-=item * L<Math::Complex> has been upgraded from version 1.59_01 to 1.59_02.
-
-=over 4
-
-=item - enable strict and warnings in test suite
-
-=item - fix a unit issue from t/Complex.t
-
-=back
-
-=item * L<Pod::Usage> has been upgraded from version 1.69 to 1.70.
-
-=over 4
-
-=item - CPAN#115847: pod2usage exits with error when using "-verbose 3" with STDIN
- Addressed in pod2usage script, and updated POD
-
-=item - CPAN#122941: Pod::Usage::pod2usage() problem with $Config{scriptdir}
- Should be fixed by 1.69 already; reviewed code
-
-=item - CPAN#121489: I<> not emphasized when used with Pod::Text::Termcap
- Added specific support of ::Termcap
-
-=item - CPAN#114697: Sample code syntax error in documentation for Pod-Usage
- Fixed. Well spotted!
-
-=item - CPAN#125337: Typo in pod
- Fixed. Well spotted, too!
-
-=item - CPAN#130418: Fix parent directory in pod2usage auxiliary script
- Patch accepted, thanks!
-
-=item - CPAN#131845: $Config{pager} string can have arguments
- fixed by changing the system() command from using the array form to
- string form, and escape/quote the file path to protect any metacharacters
- in the file path
-
-=item - CPAN#131844: preferring PAGER to $Config{pager}
- Fixed with the above CPAN#131845
-
-=back
-
-=item * L<Socket> has been upgraded from version 2.029 to 2.030.
-
-Prepare for a stricter perl:
-
-=over 4
-
-=item - use strict; use warnings in all unit tests
-
-=item - declare use v5.6.1 in all perl files
-
-=back
-
-=item * L<Data::Dumper> has been upgraded from version 2.174 to 2.175.
-
-Use PERL_VERSION_* compare macro instead of incomplete PERL_VERSION checks.
-Fix some leaks issues
-
-=item * L<Devel::PPPort> has been upgraded from version 3.57 to 3.60.
-
-=over 4
-
-=item - Provide PERL_VERSION_* compare macro
-
-=item - Add PERL_VERSION_* compare macros
-
-=item - Stop versioning generated test files
-
-=item - Enforce strict & warnings
-
-=item - Avoid indirect calls
-
-=item - scanprov: multiple improvements
-
-=item - Use ivers() in tests
-
-=item - Update POD documentation and HACKERS file
-
-=item - Change ppport.h --api-info to not output non-API info unless that is the
- only match
-
-=item - Find more elements to be listed in the --api-info option (and similar) to
- ppport.h
-
-=item - Safer definition of UVCHR_SKIP
-
-=item - Make sure WIDEST_UTYPE is unsigned
-
-=item - Avoid Pax Header in tarballs
-
-=back
-
-=item * L<Exporter> has been upgraded from 5.74 version to 5.75.
-
-Store version directly in Exporter::Heavy
-
-=item * L<ExtUtils::ParseXS> has been upgraded from 3.40 version to 3.41.
-
-=over 4
-
-=item - use PERL_VERSION compare macro
-
-=item - use absolute paths in tests on all platforms
-
-=back
-
-=item * L<IO> has been upgraded from version 1.43 to 1.44.
-
-=over 4
-
-=item - Fix a spurious error reported for regular file handles
-
-=item - Enforce strict and warnings.
-
-=item - Avoid using indirect.
-
-=item - Fix a flapping test on Windows.
-
-=back
-
-=item * L<Net::Ping> has been upgraded from version 2.72 to 2.73_01.
-
-=over 4
-
-=item - Fix shadowing of hash options in constructor (Patrick Heesom, RT #131919)
-
-=item - Fix icmp v4 length with given bytes/data_size option (Patrick Heesom, RT #131919)
-
-=item - Call _resolv as class method (Marc Reissner, GH #16)
-
-=back
-
-=item * L<Safe> has been upgraded from version 2.41 to 2.42.
-
-Do not load utf8_heavy.pl in Safe.pm
-
-=item * L<Storable> has been upgraded from version 3.21 to 3.22.
-
-use PERL_COMPARE macros
-
-=item * L<Time::HiRes> has been upgraded from version 1.9764 to 1.9765.
-
-=over 4
-
-=item - Use PERL_VERSION compare macro
+L<XXX> has been upgraded from version A.xx to B.yy.
-=item - Remove obsolete vms code
-
-=back
-
-=item * L<Unicode::Normalize> has been upgraded from 1.27 version to 1.28.
-
-Use PERL_VERSION compare macro
-
-=item * L<threads::shared> has been upgraded from version 1.61 to 1.62.
-
-Use PERL_VERSION compare macro
-
-=item * L<threads> has been upgraded from version 2.25 to 2.26.
-
-Use PERL_VERSION compare macro
+If there was something important to note about this change, include that here.
=back
Additionally, the following selected changes have been made:
-=head3 L<perldebguts>
-
-Correct the description of the scalar C<< ${"_<$filename"} >>
-variables.
-
-=head3 L<perlfunc>
-
-=over 4
-
-=item *
-
-Better explain what happens when C<sleep> is called with a zero or
-negative value
-
-=back
-
-=head3 L<perlguts>
-
-=over 4
-
-=item *
-
-Correct C<my_rpeep> example in perlguts.
-
-=back
-
-=head3 L<perlop>
-
-=over 4
-
-=item *
-
-The C<< <> >> and C<<< <<>> >>> operators are commonly referred to as
-the diamond and double diamond operators respectively, but that wasn't
-mentioned previously in their documentation.
-
-=item *
-
-Document range op behavior change.
-
-=back
-
-=head3 L<perlpacktut>
+=head3 L<XXX>
=over 4
=item *
-Incorrect variables used in an example have been fixed. Thanks to Deji Adegbite.
+XXX Description of the change here
=back
=item *
-L<Use of uninitialized value%s|perldiag/"Use of uninitialized value%s">
-
-This warning may now include the array or hash index when the
-uninitialized value is the result of an element not found. This will
-only happen if the index is a simple non-magical variable.
+XXX Describe change here
=back
entries for each change
Use L<XXX> with program names to get proper documentation linking. ]
-=head2 L<perl5db.pl> (the debugger)
+=head2 L<XXX>
=over 4
-=item * New option: C<HistItemMinLength>
-
-This option controls the minimum length a command must be to get stored in
-history. Traditionally, this has been fixed at 2. Changes to the debugger
-are often perilous, and new bugs should be reported so the debugger can be
-debugged.
-
-=item * Fix to C<i> and C<l> commands
+=item *
-The C<i $var> and C<l $var> commands work again with lexical variables.
+XXX
=back
=item *
-The minimum supported Bison version is now 2.4, and the maxiumm is 3.7.
-
-=item *
-
-Newer 64-bit versions of the Intel C/C++ compiler are now recognised
-and have the correct flags set.
+XXX
=back
=head1 Platform Support
-=head2 New Platforms
-
-=over 4
-
-=item 9front
+XXX Any changes to platform support should be listed in the sections below.
-Allow building Perl on i386 9front systems (fork of plan9).
+[ Within the sections, list each platform as an =item entry with specific
+changes as paragraphs below it. ]
-=back
+=head2 New Platforms
-=head2 Updated Platforms
+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.
=over 4
-=item Plan9
+=item XXX-some-platform
-Improve support for Plan9 on i386 platforms.
+XXX
=back
=head2 Discontinued Platforms
+XXX List any platforms that this version of perl no longer compiles on.
+
=over 4
-=item Symbian
+=item XXX-some-platform
-Support code relating to Symbian has been removed. Symbian was an
-operating system for mobile devices. The port was last updated in July
-2009, and the platform itself in October 2012.
+XXX
=back
=over 4
-=item z/OS
+=item XXX-some-platform
-The locale categories C<LC_SYNTAX> and C<LC_TOD> are now recognized.
-Perl doesn't do anything with these, except it now allows you to specify
-them. They are included in C<LC_ALL>.
+XXX
=back
significant internal changes for future core maintainers should be noted as
well.
-=over 4
-
-=item *
+[ List each change as an =item entry ]
-The C<PERL_GLOBAL_STRUCT> compilation option has been removed, and
-with it the need or the C<dVAR> macro. C<dVAR> remains defined as a
-no-op outside C<PERL_CORE> for backwards compatiblity with XS modules.
-
-=item *
-
-A new savestack type C<SAVEt_HINTS_HH> has been added, which neatens the
-previous behaviour of C<SAVEt_HINTS>. On previous versions the types and
-values pushed to the save stack would depend on whether the hints included the
-C<HINT_LOCALIZE_HH> bit, which complicates external code that inspects the
-save stack. The new version uses a different savestack type to indicate the
-difference.
+=over 4
=item *
-A new API function L<perlapi/av_count> has been added which gives a
-clearly named way to find how many elements are in an array.
+XXX
=back
=item *
-IO::Handle: Fix a spurious error reported for regular file handles. GH #18019
-
-=item *
-
-On Win32, C<waitpid(-1, WNOHANG)> could sometimes have a very large
-timeout. GH #16529
-
-=item *
-
-C<MARK> and hence C<items> are now correctly initialized in BOOT XSUBs.
+XXX
=back
XXX Generate this with:
- perl Porting/acknowledgements.pl v5.33.0..HEAD
+ perl Porting/acknowledgements.pl v5.35.2..HEAD
=head1 Reporting Bugs