From b129a266d6823b046882274a5990e820d8e6c7bd Mon Sep 17 00:00:00 2001 From: Sawyer X Date: Fri, 21 May 2021 00:59:42 +0200 Subject: New perldelta --- MANIFEST | 1 + Makefile.SH | 8 +- pod/.gitignore | 2 +- pod/perl.pod | 1 + pod/perl5340delta.pod | 1456 ++++++++++++++++++++++++++++++++++++++++++++++ pod/perldelta.pod | 1381 ++++++------------------------------------- vms/descrip_mms.template | 2 +- win32/GNUmakefile | 4 +- win32/Makefile | 4 +- win32/pod.mak | 4 + 10 files changed, 1656 insertions(+), 1207 deletions(-) create mode 100644 pod/perl5340delta.pod diff --git a/MANIFEST b/MANIFEST index 20548634b2..8de1495e15 100644 --- a/MANIFEST +++ b/MANIFEST @@ -5231,6 +5231,7 @@ pod/perl5302delta.pod Perl changes in version 5.30.2 pod/perl5303delta.pod Perl changes in version 5.30.3 pod/perl5320delta.pod Perl changes in version 5.32.0 pod/perl5321delta.pod Perl changes in version 5.32.1 +pod/perl5340delta.pod Perl changes in version 5.34.0 pod/perl561delta.pod Perl changes in version 5.6.1 pod/perl56delta.pod Perl changes in version 5.6 pod/perl581delta.pod Perl changes in version 5.8.1 diff --git a/Makefile.SH b/Makefile.SH index 2895bfcace..682e9fdd81 100755 --- a/Makefile.SH +++ b/Makefile.SH @@ -589,7 +589,7 @@ esac $spitshell >>$Makefile <<'!NO!SUBS!' -perltoc_pod_prereqs = extra.pods pod/perl5340delta.pod pod/perlapi.pod pod/perlintern.pod pod/perlmodlib.pod pod/perluniprops.pod +perltoc_pod_prereqs = extra.pods pod/perl5350delta.pod pod/perlapi.pod pod/perlintern.pod pod/perlmodlib.pod pod/perluniprops.pod generated_pods = pod/perltoc.pod $(perltoc_pod_prereqs) generated_headers = uudmap.h bitcount.h mg_data.h @@ -1153,9 +1153,9 @@ pod/perlintern.pod: $(MINIPERL_EXE) autodoc.pl embed.fnc pod/perlmodlib.pod: $(MINIPERL_EXE) pod/perlmodlib.PL MANIFEST $(MINIPERL) pod/perlmodlib.PL -q -pod/perl5340delta.pod: pod/perldelta.pod - $(RMS) pod/perl5340delta.pod - $(LNS) perldelta.pod pod/perl5340delta.pod +pod/perl5350delta.pod: pod/perldelta.pod + $(RMS) pod/perl5350delta.pod + $(LNS) perldelta.pod pod/perl5350delta.pod extra.pods: $(MINIPERL_EXE) -@test ! -f extra.pods || rm -f `cat extra.pods` diff --git a/pod/.gitignore b/pod/.gitignore index aec3558ec2..ece6b94e50 100644 --- a/pod/.gitignore +++ b/pod/.gitignore @@ -48,7 +48,7 @@ /roffitall # generated -/perl5340delta.pod +/perl5350delta.pod /perlapi.pod /perlintern.pod /perlmodlib.pod diff --git a/pod/perl.pod b/pod/perl.pod index 5f0815eb25..6eed2b9f5a 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -179,6 +179,7 @@ aux h2ph h2xs perlbug pl2pm pod2html pod2man splain xsubpp perlhist Perl history records perldelta Perl changes since previous version + perl5340delta Perl changes in version 5.34.0 perl5321delta Perl changes in version 5.32.1 perl5320delta Perl changes in version 5.32.0 perl5303delta Perl changes in version 5.30.3 diff --git a/pod/perl5340delta.pod b/pod/perl5340delta.pod new file mode 100644 index 0000000000..23235fb634 --- /dev/null +++ b/pod/perl5340delta.pod @@ -0,0 +1,1456 @@ +=encoding utf8 + +=head1 NAME + +perl5340delta - what is new for perl v5.34.0 + +=head1 DESCRIPTION + +This document describes differences between the 5.32.0 release and the 5.34.0 +release. + +If you are upgrading from an earlier release such as 5.30.0, first read +L, which describes differences between 5.30.0 and 5.32.0. + +=head1 Core Enhancements + +=head2 Experimental Try/Catch Syntax + +An initial experimental attempt at providing C/C notation has +been added. + + use feature 'try'; + + try { + a_function(); + } + catch ($e) { + warn "An error occurred: $e"; + } + +For more information, see L. + +=head2 C is now accepted + +An empty lower bound is now accepted for regular expression quantifiers, +like C<{,3}>. + +=head2 Blanks freely allowed within but adjacent to curly braces + +(in double-quotish contexts and regular expression patterns) + +This means you can write things like S> if you like. This +applies to all such constructs, namely C<\b{}>, C<\g{}>, C<\k{}>, +C<\N{}>, C<\o{}>, and C<\x{}>; as well as the regular expression +quantifier C<{I,I}>. C<\p{}> and C<\P{}> retain their +already-existing, even looser, rules mandated by the Unicode standard +(see L). + +This ability is in effect regardless of the presence of the C +regular expression pattern modifier. + +Additionally, the comma in a regular expression braced quantifier may +have blanks (tabs or spaces) before and/or after the comma, like +S>. + +=head2 New octal syntax C<0oI> + +It is now possible to specify octal literals with C<0o> prefixes, +as in C<0o123_456>, parallel to the existing construct to specify +hexadecimal literal C<0xI> and binary literal C<0bI>. +Also, the builtin C function now accepts this new syntax. + +See L and L. + +=head1 Performance Enhancements + +=over 4 + +=item * + +Fix a memory leak in RegEx +[L] + +=back + +=head1 Modules and Pragmata + +=head2 New Modules and Pragmata + +=over 4 + +=item * + +L 0.004 has been added to the Perl core. + +This module is a generalization of the C script. It being a script has +led to at least two forks of this code; this module will unify them under one +implementation with tests. + +=back + +=head2 Updated Modules and Pragmata + +=over 4 + +=item * + +L has been upgraded from version 2.36 to 2.38. + +=item * + +L has been upgraded from version 2.32 to 2.34. + +=item * + +L has been upgraded from version 1.80 to 1.82. + +=item * + +L has been upgraded from version 1.54 to 1.56. + +=item * + +L has been upgraded from version 1.07 to 1.08. + +=item * + +L has been upgraded from version 1.50 to 1.52. + +=item * + +L has been upgraded from version 2.093 to 2.101. + +=item * + +L has been upgraded from version 2.093 to 2.101. + +=item * + +L has been upgraded from version 0.32 to 0.33. + +=item * + +L has been upgraded from version 2.27 to 2.28. + +=item * + +L has been upgraded from version 2.174 to 2.179. + +=item * + +L has been upgraded from version 1.58 to 1.59. + +=item * + +L has been upgraded from version 1.853 to 1.855. + +=item * + +L has been upgraded from version 1.28 to 1.30. + +=item * + +L has been upgraded from version 3.57 to 3.62. + +New C comparison macros are now available. + +C no longer includes non-API info unless that is the only +match + +=item * + +L has been upgraded from version 1.17_01 to 1.19. + +=item * + +L has been upgraded from version 2.55_01 to 2.58. + +=item * + +L has been upgraded from version 1.47 to 1.50. + +=item * + +L has been upgraded from version 3.06 to 3.08. + +=item * + +L has been upgraded from version 1.04 to 1.05. + +=item * + +L has been upgraded from version 1.30 to 1.33. + +=item * + +L has been upgraded from version 0.020 to 0.024. + +=item * + +L has been upgraded from version 5.74 to 5.76. + +=item * + +L has been upgraded from version 0.280234 to 0.280236. + +=item * + +L has been upgraded from version 2.14 to 2.20. + +=item * + +L has been upgraded from version 7.44 to 7.62. + +=item * + +L has been upgraded from version 1.72 to 1.73. + +=item * + +L has been upgraded from version 1.09 to 1.10. + +=item * + +L has been upgraded from version 3.40 to 3.43. + +=item * + +L has been upgraded from version 3.38 to 3.43. + +=item * + +L has been upgraded from version 1.13 to 1.14. + +=item * + +L has been upgraded from version 1.58 to 1.64. + +Added the default enabled C feature. + +A new L +feature has been added, which is enabled by +default but allows turning off L. + +=item * + +L has been upgraded from version 2.34 to 2.35. + +=item * + +L has been upgraded from version 0.56 to 1.00. + +=item * + +L has been upgraded from version 1.37 to 1.39. + +=item * + +L has been upgraded from version 2.16 to 2.18. + +=item * + +L has been upgraded from version 3.78 to 3.80. + +=item * + +L has been upgraded from version 0.2309 to 0.2311. + +=item * + +L has been upgraded from version 1.59 to 1.60. + +=item * + +L has been upgraded from version 1.51 to 1.52. + +=item * + +L has been upgraded from version 1.18 to 1.19. + +New functions and compatibility for newer versions of GDBM. +[L] + +=item * + +L has been upgraded from version 2.51 to 2.52. + +=item * + +L has been upgraded from version 1.12 to 1.13. + +=item * + +L has been upgraded from version 0.23 to 0.25. + +=item * + +L has been upgraded from version 1.20 to 1.21. + +=item * + +L has been upgraded from version 0.44 to 0.45. + +=item * + +L has been upgraded from version 0.0608 to 0.0609. + +=item * + +L has been upgraded from version 1.43 to 1.46. + +IO::Socket now stores error messages in C<$IO::Socket::errstr>, in +addition to in C<$@>. + +The C method now reports the error state for both the input and +output streams for sockets and character devices. Similarly +C now clears the error state for both streams. + +A spurious error reported for regular file handles has been +fixed in L. +[L] + +=item * + +IO-Compress has been upgraded from version 2.093 to 2.102. + +bin/zipdetails version 2.02 + +=item * + +L has been upgraded from version 0.39 to 0.41. + +=item * + +L has been upgraded from version 1.10 to 1.11. + +=item * + +L has been upgraded from version 2.07 to 2.09. + +=item * + +L has been upgraded from version 4.04 to 4.06. + +=item * + +The libnet distribution has been upgraded from version 3.11 to 3.13. + +=item * + +L has been upgraded from version 1.09 to 1.10. + +=item * + +L has been upgraded from version 1.5901 to 1.5902. + +=item * + +L has been upgraded from version 3.15 to 3.16. + +=item * + +L has been upgraded from version 5.20200620 to 5.20210520. + +=item * + +L has been upgraded from version 0.34 to 0.36. + +=item * + +L has been upgraded from version 0.70 to 0.74. + +=item * + +L has been upgraded from version 1.23 to 1.25_001. + +=item * + +L has been upgraded from version 2.72 to 2.74. + +=item * + +L has been upgraded from version 0.67_01 to 0.68. + +=item * + +L has been upgraded from version 1.16 to 1.17. + +=item * + +L has been upgraded from version 1.47 to 1.50. + +=item * + +L has been upgraded from version 1.31 to 1.33. + +=item * + +L has been upgraded from version 5.20200523 to 5.20210411. + +=item * + +L has been upgraded from version 0.28 to 0.30. + +=item * + +L has been upgraded from version 0.016 to 0.017. + +=item * + +L has been upgraded from version 0.30 to 0.31. + +=item * + +L has been upgraded from version 0.08 to 0.09. + +=item * + +L has been upgraded from version 1.73 to 1.74. + +=item * + +L has been upgraded from version 1.25 to 1.27. + +=item * + +L has been upgraded from version 3.40 to 3.42. + +=item * + +L has been upgraded from version 1.69 to 2.01. + +=item * + +L has been upgraded from version 1.94 to 1.97. + +POSIX::signbit() behaviour has been improved. +[L] + +Documentation for C clarifies that the result is always in English. +(Use C for a localized result.) + +=item * + +L has been upgraded from version 0.40 to 0.41. + +(See under L for more information.) + +=item * + +L has been upgraded from version 2.41 to 2.43. + +=item * + +L has been upgraded from version 2.029 to 2.031. + +=item * + +L has been upgraded from version 3.21 to 3.23. + +=item * + +L has been upgraded from version 1.11 to 1.12. + +=item * + +L has been upgraded from version 1.03 to 1.04. + +=item * + +L has been upgraded from version 1.08 to 1.09. + +=item * + +L has been upgraded from version 3.42 to 3.43. + +=item * + +L has been upgraded from version 1.302175 to 1.302183. + +=item * + +L has been upgraded from version 2.03 to 2.04. + +=item * + +L has been upgraded from version 2.25 to 2.26. + +=item * + +L has been upgraded from version 1.61 to 1.62. + +=item * + +L has been upgraded from version 1.39 to 1.40. + +=item * + +L has been upgraded from version 1.9764 to 1.9767. + +=item * + +L has been upgraded from version 1.28 to 1.30. + +=item * + +L has been upgraded from version 1.27 to 1.29. + +=item * + +L has been upgraded from version 1.27 to 1.28. + +=item * + +L has been upgraded from version 1.22 to 1.24. + +=item * + +L has been upgraded from version 0.9924 to 0.9928. + +=item * + +L has been upgraded from version 1.47 to 1.51. + +=item * + +L has been upgraded from version 0.53 to 0.57. + +Fix calling convention for C. + +Added C, +C, and C. + +Removed old code for versions before Windows 2000. + +=item * + +L has been upgraded from version 1.09 to 1.16. + +=item * + +L has been upgraded from version 0.17 to 0.18. + +=back + +=head1 Documentation + +=head2 New Documentation + +=head3 L + +This document is a guide for the authorship and maintenance of the +documentation that ships with Perl. + +=head3 L + +This document describes the goals, scope, system, and rules for Perl's new +governance model. + +Other pod files, most notably L, were amended to reflect +its adoption. + +=head2 Changes to Existing Documentation + +We have attempted to update the documentation to reflect the changes +listed in this document. If you find any we have missed, open an issue +at L. + +Additionally, the following selected changes have been made: + +=over 4 + +=item * + +L, L, L, and L now prefer C +over C. + +=item * + +References to B have been replaced with a more accurate term or +B where appropriate. + +=item * + +B is now the fallback contact for security issues. + +=back + +=head3 L + +=over 4 + +=item * + +Efforts continue in improving the presentation of this document, and to +document more API elements. + +=back + +=head3 L + +=over 4 + +=item * + +The freenode IRC URL has been updated. + +=back + +=head3 L + +=over 4 + +=item * + +Corrected the description of the scalar C<< ${"_<$filename"} >> +variables. + +=back + +=head3 L + +=over 4 + +=item * + +Now documents additional examples of "not imported" warnings. + +=back + +=head3 L + +=over 4 + +=item * + +The Perl FAQ was updated to CPAN version 5.20201107 with minor +improvements. + +=back + +=head3 L + +=over 4 + +=item * + +L and L now explicitly warn +the reader that lexical variables should typically not be redeclared +within the same scope or statement. +[L] + +=item * + +The L entry has been improved and now +also states that the result of the function is always in English. + +=item * + +L documented a length field included in the +packed C parameter to C, but there was no such field. +C contains only the type and the message content. + +=item * + +Better explanation of what happens when C is called with a zero or +negative value. + +=item * + +Simplify the C documentation by removing the Cs from the +examples +[L] + +=back + +=head3 L + +=over 4 + +=item * + +document how to create a remote-tracking branch for every PR + +=item * + +document how to get a PR as a local branch + +=back + +=head3 L + +=over 4 + +=item * + +L now explains in greater detail the need to consult C +when calling C (or variants). A new "How do I pass a Perl string to a C +library?" section in the same document discusses when to use which style of +macro to read an SV's string value. + +=item * + +Corrected C example in perlguts. + +=item * + +A section has been added on the formatted printing of special sizes. + +=back + +=head3 L + +=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 + +=over 4 + +=item * + +Incorrect variables used in an example have been fixed. + +=back + +=head3 L + +=over 4 + +=item * + +Document that caller() does not see try{} blocks + +=item * + +A new example shows how a lexical C variable can be declared +during the initialization of a C loop. + +=back + +=head3 L + +=over 4 + +=item * + +Fix description of what Perl does with unencoded strings + +=back + +=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. + +=head2 New Diagnostics + +=head3 New Errors + +=over 4 + +=item * + +L + +This accompanies the new +L feature. + +=item * + +L + +This accompanies the new +L feature. + +=back + +=head3 New Warnings + +=over 4 + +=item * + +L + +Attempts to put wide characters into environment variable keys via C<%ENV> now +provoke this warning. + +=back + +=head2 Changes to Existing Diagnostics + +=over 4 + +=item * + +L + +An error was encountered in handling a user-defined property +(L). These are +programmer written subroutines, hence subject to errors that may +prevent them from compiling or running. + +=item * + +L + +A user-defined property (L) +can depend on the definitions of other user-defined +properties. If the chain of dependencies leads back to this property, +infinite recursion would occur, were it not for the check that raised +this error. + +=item * + +L + +The first time a user-defined property +(L) is used, its +definition is looked up and converted into an internal form for more +efficient handling in subsequent uses. There could be a race if two or +more threads tried to do this processing nearly simultaneously. + +=item * + +L + +You specified to use a property within the C<\p{...}> which was a +syntactically valid user-defined property, but no definition was found +for it + +=item * + +L + +Subroutine argument-count mismatch errors now include the number of +given and expected arguments. + +=item * + +L + +Subroutine argument-count mismatch errors now include the number of +given and expected arguments. + +=item * + +L + +This warning was only issued for positive too-large values when +incrementing, and only for negative ones when decrementing. +It is now issued for both positive or negative too-large values. +[L] + +=item * + +L<\K not permitted in lookahead/lookbehind in regex; marked by <-- HERE in mE%sE|perldiag/"\K not permitted in lookahead/lookbehind in regex; marked by <-- HERE in m/%s/"> + +This error was incorrectly produced in some cases involving nested +lookarounds. This has been fixed. +[L] + +=item * + +L + +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. + +=back + +=head1 Utility Changes + +=head2 L (the debugger) + +=over 4 + +=item * New option: C + +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 and C commands + +The C and C commands work again with lexical variables. + +=back + +=head1 Configuration and Compilation + +=over 4 + +=item * + +Prevented incpath to spill into libpth + +=item * + +Use realpath if available. (This might catch more duplicate paths.) + +=item * + +Only include real existing paths. + +=item * + +Filter inc paths out of libpth. + +=item * stadtx hash support has been removed + +stadtx support has been entirely removed. Previously, it could be requested +with C, and was default in 64-bit builds. It has been +replaced with SipHash. SipHash has been more rigorously reviewed than stadtx. + +=item * Configure + +A new probe checks for buggy libc implementations of the C/C +functions. +[L] + +=item * C<-Dusedefaultstrict> + +Perl can now be built with L on by default (using the configuration +option C<-Dusedefaultstrict>. + +These strict defaults do not apply when C is run via C<-e> or C<-E>. + +This setting provides a diagnostic mechanism intended for development +purposes only and is thus undefined by default. + +=item * + +The minimum supported Bison version is now 2.4, and the maximum is 3.7. + +=item * + +Newer 64-bit versions of the Intel C/C++ compiler are now recognised +and have the correct flags set. + +=item * + +We now trap SIGBUS when F checks for C. + +On several systems the attempt to determine if we need C or similar +results in a SIGBUS instead of the expected SIGSEGV, which previously caused a +core dump. + +[L] + +=back + +=head1 Testing + +Tests were added and changed to reflect the other additions and +changes in this release. Furthermore, these significant changes were +made: + +=over 4 + +=item * + +Split Config-dependent tests in F to F + +=item * + +F was added, providing a test harness for regexp optimization. +[L] + +=item * + +A workaround for CPAN distributions needing dot in C<@INC> has been removed +[L]. +All distributions that previously required the workaround have now been +adapted. + +=item * + +When testing in parallel on many-core platforms, you can now cause the +test suite to finish somewhat earlier, but with less logical ordering of +the tests, by setting + + PERL_TEST_HARNESS_ASAP=1 + +while running the test suite. + +=back + +=head1 Platform Support + +=head2 New Platforms + +=over 4 + +=item 9front + +Allow building Perl on i386 9front systems (a fork of plan9). + +=back + +=head2 Updated Platforms + +=over 4 + +=item Plan9 + +Improve support for Plan9 on i386 platforms. + +=item MacOS (Darwin) + +The hints file for darwin has been updated to handle future MacOS versions +beyond 10. [L] + +=back + +=head2 Discontinued Platforms + +=over 4 + +=item Symbian + +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. + +=back + +=head2 Platform-Specific Notes + +=over 4 + +=item DragonFlyBSD + +Tests were updated to workaround DragonFlyBSD bugs in L and L. + +=item Mac OS X + +A number of system libraries no longer exist as actual files on Big Sur, +even though C will pretend they do, so now we fall back to C +if a library file can not be found. +[L] + +=item Windows + +Reading non-ASCII characters from the console when its codepage was set to +65001 (UTF-8) was broken due to a bug in Windows. A workaround for this +problem has been implemented. +[L] + +Building with mingw.org compilers (version 3.4.5 or later) using mingw runtime +versions < 3.22 now works again. This was broken in Perl 5.31.4. + +Building with mingw.org compilers (version 3.4.5 or later) using mingw runtime +versions >= 3.21 now works (for compilers up to version 5.3.0). + +F, and thus support for dmake, has been removed. It is still +possible to build Perl on Windows using nmake (Makefile) and GNU make +(GNUmakefile). +[L] + +perl can now be built with C on MS Windows using +(32-bit and 64-bit) mingw-w64 ports of gcc. +[L] + +The F utility now needs to C. This could +cause failures in parallel builds. + +Windows now supports L and +L, and L is no +longer an alias for L. +[L]. + +Unlike POSIX systems, creating a symbolic link on Windows requires +either elevated privileges or Windows 10 1703 or later with Developer +Mode enabled. + +stat(), including C, and lstat() now uses our own +implementation that populates the device C and inode numbers +C returned rather than always returning zero. The number of +links C field is now always populated. + +L<< C<${^WIN32_SLOPPY_STAT}> |perlvar/${^WIN32_SLOPPY_STAT} >> previously +controlled whether the C field was populated requiring a +separate Windows API call to fetch, since C and the other +information required for C is now retrieved in a single API call. + +The C<-r> and C<-w> operators now return true for the C, +C and C handles. Unfortunately it still won't return +true for duplicates of those handles. +[L]. + +The times returned by stat() and lstat() are no longer incorrect +across Daylight Savings Time adjustments. +[L]. + +C<-x> on a filehandle should now match C<-x> on the corresponding +filename on Vista or later. +[L]. + +C<-e '"'> no longer incorrectly returns true. +[L]. + +The same manifest is now used for Visual C++ and gcc builds. + +Previously, MSVC builds were using the B flag instead of +embedding F, which caused issues such as C +returning the wrong version number on Windows 10. + +=item z/OS + +The locale categories C and C are now recognized. +Perl doesn't do anything with these, except it now allows you to specify +them. They are included in C. + +=back + +=head1 Internal Changes + +=over 4 + +=item * + +Corrected handling of double and long double parameters for perl's +implementation of formatted output for C<-Dusequadmath> builds. + +This applies to C, C, C, C and +their variants. + +Previously in C builds, code like: + + PerlIO_printf(PerlIO_stderr(), "%g", somedouble); + +or + + PerlIO_printf(PerlIO_stderr(), "%Lg", somelongdouble); + +would erroneously throw an exception "panic: quadmath invalid format +...", since the code added for quadmath builds assumed Cs were the +only floating point format passed into these functions. + +This code would also process the standard C long double specifier C +as if it expected an C (C<__float128> for quadmath builds), +resulting in undefined behaviour. + +These functions now correctly accept doubles, long doubles and NVs. + +=item * + +Previously the right operand of bitwise shift operators (shift amount) +was implicitly cast from IV to int, but it might lead wrong results +if IV does not fit in int. + +And also, shifting INT_MIN bits used to yield the shiftee unchanged +(treated as 0-bit shift instead of negative shift). + +=item * + +A set of C functions was added, +to support checking for the existence of keys in the hints hash of a +specific cop without needing to create a mortal copy of said value. + +=item * + +An aid has been added for using the C macros when debugging XS or +C code. The comments in F describe C and +C. which you can C<#define> to do things like save and +restore C, in case the C calls are interfering with that, +or to display timestamps, or which thread it's coming from, or the +location of the call, or whatever. You can make a quick hack to help +you track something down without having to edit individual C +calls. + +=item * + +Make C available outside of core + +=item * + +All C-ish functions now evaluate their arguments exactly once. +In 5.32, plain L> was changed to do that; now the rest +do as well. + +=item * + +Unicode is now a first class citizen when considering the pattern /A*B/ where +A and B are arbitrary. The pattern matching code tries to make a tight loop +to match the span of A's. The logic of this was now really updated with +support for UTF-8. + +=item * + +The L module has a new function C, which can return a +hashref of optimization data discovered about a compiled regexp. + +=item * + +The C compilation option has been removed, and +with it the need or the C macro. C remains defined as a +no-op outside C for backwards compatiblity with XS modules. + +=item * + +A new savestack type C has been added, which neatens the +previous behaviour of C. On previous versions the types and +values pushed to the save stack would depend on whether the hints included the +C bit, which complicates external code that inspects the +save stack. The new version uses a different savestack type to indicate the +difference. + +=item * + +A new API function L has been added which gives a +clearly named way to find how many elements are in an array. + +=back + +=head1 Selected Bug Fixes + +=over 4 + +=item * + +Setting C<%ENV> now properly handles upgraded strings in the key. Previously +Perl sent the SV's internal PV directly to the OS; now it will handle keys +as it has handled values since 5.18: attempt to downgrade the string first; +if that fails then warn and use the utf8 form. + +=item * + +Fix a memory leak in regcomp.c +[L] + +=item * pack/unpack format 'D' now works on all systems that could support it + +Previously if C, now it is supported on all platforms that +have long doubles. In particular that means it is now also supported on +quadmath platforms. + +=item * + +Skip trying to constant fold an incomplete op tree +[L] + +Constant folding of chained comparison op trees could fail under certain +conditions, causing perl to crash. As a quick fix, constant folding is +now skipped for such op trees. This also addresses +[L]. + +=item * + +C<%g> formatting broken on Ubuntu-18.04, C +[L] + +Buggy libc implementations of the C and C functions +caused C<(s)printf> to incorrectly truncate C<%g> formatted numbers. +A new Configure probe now checks for this, with the result that the libc +C will be used in place of C and C. + +Tests added as part of this fix also revealed related problems in +some Windows builds. The makefiles for MINGW builds on Windows have +thus been adjusted to use C by default, ensuring +that they also provide correct C<(s)printf> formatting of numbers. + +=item * + +F: croak on C when C is in effect +[L] + +The lexical topic feature experiment was removed in Perl v5.24 and +declaring C became a compile time error. However, it was previously +still possible to make this declaration if C was in effect. + +=item * + +F: Fix assertion failure +[L] + +Fuzzing triggered an assertion failure in the regexp engine when too many +characters were copied into a buffer. + +=item * + +L, L, and +L now properly reset the UTF-8 flag on the +C parameter if it's modified for C or C +operations. + +=item * + +C, C, and C now attempt to downgrade the C +parameter if its value is being used as input to C or +C calls. A failed downgrade will thrown an exception. + +=item * + +In cases where C, C or C would treat the C +parameter as a pointer, an undefined value no longer generates a +warning. In most such calls the pointer isn't used anyway and this +allows you to supply C for a value not used by the underlying +function. + +=item * + +L now downgrades the C parameter, +L now downgrades the C parameter and +L now downgrades the C parameter +to treat them as bytes. Previously they would be left upgraded, +providing a corrupted structure to the underlying function call. + +=item * + +L now properly resets the UTF-8 flag the +C parameter when it is modified. Previously the UTF-8 flag could +be left on, resulting in a possibly corrupt result in C. + +=item * + +Magic is now called correctly for stacked file test operators. +[L] + +=item * + +The C<@ary = split(...)> optimization no longer switches in the target +array as the value stack. +[L] +Also see discussion at +L. + +=item * + +Fixed a bug in which some regexps with recursive subpatterns matched +incorrectly. + +[L] + +=item * + +On Win32, C could sometimes have a very large +timeout. [L] + +=item * + +C and hence C are now correctly initialized in C XSUBs. + +=item * + +Some list assignments involving C on the left-hand side were +over-optimized and produced incorrect results. +[L], +[L] + +=back + +=head1 Known Problems + +None + +=head1 Errata From Previous Releases + +None + +=head1 Obituary + +Kent Fredric (KENTNL) passed away in February 2021. A native of New Zealand +and a self-described "huge geek," Kent was the author or maintainer of 178 +CPAN distributions, the Perl maintainer for the Gentoo Linux distribution and +a contributor to the Perl core distribution. He is mourned by his family, +friends and open source software communities worldwide. + +=head1 Acknowledgements + +Perl 5.34.0 represents approximately 11 months of development since Perl +5.32.0 and contains approximately 280,000 lines of changes across 2,100 +files from 78 authors. + +Excluding auto-generated files, documentation and release tools, there were +approximately 150,000 lines of changes to 1,300 .pm, .t, .c and .h files. + +Perl continues to flourish into its fourth decade thanks to a vibrant +community of users and developers. The following people are known to have +contributed the improvements that became Perl 5.34.0: + +Aaron Crane, Adam Hartley, Andy Dougherty, Ben Cornett, Branislav +Zahradník, brian d foy, Chris 'BinGOs' Williams, Christian Walde +(Mithaldu), Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Book, Daniel +Böhmer, Daniel Laügt, Dan Kogai, David Cantrell, David Mitchell, Dominic +Hamon, E. Choroba, Ed J, Eric Herman, Eric Lindblad, Eugene Alvin Villar, +Felipe Gasper, Giovanni Tataranni, Graham Knop, Graham Ollis, Hauke D, +H.Merijn Brand, Hugo van der Sanden, Ichinose Shogo, Ivan Baidakou, Jae +Bradley, James E Keenan, Jason McIntosh, jkahrman, John Karr, John Lightsey, +Kang-min Liu, Karen Etheridge, Karl Williamson, Keith Thompson, Leon +Timmermans, Marc Reisner, Marcus Holland-Moritz, Max Maischein, Michael G +Schwern, Nicholas Clark, Nicolas R., Paul Evans, Petr Písař, raiph, Renee +Baecker, Ricardo Signes, Richard Leach, Romano, Ryan Voots, Samanta Navarro, +Samuel Thibault, Sawyer X, Scott Baker, Sergey Poznyakoff, Sevan Janiyan, +Shirakata Kentaro, Shlomi Fish, Sisyphus, Sizhe Zhao, Steve Hay, TAKAI +Kousuke, Thibault Duponchelle, Todd Rinaldo, Tomasz Konojacki, Tom Hukins, +Tom Stellard, Tony Cook, vividsnow, Yves Orton, Zakariyya Mughal, +Михаил Козачков. + +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. + +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. + +For a more complete list of all of Perl's historical contributors, please +see the F file in the Perl source distribution. + +=head1 Reporting Bugs + +If you find what you think is a bug, you might check the perl bug database +at L. There may also be information at +L, the Perl Home Page. + +If you believe you have an unreported bug, please open an issue at +L. Be sure to trim your bug down to a +tiny but sufficient test case. + +If the bug you are reporting has security implications which make it +inappropriate to send to a public issue tracker, then see +L +for details of how to report the issue. + +=head1 Give Thanks + +If you wish to thank the Perl 5 Porters for the work we had done in Perl 5, +you can do so by running the C program: + + perlthanks + +This will send an email to the Perl 5 Porters list with your show of thanks. + +=head1 SEE ALSO + +The F file for an explanation of how to view exhaustive details on +what changed. + +The F file for how to build Perl. + +The F file for general stuff. + +The F and F files for copyright information. + +=cut diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 32ec12231a..871815c44d 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -2,752 +2,177 @@ =head1 NAME -perldelta - what is new for perl v5.34.0 +[ this is a template for a new perldelta file. Any text flagged as XXX needs +to be processed before release. ] -=head1 DESCRIPTION - -This document describes differences between the 5.32.0 release and the 5.34.0 -release. - -If you are upgrading from an earlier release such as 5.30.0, first read -L, which describes differences between 5.30.0 and 5.32.0. - -=head1 Core Enhancements - -=head2 Experimental Try/Catch Syntax - -An initial experimental attempt at providing C/C notation has -been added. - - use feature 'try'; - - try { - a_function(); - } - catch ($e) { - warn "An error occurred: $e"; - } - -For more information, see L. - -=head2 C is now accepted - -An empty lower bound is now accepted for regular expression quantifiers, -like C<{,3}>. - -=head2 Blanks freely allowed within but adjacent to curly braces - -(in double-quotish contexts and regular expression patterns) - -This means you can write things like S> if you like. This -applies to all such constructs, namely C<\b{}>, C<\g{}>, C<\k{}>, -C<\N{}>, C<\o{}>, and C<\x{}>; as well as the regular expression -quantifier C<{I,I}>. C<\p{}> and C<\P{}> retain their -already-existing, even looser, rules mandated by the Unicode standard -(see L). - -This ability is in effect regardless of the presence of the C -regular expression pattern modifier. - -Additionally, the comma in a regular expression braced quantifier may -have blanks (tabs or spaces) before and/or after the comma, like -S>. - -=head2 New octal syntax C<0oI> - -It is now possible to specify octal literals with C<0o> prefixes, -as in C<0o123_456>, parallel to the existing construct to specify -hexadecimal literal C<0xI> and binary literal C<0bI>. -Also, the builtin C function now accepts this new syntax. - -See L and L. - -=head1 Performance Enhancements - -=over 4 - -=item * - -Fix a memory leak in RegEx -[L] - -=back - -=head1 Modules and Pragmata - -=head2 New Modules and Pragmata - -=over 4 - -=item * - -L 0.004 has been added to the Perl core. - -This module is a generalization of the C script. It being a script has -led to at least two forks of this code; this module will unify them under one -implementation with tests. - -=back - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L has been upgraded from version 2.36 to 2.38. - -=item * - -L has been upgraded from version 2.32 to 2.34. - -=item * - -L has been upgraded from version 1.80 to 1.82. - -=item * - -L has been upgraded from version 1.54 to 1.56. - -=item * - -L has been upgraded from version 1.07 to 1.08. - -=item * - -L has been upgraded from version 1.50 to 1.52. - -=item * - -L has been upgraded from version 2.093 to 2.101. - -=item * - -L has been upgraded from version 2.093 to 2.101. - -=item * - -L has been upgraded from version 0.32 to 0.33. - -=item * - -L has been upgraded from version 2.27 to 2.28. - -=item * - -L has been upgraded from version 2.174 to 2.179. - -=item * - -L has been upgraded from version 1.58 to 1.59. - -=item * - -L has been upgraded from version 1.853 to 1.855. - -=item * - -L has been upgraded from version 1.28 to 1.30. - -=item * - -L has been upgraded from version 3.57 to 3.62. - -New C comparison macros are now available. - -C no longer includes non-API info unless that is the only -match - -=item * - -L has been upgraded from version 1.17_01 to 1.19. - -=item * - -L has been upgraded from version 2.55_01 to 2.58. - -=item * - -L has been upgraded from version 1.47 to 1.50. - -=item * - -L has been upgraded from version 3.06 to 3.08. - -=item * - -L has been upgraded from version 1.04 to 1.05. - -=item * - -L has been upgraded from version 1.30 to 1.33. - -=item * - -L has been upgraded from version 0.020 to 0.024. - -=item * - -L has been upgraded from version 5.74 to 5.76. - -=item * - -L has been upgraded from version 0.280234 to 0.280236. - -=item * - -L has been upgraded from version 2.14 to 2.20. - -=item * - -L has been upgraded from version 7.44 to 7.62. - -=item * - -L has been upgraded from version 1.72 to 1.73. - -=item * - -L has been upgraded from version 1.09 to 1.10. - -=item * - -L has been upgraded from version 3.40 to 3.43. - -=item * - -L has been upgraded from version 3.38 to 3.43. - -=item * - -L has been upgraded from version 1.13 to 1.14. - -=item * - -L has been upgraded from version 1.58 to 1.64. - -Added the default enabled C feature. - -A new L -feature has been added, which is enabled by -default but allows turning off L. - -=item * - -L has been upgraded from version 2.34 to 2.35. - -=item * - -L has been upgraded from version 0.56 to 1.00. - -=item * - -L has been upgraded from version 1.37 to 1.39. - -=item * - -L has been upgraded from version 2.16 to 2.18. - -=item * - -L has been upgraded from version 3.78 to 3.80. - -=item * - -L has been upgraded from version 0.2309 to 0.2311. - -=item * - -L has been upgraded from version 1.59 to 1.60. - -=item * - -L has been upgraded from version 1.51 to 1.52. - -=item * - -L has been upgraded from version 1.18 to 1.19. - -New functions and compatibility for newer versions of GDBM. -[L] - -=item * - -L has been upgraded from version 2.51 to 2.52. - -=item * - -L has been upgraded from version 1.12 to 1.13. - -=item * - -L has been upgraded from version 0.23 to 0.25. - -=item * - -L has been upgraded from version 1.20 to 1.21. - -=item * - -L has been upgraded from version 0.44 to 0.45. - -=item * - -L has been upgraded from version 0.0608 to 0.0609. - -=item * - -L has been upgraded from version 1.43 to 1.46. - -IO::Socket now stores error messages in C<$IO::Socket::errstr>, in -addition to in C<$@>. - -The C method now reports the error state for both the input and -output streams for sockets and character devices. Similarly -C now clears the error state for both streams. - -A spurious error reported for regular file handles has been -fixed in L. -[L] - -=item * - -IO-Compress has been upgraded from version 2.093 to 2.102. - -bin/zipdetails version 2.02 - -=item * - -L has been upgraded from version 0.39 to 0.41. - -=item * - -L has been upgraded from version 1.10 to 1.11. - -=item * - -L has been upgraded from version 2.07 to 2.09. - -=item * - -L has been upgraded from version 4.04 to 4.06. - -=item * - -The libnet distribution has been upgraded from version 3.11 to 3.13. - -=item * - -L has been upgraded from version 1.09 to 1.10. - -=item * - -L has been upgraded from version 1.5901 to 1.5902. - -=item * - -L has been upgraded from version 3.15 to 3.16. - -=item * - -L has been upgraded from version 5.20200620 to 5.20210520. - -=item * - -L has been upgraded from version 0.34 to 0.36. - -=item * - -L has been upgraded from version 0.70 to 0.74. - -=item * - -L has been upgraded from version 1.23 to 1.25_001. - -=item * - -L has been upgraded from version 2.72 to 2.74. - -=item * - -L has been upgraded from version 0.67_01 to 0.68. - -=item * - -L has been upgraded from version 1.16 to 1.17. - -=item * - -L has been upgraded from version 1.47 to 1.50. - -=item * - -L has been upgraded from version 1.31 to 1.33. - -=item * - -L has been upgraded from version 5.20200523 to 5.20210411. - -=item * - -L has been upgraded from version 0.28 to 0.30. - -=item * - -L has been upgraded from version 0.016 to 0.017. - -=item * - -L has been upgraded from version 0.30 to 0.31. - -=item * - -L has been upgraded from version 0.08 to 0.09. - -=item * - -L has been upgraded from version 1.73 to 1.74. - -=item * - -L has been upgraded from version 1.25 to 1.27. - -=item * - -L has been upgraded from version 3.40 to 3.42. - -=item * - -L has been upgraded from version 1.69 to 2.01. - -=item * - -L has been upgraded from version 1.94 to 1.97. - -POSIX::signbit() behaviour has been improved. -[L] - -Documentation for C clarifies that the result is always in English. -(Use C for a localized result.) - -=item * - -L has been upgraded from version 0.40 to 0.41. - -(See under L for more information.) - -=item * - -L has been upgraded from version 2.41 to 2.43. - -=item * - -L has been upgraded from version 2.029 to 2.031. - -=item * - -L has been upgraded from version 3.21 to 3.23. - -=item * - -L has been upgraded from version 1.11 to 1.12. - -=item * - -L has been upgraded from version 1.03 to 1.04. - -=item * - -L has been upgraded from version 1.08 to 1.09. - -=item * - -L has been upgraded from version 3.42 to 3.43. - -=item * - -L has been upgraded from version 1.302175 to 1.302183. - -=item * - -L has been upgraded from version 2.03 to 2.04. - -=item * - -L has been upgraded from version 2.25 to 2.26. - -=item * - -L has been upgraded from version 1.61 to 1.62. - -=item * - -L has been upgraded from version 1.39 to 1.40. - -=item * - -L has been upgraded from version 1.9764 to 1.9767. - -=item * - -L has been upgraded from version 1.28 to 1.30. - -=item * - -L has been upgraded from version 1.27 to 1.29. - -=item * - -L has been upgraded from version 1.27 to 1.28. - -=item * - -L has been upgraded from version 1.22 to 1.24. - -=item * - -L has been upgraded from version 0.9924 to 0.9928. - -=item * - -L has been upgraded from version 1.47 to 1.51. - -=item * - -L has been upgraded from version 0.53 to 0.57. - -Fix calling convention for C. - -Added C, -C, and C. - -Removed old code for versions before Windows 2000. - -=item * - -L has been upgraded from version 1.09 to 1.16. - -=item * - -L has been upgraded from version 0.17 to 0.18. - -=back - -=head1 Documentation - -=head2 New Documentation - -=head3 L - -This document is a guide for the authorship and maintenance of the -documentation that ships with Perl. - -=head3 L - -This document describes the goals, scope, system, and rules for Perl's new -governance model. - -Other pod files, most notably L, were amended to reflect -its adoption. - -=head2 Changes to Existing Documentation - -We have attempted to update the documentation to reflect the changes -listed in this document. If you find any we have missed, open an issue -at L. - -Additionally, the following selected changes have been made: - -=over 4 - -=item * - -L, L, L, and L now prefer C -over C. - -=item * - -References to B have been replaced with a more accurate term or -B where appropriate. - -=item * - -B is now the fallback contact for security issues. - -=back - -=head3 L - -=over 4 - -=item * - -Efforts continue in improving the presentation of this document, and to -document more API elements. - -=back - -=head3 L - -=over 4 - -=item * - -The freenode IRC URL has been updated. - -=back - -=head3 L - -=over 4 +perldelta - what is new for perl v5.35.0 -=item * +=head1 DESCRIPTION -Corrected the description of the scalar C<< ${"_<$filename"} >> -variables. +This document describes differences between the 5.34.0 release and the 5.35.0 +release. -=back +If you are upgrading from an earlier release such as 5.33.0, first read +L, which describes differences between 5.33.0 and 5.34.0. -=head3 L +=head1 Notice -=over 4 +XXX Any important notices here -=item * +=head1 Core Enhancements -Now documents additional examples of "not imported" warnings. +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 section. -=back +[ List each enhancement as a =head2 entry ] -=head3 L +=head1 Security -=over 4 +XXX Any security-related notices go here. In particular, any security +vulnerabilities closed should be noted here rather than in the +L section. -=item * +[ List each security issue as a =head2 entry ] -The Perl FAQ was updated to CPAN version 5.20201107 with minor -improvements. +=head1 Incompatible Changes -=back +XXX For a release on a stable branch, this section aspires to be: -=head3 L + 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 below. -=over 4 +[ List each incompatible change as a =head2 entry ] -=item * +=head1 Deprecations -L and L now explicitly warn -the reader that lexical variables should typically not be redeclared -within the same scope or statement. -[L] +XXX Any deprecated features, syntax, modules etc. should be listed here. -=item * +=head2 Module removals -The L entry has been improved and now -also states that the result of the function is always in English. +XXX Remove this section if not applicable. -=item * +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. -L documented a length field included in the -packed C parameter to C, but there was no such field. -C contains only the type and the message content. +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. -=item * +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. -Better explanation of what happens when C is called with a zero or -negative value. +=over -=item * +=item XXX -Simplify the C documentation by removing the Cs from the -examples -[L] +XXX Note that deprecated modules should be listed here even if they are listed +as an updated module in the L section. =back -=head3 L +[ List each other deprecation as a =head2 entry ] -=over 4 +=head1 Performance Enhancements -=item * +XXX Changes which enhance performance without changing behaviour go here. +There may well be none in a stable release. + +[ List each enhancement as an =item entry ] -document how to create a remote-tracking branch for every PR +=over 4 =item * -document how to get a PR as a local branch +XXX =back -=head3 L +=head1 Modules and Pragmata -=over 4 +XXX All changes to installed files in F, F, F and F +go here. If Module::CoreList is updated, generate an initial draft of the +following sections using F. A paragraph summary +for important changes should then be added by hand. In an ideal world, +dual-life modules would have a F file that could be cribbed. -=item * +The list of new and updated modules is modified automatically as part of +preparing a Perl release, so the only reason to manually add entries here is if +you're summarising the important changes in the module update. (Also, if the +manually-added details don't match the automatically-generated ones, the +release manager will have to investigate the situation carefully.) -L now explains in greater detail the need to consult C -when calling C (or variants). A new "How do I pass a Perl string to a C -library?" section in the same document discusses when to use which style of -macro to read an SV's string value. +[ Within each section, list entries as an =item entry ] -=item * +=head2 New Modules and Pragmata -Corrected C example in perlguts. +=over 4 =item * -A section has been added on the formatted printing of special sizes. +XXX Remove this section if not applicable. =back -=head3 L +=head2 Updated Modules and Pragmata =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 * +L has been upgraded from version A.xx to B.yy. -Document range op behavior change. +If there was something important to note about this change, include that here. =back -=head3 L +=head2 Removed Modules and Pragmata =over 4 =item * -Incorrect variables used in an example have been fixed. +XXX =back -=head3 L +=head1 Documentation -=over 4 +XXX Changes to files in F go here. Consider grouping entries by +file and be sure to link to the appropriate page, e.g. L. -=item * +=head2 New Documentation -Document that caller() does not see try{} blocks +XXX Changes which create B files in F go here. -=item * +=head3 L -A new example shows how a lexical C variable can be declared -during the initialization of a C loop. +XXX Description of the purpose of the new file here -=back +=head2 Changes to Existing Documentation + +We have attempted to update the documentation to reflect the changes +listed in this document. If you find any we have missed, open an issue +at L. + +XXX Changes which significantly change existing files in F go here. +However, any changes to F should go in the L +section. -=head3 L +Additionally, the following selected changes have been made: + +=head3 L =over 4 =item * -Fix description of what Perl does with unencoded strings +XXX Description of the change here =back @@ -757,25 +182,21 @@ 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. +XXX New or changed warnings emitted by the core's C code go here. Also +include any changes in L that reconcile it to the 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 - -This accompanies the new -L feature. - -=item * - -L - -This accompanies the new -L feature. +XXX L =back @@ -785,638 +206,204 @@ L feature. =item * -L - -Attempts to put wide characters into environment variable keys via C<%ENV> now -provoke this warning. +XXX L =back =head2 Changes to Existing Diagnostics -=over 4 - -=item * - -L - -An error was encountered in handling a user-defined property -(L). These are -programmer written subroutines, hence subject to errors that may -prevent them from compiling or running. - -=item * - -L - -A user-defined property (L) -can depend on the definitions of other user-defined -properties. If the chain of dependencies leads back to this property, -infinite recursion would occur, were it not for the check that raised -this error. - -=item * - -L - -The first time a user-defined property -(L) is used, its -definition is looked up and converted into an internal form for more -efficient handling in subsequent uses. There could be a race if two or -more threads tried to do this processing nearly simultaneously. - -=item * - -L - -You specified to use a property within the C<\p{...}> which was a -syntactically valid user-defined property, but no definition was found -for it - -=item * - -L - -Subroutine argument-count mismatch errors now include the number of -given and expected arguments. - -=item * - -L - -Subroutine argument-count mismatch errors now include the number of -given and expected arguments. - -=item * - -L - -This warning was only issued for positive too-large values when -incrementing, and only for negative ones when decrementing. -It is now issued for both positive or negative too-large values. -[L] - -=item * - -L<\K not permitted in lookahead/lookbehind in regex; marked by <-- HERE in mE%sE|perldiag/"\K not permitted in lookahead/lookbehind in regex; marked by <-- HERE in m/%s/"> +XXX Changes (i.e. rewording) of diagnostic messages go here -This error was incorrectly produced in some cases involving nested -lookarounds. This has been fixed. -[L] +=over 4 =item * -L - -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 =head1 Utility Changes -=head2 L (the debugger) +XXX Changes to installed programs such as F and F go here. +Most of these are built within the directory F. -=over 4 - -=item * New option: C - -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 and C commands +[ List utility changes as a =head2 entry for each utility and =item +entries for each change +Use L with program names to get proper documentation linking. ] -The C and C commands work again with lexical variables. - -=back - -=head1 Configuration and Compilation +=head2 L =over 4 =item * -Prevented incpath to spill into libpth +XXX -=item * - -Use realpath if available. (This might catch more duplicate paths.) - -=item * - -Only include real existing paths. - -=item * - -Filter inc paths out of libpth. - -=item * stadtx hash support has been removed - -stadtx support has been entirely removed. Previously, it could be requested -with C, and was default in 64-bit builds. It has been -replaced with SipHash. SipHash has been more rigorously reviewed than stadtx. - -=item * Configure - -A new probe checks for buggy libc implementations of the C/C -functions. -[L] - -=item * C<-Dusedefaultstrict> - -Perl can now be built with L on by default (using the configuration -option C<-Dusedefaultstrict>. +=back -These strict defaults do not apply when C is run via C<-e> or C<-E>. +=head1 Configuration and Compilation -This setting provides a diagnostic mechanism intended for development -purposes only and is thus undefined by default. +XXX Changes to F, F, F, 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 section, instead. -=item * +[ List changes as an =item entry ]. -The minimum supported Bison version is now 2.4, and the maximum is 3.7. +=over 4 =item * -Newer 64-bit versions of the Intel C/C++ compiler are now recognised -and have the correct flags set. +XXX -=item * +=back -We now trap SIGBUS when F checks for C. +=head1 Testing -On several systems the attempt to determine if we need C or similar -results in a SIGBUS instead of the expected SIGSEGV, which previously caused a -core dump. +XXX Any significant changes to the testing of a freshly built perl should be +listed here. Changes which create B files in F go here as do any +large changes to the testing harness (e.g. when parallel testing was added). +Changes to existing files in F aren't worth summarizing, although the bugs +that they represent may be covered elsewhere. -[L] +XXX If there were no significant test changes, say this: -=back +Tests were added and changed to reflect the other additions and changes +in this release. -=head1 Testing +XXX If instead there were significant changes, say this: Tests were added and changed to reflect the other additions and changes in this release. Furthermore, these significant changes were made: -=over 4 - -=item * - -Split Config-dependent tests in F to F - -=item * - -F was added, providing a test harness for regexp optimization. -[L] - -=item * +[ List each test improvement as an =item entry ] -A workaround for CPAN distributions needing dot in C<@INC> has been removed -[L]. -All distributions that previously required the workaround have now been -adapted. +=over 4 =item * -When testing in parallel on many-core platforms, you can now cause the -test suite to finish somewhat earlier, but with less logical ordering of -the tests, by setting - - PERL_TEST_HARNESS_ASAP=1 - -while running the test suite. +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 (a 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 +directories, or new subdirectories and F files at the top level of the +source tree. =over 4 -=item Plan9 - -Improve support for Plan9 on i386 platforms. +=item XXX-some-platform -=item MacOS (Darwin) - -The hints file for darwin has been updated to handle future MacOS versions -beyond 10. [L] +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 =head2 Platform-Specific Notes -=over 4 - -=item DragonFlyBSD - -Tests were updated to workaround DragonFlyBSD bugs in L and L. - -=item Mac OS X - -A number of system libraries no longer exist as actual files on Big Sur, -even though C will pretend they do, so now we fall back to C -if a library file can not be found. -[L] - -=item Windows - -Reading non-ASCII characters from the console when its codepage was set to -65001 (UTF-8) was broken due to a bug in Windows. A workaround for this -problem has been implemented. -[L] - -Building with mingw.org compilers (version 3.4.5 or later) using mingw runtime -versions < 3.22 now works again. This was broken in Perl 5.31.4. - -Building with mingw.org compilers (version 3.4.5 or later) using mingw runtime -versions >= 3.21 now works (for compilers up to version 5.3.0). - -F, and thus support for dmake, has been removed. It is still -possible to build Perl on Windows using nmake (Makefile) and GNU make -(GNUmakefile). -[L] - -perl can now be built with C on MS Windows using -(32-bit and 64-bit) mingw-w64 ports of gcc. -[L] - -The F utility now needs to C. This could -cause failures in parallel builds. - -Windows now supports L and -L, and L is no -longer an alias for L. -[L]. - -Unlike POSIX systems, creating a symbolic link on Windows requires -either elevated privileges or Windows 10 1703 or later with Developer -Mode enabled. - -stat(), including C, and lstat() now uses our own -implementation that populates the device C and inode numbers -C returned rather than always returning zero. The number of -links C field is now always populated. - -L<< C<${^WIN32_SLOPPY_STAT}> |perlvar/${^WIN32_SLOPPY_STAT} >> previously -controlled whether the C field was populated requiring a -separate Windows API call to fetch, since C and the other -information required for C is now retrieved in a single API call. - -The C<-r> and C<-w> operators now return true for the C, -C and C handles. Unfortunately it still won't return -true for duplicates of those handles. -[L]. - -The times returned by stat() and lstat() are no longer incorrect -across Daylight Savings Time adjustments. -[L]. - -C<-x> on a filehandle should now match C<-x> on the corresponding -filename on Vista or later. -[L]. - -C<-e '"'> no longer incorrectly returns true. -[L]. +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 section. -The same manifest is now used for Visual C++ and gcc builds. - -Previously, MSVC builds were using the B flag instead of -embedding F, which caused issues such as C -returning the wrong version number on Windows 10. +=over 4 -=item z/OS +=item XXX-some-platform -The locale categories C and C are now recognized. -Perl doesn't do anything with these, except it now allows you to specify -them. They are included in C. +XXX =back =head1 Internal Changes -=over 4 - -=item * - -Corrected handling of double and long double parameters for perl's -implementation of formatted output for C<-Dusequadmath> builds. - -This applies to C, C, C, C and -their variants. - -Previously in C builds, code like: - - PerlIO_printf(PerlIO_stderr(), "%g", somedouble); - -or - - PerlIO_printf(PerlIO_stderr(), "%Lg", somelongdouble); - -would erroneously throw an exception "panic: quadmath invalid format -...", since the code added for quadmath builds assumed Cs were the -only floating point format passed into these functions. - -This code would also process the standard C long double specifier C -as if it expected an C (C<__float128> for quadmath builds), -resulting in undefined behaviour. - -These functions now correctly accept doubles, long doubles and NVs. - -=item * - -Previously the right operand of bitwise shift operators (shift amount) -was implicitly cast from IV to int, but it might lead wrong results -if IV does not fit in int. - -And also, shifting INT_MIN bits used to yield the shiftee unchanged -(treated as 0-bit shift instead of negative shift). - -=item * - -A set of C functions was added, -to support checking for the existence of keys in the hints hash of a -specific cop without needing to create a mortal copy of said value. - -=item * - -An aid has been added for using the C macros when debugging XS or -C code. The comments in F describe C and -C. which you can C<#define> to do things like save and -restore C, in case the C calls are interfering with that, -or to display timestamps, or which thread it's coming from, or the -location of the call, or whatever. You can make a quick hack to help -you track something down without having to edit individual C -calls. - -=item * - -Make C available outside of core - -=item * - -All C-ish functions now evaluate their arguments exactly once. -In 5.32, plain L> was changed to do that; now the rest -do as well. - -=item * - -Unicode is now a first class citizen when considering the pattern /A*B/ where -A and B are arbitrary. The pattern matching code tries to make a tight loop -to match the span of A's. The logic of this was now really updated with -support for UTF-8. - -=item * - -The L module has a new function C, which can return a -hashref of optimization data discovered about a compiled regexp. +XXX Changes which affect the interface available to C code go here. Other +significant internal changes for future core maintainers should be noted as +well. -=item * - -The C compilation option has been removed, and -with it the need or the C macro. C remains defined as a -no-op outside C for backwards compatiblity with XS modules. - -=item * +[ List each change as an =item entry ] -A new savestack type C has been added, which neatens the -previous behaviour of C. On previous versions the types and -values pushed to the save stack would depend on whether the hints included the -C 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 has been added which gives a -clearly named way to find how many elements are in an array. +XXX =back =head1 Selected Bug Fixes -=over 4 - -=item * - -Setting C<%ENV> now properly handles upgraded strings in the key. Previously -Perl sent the SV's internal PV directly to the OS; now it will handle keys -as it has handled values since 5.18: attempt to downgrade the string first; -if that fails then warn and use the utf8 form. - -=item * - -Fix a memory leak in regcomp.c -[L] - -=item * pack/unpack format 'D' now works on all systems that could support it - -Previously if C, now it is supported on all platforms that -have long doubles. In particular that means it is now also supported on -quadmath platforms. - -=item * - -Skip trying to constant fold an incomplete op tree -[L] - -Constant folding of chained comparison op trees could fail under certain -conditions, causing perl to crash. As a quick fix, constant folding is -now skipped for such op trees. This also addresses -[L]. - -=item * - -C<%g> formatting broken on Ubuntu-18.04, C -[L] - -Buggy libc implementations of the C and C functions -caused C<(s)printf> to incorrectly truncate C<%g> formatted numbers. -A new Configure probe now checks for this, with the result that the libc -C will be used in place of C and C. - -Tests added as part of this fix also revealed related problems in -some Windows builds. The makefiles for MINGW builds on Windows have -thus been adjusted to use C by default, ensuring -that they also provide correct C<(s)printf> formatting of numbers. - -=item * - -F: croak on C when C is in effect -[L] - -The lexical topic feature experiment was removed in Perl v5.24 and -declaring C became a compile time error. However, it was previously -still possible to make this declaration if C was in effect. - -=item * - -F: Fix assertion failure -[L] - -Fuzzing triggered an assertion failure in the regexp engine when too many -characters were copied into a buffer. - -=item * - -L, L, and -L now properly reset the UTF-8 flag on the -C parameter if it's modified for C or C -operations. - -=item * +XXX Important bug fixes in the core language are summarized here. Bug fixes in +files in F and F are best summarized in L. -C, C, and C now attempt to downgrade the C -parameter if its value is being used as input to C or -C calls. A failed downgrade will thrown an exception. +[ List each fix as an =item entry ] -=item * - -In cases where C, C or C would treat the C -parameter as a pointer, an undefined value no longer generates a -warning. In most such calls the pointer isn't used anyway and this -allows you to supply C for a value not used by the underlying -function. +=over 4 =item * -L now downgrades the C parameter, -L now downgrades the C parameter and -L now downgrades the C parameter -to treat them as bytes. Previously they would be left upgraded, -providing a corrupted structure to the underlying function call. - -=item * +XXX -L now properly resets the UTF-8 flag the -C parameter when it is modified. Previously the UTF-8 flag could -be left on, resulting in a possibly corrupt result in C. +=back -=item * +=head1 Known Problems -Magic is now called correctly for stacked file test operators. -[L] +XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any +tests that had to be Ced for the release would be noted here. Unfixed +platform specific bugs also go here. -=item * +[ List each fix as an =item entry ] -The C<@ary = split(...)> optimization no longer switches in the target -array as the value stack. -[L] -Also see discussion at -L. +=over 4 =item * -Fixed a bug in which some regexps with recursive subpatterns matched -incorrectly. - -[L] - -=item * +XXX -On Win32, C could sometimes have a very large -timeout. [L] +=back -=item * +=head1 Errata From Previous Releases -C and hence C are now correctly initialized in C XSUBs. +=over 4 =item * -Some list assignments involving C on the left-hand side were -over-optimized and produced incorrect results. -[L], -[L] +XXX Add anything here that we forgot to add, or were mistaken about, in +the perldelta of a previous release. =back -=head1 Known Problems - -None - -=head1 Errata From Previous Releases - -None - =head1 Obituary -Kent Fredric (KENTNL) passed away in February 2021. A native of New Zealand -and a self-described "huge geek," Kent was the author or maintainer of 178 -CPAN distributions, the Perl maintainer for the Gentoo Linux distribution and -a contributor to the Perl core distribution. He is mourned by his family, -friends and open source software communities worldwide. +XXX If any significant core contributor or member of the CPAN community has +died, add a short obituary here. =head1 Acknowledgements -Perl 5.34.0 represents approximately 11 months of development since Perl -5.32.0 and contains approximately 280,000 lines of changes across 2,100 -files from 78 authors. - -Excluding auto-generated files, documentation and release tools, there were -approximately 150,000 lines of changes to 1,300 .pm, .t, .c and .h files. - -Perl continues to flourish into its fourth decade thanks to a vibrant -community of users and developers. The following people are known to have -contributed the improvements that became Perl 5.34.0: - -Aaron Crane, Adam Hartley, Andy Dougherty, Ben Cornett, Branislav -Zahradník, brian d foy, Chris 'BinGOs' Williams, Christian Walde -(Mithaldu), Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Book, Daniel -Böhmer, Daniel Laügt, Dan Kogai, David Cantrell, David Mitchell, Dominic -Hamon, E. Choroba, Ed J, Eric Herman, Eric Lindblad, Eugene Alvin Villar, -Felipe Gasper, Giovanni Tataranni, Graham Knop, Graham Ollis, Hauke D, -H.Merijn Brand, Hugo van der Sanden, Ichinose Shogo, Ivan Baidakou, Jae -Bradley, James E Keenan, Jason McIntosh, jkahrman, John Karr, John Lightsey, -Kang-min Liu, Karen Etheridge, Karl Williamson, Keith Thompson, Leon -Timmermans, Marc Reisner, Marcus Holland-Moritz, Max Maischein, Michael G -Schwern, Nicholas Clark, Nicolas R., Paul Evans, Petr Písař, raiph, Renee -Baecker, Ricardo Signes, Richard Leach, Romano, Ryan Voots, Samanta Navarro, -Samuel Thibault, Sawyer X, Scott Baker, Sergey Poznyakoff, Sevan Janiyan, -Shirakata Kentaro, Shlomi Fish, Sisyphus, Sizhe Zhao, Steve Hay, TAKAI -Kousuke, Thibault Duponchelle, Todd Rinaldo, Tomasz Konojacki, Tom Hukins, -Tom Stellard, Tony Cook, vividsnow, Yves Orton, Zakariyya Mughal, -Михаил Козачков. - -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. - -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. - -For a more complete list of all of Perl's historical contributors, please -see the F file in the Perl source distribution. +XXX Generate this with: + + perl Porting/acknowledgements.pl v5.35.0..HEAD =head1 Reporting Bugs diff --git a/vms/descrip_mms.template b/vms/descrip_mms.template index b0f38653f0..cca3fc4ce7 100644 --- a/vms/descrip_mms.template +++ b/vms/descrip_mms.template @@ -313,7 +313,7 @@ utils : $(utils1) $(utils2) $(utils3) $(utils4) $(utils5) extra.pods : miniperl @ @extra_pods.com -PERLDELTA_CURRENT = [.pod]perl5340delta.pod +PERLDELTA_CURRENT = [.pod]perl5350delta.pod $(PERLDELTA_CURRENT) : [.pod]perldelta.pod Copy/NoConfirm/Log $(MMS$SOURCE) $(PERLDELTA_CURRENT) diff --git a/win32/GNUmakefile b/win32/GNUmakefile index 6b053d1c04..3325514023 100644 --- a/win32/GNUmakefile +++ b/win32/GNUmakefile @@ -1781,7 +1781,7 @@ utils: $(HAVEMINIPERL) ..\utils\Makefile copy ..\README.tw ..\pod\perltw.pod copy ..\README.vos ..\pod\perlvos.pod copy ..\README.win32 ..\pod\perlwin32.pod - copy ..\pod\perldelta.pod ..\pod\perl5340delta.pod + copy ..\pod\perldelta.pod ..\pod\perl5350delta.pod $(MINIPERL) -I..\lib $(PL2BAT) $(UTILS) $(MINIPERL) -I..\lib ..\autodoc.pl .. $(MINIPERL) -I..\lib ..\pod\perlmodlib.PL -q .. @@ -1879,7 +1879,7 @@ distclean: realclean -if exist $(LIBDIR)\Win32API rmdir /s /q $(LIBDIR)\Win32API -if exist $(LIBDIR)\XS rmdir /s /q $(LIBDIR)\XS -cd $(PODDIR) && del /f *.html *.bat roffitall \ - perl5340delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ + perl5350delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ perlapi.pod perlbs2000.pod perlcn.pod perlcygwin.pod \ perldos.pod perlfreebsd.pod perlhaiku.pod perlhpux.pod \ perlhurd.pod perlintern.pod perlirix.pod perljp.pod perlko.pod \ diff --git a/win32/Makefile b/win32/Makefile index 682508fcb6..a407a8974b 100644 --- a/win32/Makefile +++ b/win32/Makefile @@ -1240,7 +1240,7 @@ utils: $(PERLEXE) ..\utils\Makefile copy ..\README.tw ..\pod\perltw.pod copy ..\README.vos ..\pod\perlvos.pod copy ..\README.win32 ..\pod\perlwin32.pod - copy ..\pod\perldelta.pod ..\pod\perl5340delta.pod + copy ..\pod\perldelta.pod ..\pod\perl5350delta.pod cd ..\win32 $(PERLEXE) $(PL2BAT) $(UTILS) $(MINIPERL) -I..\lib ..\autodoc.pl .. @@ -1339,7 +1339,7 @@ distclean: realclean -if exist $(LIBDIR)\Win32API rmdir /s /q $(LIBDIR)\Win32API -if exist $(LIBDIR)\XS rmdir /s /q $(LIBDIR)\XS -cd $(PODDIR) && del /f *.html *.bat roffitall \ - perl5340delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ + perl5350delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ perlapi.pod perlbs2000.pod perlcn.pod perlcygwin.pod \ perldos.pod perlfreebsd.pod perlhaiku.pod perlhpux.pod \ perlhurd.pod perlintern.pod perlirix.pod perljp.pod perlko.pod \ diff --git a/win32/pod.mak b/win32/pod.mak index 552f717a70..896b16bb2a 100644 --- a/win32/pod.mak +++ b/win32/pod.mak @@ -65,6 +65,7 @@ POD = perl.pod \ perl5320delta.pod \ perl5321delta.pod \ perl5340delta.pod \ + perl5350delta.pod \ perl561delta.pod \ perl56delta.pod \ perl581delta.pod \ @@ -228,6 +229,7 @@ MAN = perl.man \ perl5320delta.man \ perl5321delta.man \ perl5340delta.man \ + perl5350delta.man \ perl561delta.man \ perl56delta.man \ perl581delta.man \ @@ -391,6 +393,7 @@ HTML = perl.html \ perl5320delta.html \ perl5321delta.html \ perl5340delta.html \ + perl5350delta.html \ perl561delta.html \ perl56delta.html \ perl581delta.html \ @@ -554,6 +557,7 @@ TEX = perl.tex \ perl5320delta.tex \ perl5321delta.tex \ perl5340delta.tex \ + perl5350delta.tex \ perl561delta.tex \ perl56delta.tex \ perl581delta.tex \ -- cgit v1.2.1