This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
numeric.c: White-space only
[perl5.git] / pod / perldelta.pod
index 150f39e..062eef0 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.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
 
@@ -113,11 +113,9 @@ release manager will have to investigate the situation carefully.)
 
 =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
 
@@ -125,200 +123,11 @@ implemention with tests.
 
 =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
 
@@ -357,55 +166,13 @@ section.
 
 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
 
@@ -451,11 +218,7 @@ XXX Changes (i.e. rewording) of diagnostic messages go here
 
 =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
 
@@ -468,20 +231,13 @@ Most of these are built within the directory F<utils>.
 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
 
@@ -498,12 +254,7 @@ L</Platform Support> section, instead.
 
 =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
 
@@ -538,35 +289,35 @@ XXX
 
 =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
 
@@ -579,11 +330,9 @@ L</Modules and Pragmata> section.
 
 =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
 
@@ -593,27 +342,13 @@ XXX Changes which affect the interface available to C<XS> code go here.  Other
 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
 
@@ -628,16 +363,7 @@ files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 
 =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
 
@@ -677,7 +403,7 @@ died, add a short obituary here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.33.0..HEAD
+  perl Porting/acknowledgements.pl v5.35.2..HEAD
 
 =head1 Reporting Bugs