diff options
author | Sawyer X <xsawyerx@cpan.org> | 2019-05-22 12:47:10 +0300 |
---|---|---|
committer | Sawyer X <xsawyerx@cpan.org> | 2019-05-22 12:47:10 +0300 |
commit | 862f380bc5b5f4d60cf02a41857717473b1a12fd (patch) | |
tree | 72dda4f7e77ca0763ed61aef87c10830bf90bd4e | |
parent | 3919712bdd12a65916294cbd37066d2d01ef8d0c (diff) | |
download | perl-862f380bc5b5f4d60cf02a41857717473b1a12fd.tar.gz |
New perldelta
-rw-r--r-- | MANIFEST | 1 | ||||
-rwxr-xr-x | Makefile.SH | 8 | ||||
-rw-r--r-- | pod/.gitignore | 2 | ||||
-rw-r--r-- | pod/perl5300delta.pod | 1435 | ||||
-rw-r--r-- | pod/perldelta.pod | 1341 | ||||
-rw-r--r-- | vms/descrip_mms.template | 2 | ||||
-rw-r--r-- | win32/GNUmakefile | 4 | ||||
-rw-r--r-- | win32/Makefile | 4 | ||||
-rw-r--r-- | win32/makefile.mk | 4 | ||||
-rw-r--r-- | win32/pod.mak | 4 |
10 files changed, 1627 insertions, 1178 deletions
@@ -5029,6 +5029,7 @@ pod/perl5263delta.pod Perl changes in version 5.26.3 pod/perl5280delta.pod Perl changes in version 5.28.0 pod/perl5281delta.pod Perl changes in version 5.28.1 pod/perl5282delta.pod Perl changes in version 5.28.2 +pod/perl5300delta.pod Perl changes in version 5.30.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 5777970638..b8491f87f1 100755 --- a/Makefile.SH +++ b/Makefile.SH @@ -586,7 +586,7 @@ esac $spitshell >>$Makefile <<'!NO!SUBS!' -perltoc_pod_prereqs = extra.pods pod/perl5300delta.pod pod/perlapi.pod pod/perlintern.pod pod/perlmodlib.pod pod/perluniprops.pod +perltoc_pod_prereqs = extra.pods pod/perl5301delta.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 @@ -1150,9 +1150,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/perl5300delta.pod: pod/perldelta.pod - $(RMS) pod/perl5300delta.pod - $(LNS) perldelta.pod pod/perl5300delta.pod +pod/perl5301delta.pod: pod/perldelta.pod + $(RMS) pod/perl5301delta.pod + $(LNS) perldelta.pod pod/perl5301delta.pod extra.pods: $(MINIPERL_EXE) -@test ! -f extra.pods || rm -f `cat extra.pods` diff --git a/pod/.gitignore b/pod/.gitignore index 44829b1064..879f9b3adb 100644 --- a/pod/.gitignore +++ b/pod/.gitignore @@ -50,7 +50,7 @@ /roffitall # generated -/perl5300delta.pod +/perl5301delta.pod /perlapi.pod /perlintern.pod /perlmodlib.pod diff --git a/pod/perl5300delta.pod b/pod/perl5300delta.pod new file mode 100644 index 0000000000..0804fe3728 --- /dev/null +++ b/pod/perl5300delta.pod @@ -0,0 +1,1435 @@ +=encoding utf8 + +=head1 NAME + +perl5300delta - what is new for perl v5.30.0 + +=head1 DESCRIPTION + +This document describes differences between the 5.28.0 release and the 5.30.0 +release. + +If you are upgrading from an earlier release such as 5.26.0, first read +L<perl5280delta>, which describes differences between 5.26.0 and 5.28.0. + +=head1 Notice + +sv_utf8_(downgrade|decode) are no longer marked as experimental. +L<[perl #133788]|https://rt.perl.org/Ticket/Display.html?id=133788>. + +=head1 Core Enhancements + +=head2 Limited variable length lookbehind in regular expression pattern matching is now experimentally supported + +Using a lookbehind assertion (like C<(?<=foo?)> or C<(?<!ba{1,9}r)> previously +would generate an error and refuse to compile. Now it compiles (if the +maximum lookbehind is at most 255 characters), but raises a warning in +the new C<experimental::vlb> warnings category. This is to caution you +that the precise behavior is subject to change based on feedback from +use in the field. + +See L<perlre/(?<=pattern)> and L<perlre/(?<!pattern)>. + +=head2 The upper limit C<"n"> specifiable in a regular expression quantifier of the form C<"{m,n}"> has been doubled to 65534 + +The meaning of an unbounded upper quantifier C<"{m,}"> remains unchanged. +It matches 2**31 - 1 times on most platforms, and more on ones where a C +language short variable is more than 4 bytes long. + +=head2 Unicode 12.1 is supported + +Because of a change in Unicode release cycles, Perl jumps from Unicode +10.0 in Perl 5.28 to Unicode 12.1 in Perl 5.30. + +For details on the Unicode changes, see +L<https://www.unicode.org/versions/Unicode11.0.0/> for 11.0; +L<https://www.unicode.org/versions/Unicode12.0.0/> for 12.0; +and +L<https://www.unicode.org/versions/Unicode12.1.0/> for 12.1. +(Unicode 12.1 differs from 12.0 only in the addition of a single +character, that for the new Japanese era name.) + +The Word_Break property, as in past Perl releases, remains tailored to +behave more in line with expectations of Perl users. This means that +sequential runs of horizontal white space characters are not broken +apart, but kept as a single run. Unicode 11 changed from past versions +to be more in line with Perl, but it left several white space characters +as causing breaks: TAB, NO BREAK SPACE, and FIGURE SPACE (U+2007). We +have decided to continue to use the previous Perl tailoring with regards +to these. + +=head2 Wildcards in Unicode property value specifications are now partially supported + +You can now do something like this in a regular expression pattern + + qr! \p{nv= /(?x) \A [0-5] \z / }! + +which matches all Unicode code points whose numeric value is +between 0 and 5 inclusive. So, it could match the Thai or Bengali +digits whose numeric values are 0, 1, 2, 3, 4, or 5. + +This marks another step in implementing the regular expression features +the Unicode Consortium suggests. + +Most properties are supported, with the remainder planned for 5.32. +Details are in L<perlunicode/Wildcards in Property Values>. + +=head2 qr'\N{name}' is now supported + +Previously it was an error to evaluate a named character C<\N{...}> +within a single quoted regular expression pattern (whose evaluation is +deferred from the normal place). This restriction is now removed. + +=head2 Turkic UTF-8 locales are now seamlessly supported + +Turkic languages have different casing rules than other languages for +the characters C<"i"> and C<"I">. The uppercase of C<"i"> is LATIN +CAPITAL LETTER I WITH DOT ABOVE (U+0130); and the lowercase of C<"I"> is LATIN +SMALL LETTER DOTLESS I (U+0131). Unicode furnishes alternate casing +rules for use with Turkic languages. Previously, Perl ignored these, +but now, it uses them when it detects that it is operating under a +Turkic UTF-8 locale. + +=head2 It is now possible to compile perl to always use thread-safe locale operations. + +Previously, these calls were only used when the perl was compiled to be +multi-threaded. To always enable them, add + + -Accflags='-DUSE_THREAD_SAFE_LOCALE' + +to your F<Configure> flags. + +=head2 Eliminate opASSIGN macro usage from core + +This macro is still defined but no longer used in core + +=head2 C<-Drv> now means something on C<-DDEBUGGING> builds + +Now, adding the verbose flag (C<-Dv>) to the C<-Dr> flag turns on all +possible regular expression debugging. + +=head1 Incompatible Changes + +=head2 Assigning non-zero to C<$[> is fatal + +Setting L<< C<$[>|perlvar/$[ >> to a non-zero value has been deprecated since +Perl 5.12 and now throws a fatal error. +See L<<< perldeprecation/Assigning non-zero to C<< $[ >> is fatal >>>. + +=head2 Delimiters must now be graphemes + +See L<perldeprecation/Use of unassigned code point or non-standalone grapheme +for a delimiter.> + +=head2 Some formerly deprecated uses of an unescaped left brace C<"{"> in +regular expression patterns are now illegal + +But to avoid breaking code unnecessarily, most instances that issued a +deprecation warning, remain legal and now have a non-deprecation warning +raised. See L<perldeprecation/Unescaped left braces in regular expressions>. + +=head2 Previously deprecated sysread()/syswrite() on :utf8 handles is now fatal + +Calling sysread(), syswrite(), send() or recv() on a C<:utf8> handle, +whether applied explicitly or implicitly, is now fatal. This was +deprecated in perl 5.24. + +There were two problems with calling these functions on C<:utf8> +handles: + +=over + +=item * + +All four functions only paid attention to the C<:utf8> flag. Other +layers were completely ignored, so a handle with +C<:encoding(UTF-16LE)> layer would be treated as UTF-8. Other layers, +such as compression are completely ignored with or without the +C<:utf8> flag. + +=item * + +sysread() and recv() would read from the handle, skipping any +validation by the layers, and do no validation of their own. This +could lead to invalidly encoded perl scalars. + +=back + +L<[perl #125760]|https://rt.perl.org/Ticket/Display.html?id=125760>. + +=head2 my() in false conditional prohibited + +Declarations such as C<my $x if 0> are no longer permitted. + +L<[perl #133543]|https://rt.perl.org/Ticket/Display.html?id=133543>. + +=head2 Fatalize $* and $# + +These special variables, long deprecated, now throw exceptions when used. + +L<[perl #133583]|https://rt.perl.org/Ticket/Display.html?id=133583>. + +=head2 Fatalize unqualified use of dump() + +The C<dump()> function, long discouraged, may no longer be used unless it is +fully qualified, I<i.e.>, C<CORE::dump()>. + +L<[perl #133584]|https://rt.perl.org/Ticket/Display.html?id=133584>. + +=head2 Remove File::Glob::glob() + +The C<File::Glob::glob()> function, long deprecated, has been removed and now +throws an exception which advises use of C<File::Glob::bsd_glob()> instead. + +L<[perl #133586]|https://rt.perl.org/Ticket/Display.html?id=133586>. + +=head2 C<pack()> no longer can return malformed UTF-8 + +It croaks if it would otherwise return a UTF-8 string that contains +malformed UTF-8. This protects against potential security threats. This +is considered a bug fix as well. +L<[perl #131642]|https://rt.perl.org/Ticket/Display.html?id=131642>. + +=head2 Any set of digits in the Common script are legal in a script run of another script + +There are several sets of digits in the Common script. C<[0-9]> is the +most familiar. But there are also C<[\x{FF10}-\x{FF19}]> (FULLWIDTH +DIGIT ZERO - FULLWIDTH DIGIT NINE), and several sets for use in +mathematical notation, such as the MATHEMATICAL DOUBLE-STRUCK DIGITs. +Any of these sets should be able to appear in script runs of, say, +Greek. But the design of 5.30 overlooked all but the ASCII digits +C<[0-9]>, so the design was flawed. This has been fixed, so is both a +bug fix and an incompatibility. +L<[perl #133547]|https://rt.perl.org/Ticket/Display.html?id=133547>. + +All digits in a run still have to come from the same set of ten digits. + +=head2 JSON::PP enables allow_nonref by default + +As JSON::XS 4.0 changed its policy and enabled allow_nonref +by default, JSON::PP also enabled allow_nonref by default. + +=head1 Deprecations + +=head2 In XS code, use of various macros dealing with UTF-8. + +This deprecation was scheduled to become fatal in 5.30, but has been +delayed to 5.32 due to problems that showed up with some CPAN modules. +For details of what's affected, see L<perldeprecation| +perldeprecation/In XS code, use of various macros dealing with UTF-8.>. + +=head1 Performance Enhancements + +=over 4 + +=item * + +Translating from UTF-8 into the code point it represents now is done via a +deterministic finite automaton, speeding it up. As a typical example, +C<ord("\x7fff")> now requires 12% fewer instructions than before. The +performance of checking that a sequence of bytes is valid UTF-8 is similarly +improved, again by using a DFA. + +=item * + +Eliminate recursion from finalize_op(). +L<[perl #108276]|https://rt.perl.org/Ticket/Display.html?id=108276>. + +=item * + +A handful of small optimizations related to character folding +and character classes in regular expressions. + +=item * + +Optimization of C<IV> to C<UV> conversions. +L<[perl #133677]|https://rt.perl.org/Ticket/Display.html?id=133677>. + +=item * + +Speed up of the integer stringification algorithm by processing +two digits at a time instead of one. +L<[perl #133691]|https://rt.perl.org/Ticket/Display.html?id=133691>. + +=item * + +Improvements based on LGTM analysis and recommendation. +(L<https://lgtm.com/projects/g/Perl/perl5/alerts/?mode=tree>). +L<[perl #133686]|https://rt.perl.org/Ticket/Display.html?id=133686>. +L<[perl #133699]|https://rt.perl.org/Ticket/Display.html?id=133699>. + +=item * + +Code optimizations in F<regcomp.c>, F<regcomp.h>, F<regexec.c>. + +=item * + +Regular expression pattern matching of things like C<qr/[^I<a>]/> is +significantly sped up, where I<a> is any ASCII character. Other classes +can get this speed up, but which ones is complicated and depends on the +underlying bit patterns of those characters, so differs between ASCII +and EBCDIC platforms, but all case pairs, like C<qr/[Gg]/> are included, +as is C<[^01]>. + +=back + +=head1 Modules and Pragmata + +=head2 Updated Modules and Pragmata + +=over 4 + +=item * + +L<Archive::Tar> has been upgraded from version 2.30 to 2.32. + +=item * + +L<B> has been upgraded from version 1.74 to 1.76. + +=item * + +L<B::Concise> has been upgraded from version 1.003 to 1.004. + +=item * + +L<B::Deparse> has been upgraded from version 1.48 to 1.49. + +=item * + +L<bignum> has been upgraded from version 0.49 to 0.51. + +=item * + +L<bytes> has been upgraded from version 1.06 to 1.07. + +=item * + +L<Carp> has been upgraded from version 1.38 to 1.50 + +=item * + +L<Compress::Raw::Bzip2> has been upgraded from version 2.074 to 2.084. + +=item * + +L<Compress::Raw::Zlib> has been upgraded from version 2.076 to 2.084. + +=item * + +L<Config::Extensions> has been upgraded from version 0.02 to 0.03. + +=item * + +L<Config::Perl::V>. has been upgraded from version 0.29 to 0.32. This was due +to a new configuration variable that has influence on binary compatibility: +C<USE_THREAD_SAFE_LOCALE>. + +=item * + +L<CPAN> has been upgraded from version 2.20 to 2.22. + +=item * + +L<Data::Dumper> has been upgraded from version 2.170 to 2.174 + +L<Data::Dumper> now avoids leaking when C<croak>ing. + +=item * + +L<DB_File> has been upgraded from version 1.840 to 1.843. + +=item * + +L<deprecate> has been upgraded from version 0.03 to 0.04. + +=item * + +L<Devel::Peek> has been upgraded from version 1.27 to 1.28. + +=item * + +L<Devel::PPPort> has been upgraded from version 3.40 to 3.52. + +=item * + +L<Digest::SHA> has been upgraded from version 6.01 to 6.02. + +=item * + +L<Encode> has been upgraded from version 2.97 to 3.01. + +=item * + +L<Errno> has been upgraded from version 1.29 to 1.30. + +=item * + +L<experimental> has been upgraded from version 0.019 to 0.020. + +=item * + +L<ExtUtils::CBuilder> has been upgraded from version 0.280230 to 0.280231. + +=item * + +L<ExtUtils::Manifest> has been upgraded from version 1.70 to 1.72. + +=item * + +L<ExtUtils::Miniperl> has been upgraded from version 1.08 to 1.09. + +=item * + +L<ExtUtils::ParseXS> has been upgraded from version 3.39 to 3.40. +C<OUTLIST> parameters are no longer incorrectly included in the +automatically generated function prototype. +L<[perl #133654]|https://rt.perl.org/Ticket/Display.html?id=133654>. + +=item * + +L<feature> has been upgraded from version 1.52 to 1.54. + +=item * + +L<File::Copy> has been upgraded from version 2.33 to 2.34. + +=item * + +L<File::Find> has been upgraded from version 1.34 to 1.36. + +C<$File::Find::dont_use_nlink> now defaults to 1 on all +platforms. +L<[perl #133673]|https://rt.perl.org/Ticket/Display.html?id=133673>. + +Variables C<< $Is_Win32 >> and C<< $Is_VMS >> are being initialized. + +=item * + +L<File::Glob> has been upgraded from version 1.31 to 1.32. + +=item * + +L<File::Path> has been upgraded from version 2.15 to 2.16. + +=item * + +L<File::Spec> has been upgraded from version 3.74 to 3.78. + +Silence L<Cwd> warning on Android builds if C<targetsh> is not defined. + +=item * + +L<File::Temp> has been upgraded from version 0.2304 to 0.2309. + +=item * + +L<Filter::Util::Call> has been upgraded from version 1.58 to 1.59. + +=item * + +L<GDBM_File> has been upgraded from version 1.17 to 1.18. + +=item * + +L<HTTP::Tiny> has been upgraded from version 0.070 to 0.076. + +=item * + +L<I18N::Langinfo> has been upgraded from version 0.17 to 0.18. + +=item * + +L<IO> has been upgraded from version 1.39 to 1.40. + +=item * + +IO-Compress has been upgraded from version 2.074 to 2.084. + +Adds support for C<< IO::Uncompress::Zstd >> and +C<< IO::Uncompress::UnLzip >>. + +The C<< BinModeIn >> and C<< BinModeOut >> options are now no-ops. +ALL files will be read/written in binmode. + +=item * + +L<IPC::Cmd> has been upgraded from version 1.00 to 1.02. + +=item * + +L<JSON::PP> has been upgraded from version 2.97001 to 4.02. + +L<JSON::PP> as JSON::XS 4.0 enables C<allow_nonref> by default. + +=item * + +L<lib> has been upgraded from version 0.64 to 0.65. + +=item * + +L<Locale::Codes> has been upgraded from version 3.56 to 3.57. + +=item * + +L<Math::BigInt> has been upgraded from version 1.999811 to 1.999816. + +C<< bnok() >> now supports the full Kronenburg extension. +L<[cpan #95628]|https://rt.cpan.org/Ticket/Display.html?id=95628>. + +=item * + +L<Math::BigInt::FastCalc> has been upgraded from version 0.5006 to 0.5008. + +=item * + +L<Math::BigRat> has been upgraded from version 0.2613 to 0.2614. + +=item * + +L<Module::CoreList> has been upgraded from version 5.20180622 to 5.20190520. + +Changes to B::Op_private and Config + +=item * + +L<Module::Load> has been upgraded from version 0.32 to 0.34. + +=item * + +L<Module::Metadata> has been upgraded from version 1.000033 to 1.000036. + +Properly clean up temporary directories after testing. + +=item * + +L<NDBM_File> has been upgraded from version 1.14 to 1.15. + +=item * + +L<Net::Ping> has been upgraded from version 2.62 to 2.71. + +=item * + +L<ODBM_File> has been upgraded from version 1.15 to 1.16. + +=item * + +PathTools has been upgraded from version 3.74 to 3.78. + +=item * + +L<parent> has been upgraded from version 0.236 to 0.237. + +=item * + +L<perl5db.pl> has been upgraded from version 1.54 to 1.55. + +Debugging threaded code no longer deadlocks in C<DB::sub> nor +C<DB::lsub>. + +=item * + +L<perlfaq> has been upgraded from version 5.021011 to 5.20190126. + +=item * + +L<PerlIO::encoding> has been upgraded from version 0.26 to 0.27. + +Warnings enabled by setting the C<WARN_ON_ERR> flag in +C<$PerlIO::encoding::fallback> are now only produced if warnings are +enabled with C<use warnings "utf8";> or setting C<$^W>. + +=item * + +L<PerlIO::scalar> has been upgraded from version 0.29 to 0.30. + +=item * + +podlators has been upgraded from version 4.10 to 4.11. + +=item * + +L<POSIX> has been upgraded from version 1.84 to 1.88. + +=item * + +L<re> has been upgraded from version 0.36 to 0.37. + +=item * + +L<SDBM_File> has been upgraded from version 1.14 to 1.15. + +=item * + +L<sigtrap> has been upgraded from version 1.08 to 1.09. + +=item * + +L<Storable> has been upgraded from version 3.08 to 3.15. + +Storable no longer probes for recursion limits at build time. +L<[perl #133708]|https://rt.perl.org/Ticket/Display.html?id=133708> +and others. + +Metasploit exploit code was included to test for CVE-2015-1992 +detection, this caused anti-virus detections on at least one AV suite. +The exploit code has been removed and replaced with a simple +functional test. +L<[perl #133706]|https://rt.perl.org/Ticket/Display.html?id=133706> + +=item * + +L<Test::Simple> has been upgraded from version 1.302133 to 1.302162. + +=item * + +L<Thread::Queue> has been upgraded from version 3.12 to 3.13. + +=item * + +L<threads::shared> has been upgraded from version 1.58 to 1.60. + +Added support for extra tracing of locking, this requires a +C<-DDEBUGGING> and extra compilation flags. + +=item * + +L<Time::HiRes> has been upgraded from version 1.9759 to 1.9760. + +=item * + +L<Time::Local> has been upgraded from version 1.25 to 1.28. + +=item * + +L<Time::Piece> has been upgraded from version 1.3204 to 1.33. + +=item * + +L<Unicode::Collate> has been upgraded from version 1.25 to 1.27. + +=item * + +L<Unicode::UCD> has been upgraded from version 0.70 to 0.72. + +=item * + +L<User::grent> has been upgraded from version 1.02 to 1.03. + +=item * + +L<utf8> has been upgraded from version 1.21 to 1.22. + +=item * + +L<vars> has been upgraded from version 1.04 to 1.05. + +C<vars.pm> no longer disables non-vars strict when checking if strict +vars is enabled. +L<[perl #130674]|https://rt.perl.org/Ticket/Display.html?id=130674>. + +=item * + +L<version> has been upgraded from version 0.9923 to 0.9924. + +=item * + +L<warnings> has been upgraded from version 1.42 to 1.44. + +=item * + +L<XS::APItest> has been upgraded from version 0.98 to 1.00. + +=item * + +L<XS::Typemap> has been upgraded from version 0.16 to 0.17. + +=back + +=head2 Removed Modules and Pragmata + +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. + +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. + +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. + +=over 4 + +=item * + +B::Debug is no longer distributed with the core distribution. It +continues to be available on CPAN as +C<< L<B::Debug|https://metacpan.org/pod/B::Debug> >>. + +=item * + +Locale::Codes has been removed at the request of its author. It +continues to be available on CPAN as +C<< L<Locale::Codes|https://metacpan.org/pod/Locale::Codes> >> +L<[perl #133458]|https://rt.perl.org/Ticket/Display.html?id=133458>. + +=back + +=head1 Documentation + +=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, send email +to L<perlbug@perl.org|mailto:perlbug@perl.org>. + +=head3 L<perlapi> + +=over 4 + +=item * + +C<AvFILL()> was wrongly listed as deprecated. This has been corrected. +L<[perl #133278]|https://rt.perl.org/Ticket/Display.html?id=133278> + +=back + +=head3 L<perlop> + +=over 4 + +=item * + +We no longer have null (empty line) here doc terminators, so +L<perlop> should not refer to them. + +=item * + +The behaviour of C<tr> when the delimiter is an apostrophe has been clarified. +In particular, hyphens aren't special, and C<\x{}> isn't interpolated. +L<[perl #130679]|https://rt.perl.org/Ticket/Display.html?id=130679> + +=back + +=head3 L<perlreapi>, L<perlvar> + +=over 4 + +=item * + +Improve docs for lastparen, lastcloseparen. + +=back + +=head3 L<perlfunc> + +=over 4 + +=item * + +The entry for L<perlfunc/-X> has been clarified to indicate that symbolic +links are followed for most tests. + +=item * + +Clarification of behaviour of C<reset EXPR>. + +=item * + +Try to clarify that C<< ref(qr/xx/) >> returns C<Regexp> rather than +C<REGEXP> and why. +L<[perl #133751]|https://rt.perl.org/Ticket/Display.html?id=133751>. + +=back + +=head3 L<perlreref> + +=over 4 + +=item * + +Clarification of the syntax of /(?(cond)yes)/. + +=back + +=head3 L<perllocale> + +=over 4 + +=item * + +There are actually two slightly different types of UTF-8 locales: one for Turkic +languages and one for everything else. Starting in Perl v5.30, Perl seamlessly +handles both types. + +=back + +=head3 L<perlrecharclass> + +=over 4 + +=item * + +Added a note for the ::xdigit:: character class. + +=back + +=head3 L<perlvar> + +=over 4 + +=item * + +More specific documentation of paragraph mode. +L<[perl #133722]|https://rt.perl.org/Ticket/Display.html?id=133722>. + +=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<perldiag>. + +=head2 Changes to Existing Diagnostics + +=over 4 + +=item * + +As noted under L<Incompatible Changes> above, the deprecation warning +"Unescaped left brace in regex is deprecated here (and will be fatal in Perl +5.30), passed through in regex; marked by S<<-- HERE> in m/%s/" has been +changed to the non-deprecation warning "Unescaped left brace in regex is passed +through in regex; marked by S<<-- HERE> in m/%s/". + +=item * + +Specifying C<\o{}> without anything between the braces now yields the +fatal error message "Empty \o{}". Previously it was "Number with no +digits". This means the same wording is used for this kind of error as +with similar constructs such as C<\p{}>. + +=item * + +Within the scope of the experimental feature C<use re 'strict'>, +specifying C<\x{}> without anything between the braces now yields the +fatal error message "Empty \x{}". Previously it was "Number with no +digits". This means the same wording is used for this kind of error as +with similar constructs such as C<\p{}>. It is legal, though not wise +to have an empty C<\x> outside of C<re 'strict'>; it silently generates +a NUL character. + +=item * + +L<Type of arg %d to %s must be %s (not %s)|perldiag/"Type of arg %d to %s must be %s (not %s)"> + +Attempts to push, pop, etc on a hash or glob now produce this message +rather than complaining that they no longer work on scalars. +L<[perl #130367]|https://rt.perl.org/Ticket/Display.html?id=130367>. + +=item * + +L<Prototype not terminated|perldiag/"Prototype not terminated"> + +The file and line number is now reported for this error. +L<[perl #133524]|https://rt.perl.org/Ticket/Display.html?id=133524> + +=item * + +Under C<< -Dr >> (or C<< use re 'Debug' >>) the compiled regex engine +program is displayed. It used to use two different spellings for I<< +infinity >>, +C<< INFINITY >>, and C<< INFTY >>. It now uses the latter exclusively, +as that spelling has been around the longest. + +=back + +=head1 Utility Changes + +=head2 L<xsubpp> + +=over 4 + +=item * + +The generated prototype (with C<< PROTOTYPES: ENABLE >>) would include +C<< OUTLIST >> parameters, but these aren't arguments to the perl function. +This has been rectified. +L<[perl #133654]|https://rt.perl.org/Ticket/Display.html?id=133654>. + +=back + +=head1 Configuration and Compilation + +=over 4 + +=item * + +Normally the thread-safe locale functions are used only on threaded +builds. It is now possible to force their use on unthreaded builds on +systems that have them available, by including the +C<-Accflags='-DUSE_THREAD_SAFE_LOCALE'> option to F<Configure>. + +=item * + +Improve detection of memrchr, strlcat, and strlcpy + +=item * + +Improve Configure detection of memmem(). +L<[perl #133760]|https://rt.perl.org/Ticket/Display.html?id=133760>. + +=item * + +Multiple improvements and fixes for -DPERL_GLOBAL_STRUCT build option. + +=item * + +Fix -DPERL_GLOBAL_STRUCT_PRIVATE build option. + +=back + +=head1 Testing + +=over 4 + +=item * + +F<t/lib/croak/op> +L<[perl #130367]|https://rt.perl.org/Ticket/Display.html?id=130367>. + +separate error for C<push>, etc. on hash/glob. + +=item * + +F<t/op/svleak.t> +L<[perl #133660]|https://rt.perl.org/Ticket/Display.html?id=133660>. + +Add test for C<goto &sub> in overload leaking. + +=item * + +Split F<t/re/fold_grind.t> into multiple test files. + +=item * + +Fix intermittent tests which failed due to race conditions which +surface during parallel testing. +L<[perl #133740]|https://rt.perl.org/Ticket/Display.html?id=133740>. + +=item * + +Thoroughly test paragraph mode, using a new test file, +F<t/io/paragraph_mode.t>. +L<[perl #133722]|https://rt.perl.org/Ticket/Display.html?id=133722>. + +=item * + +Some tests in F<< t/io/eintr.t >> caused the process to hang on +pre-16 Darwin. These tests are skipped for those version of Darwin. + +=back + +=head1 Platform Support + +=head2 Platform-Specific Notes + +=over 4 + +=item HP-UX 11.11 + +An obscure problem in C<pack()> when compiling with HP C-ANSI-C has been fixed +by disabling optimizations in F<pp_pack.c>. + +=item Mac OS X + +Perl's build and testing process on Mac OS X for C<-Duseshrplib> +builds is now compatible with Mac OS X System Integrity Protection +(SIP). + +SIP prevents binaries in F</bin> (and a few other places) being passed +the C<DYLD_LIBRARY_PATH> environment variable. For our purposes this +prevents C<DYLD_LIBRARY_PATH> from being passed to the shell, which +prevents that variable being passed to the testing or build process, +so running C<perl> couldn't find F<libperl.dylib>. + +To work around that, the initial build of the F<perl> executable +expects to find F<libperl.dylib> in the build directory, and the +library path is then adjusted during installation to point to the +installed library. + +L<[perl #126706]|https://rt.perl.org/Ticket/Display.html?id=126706>. + +=item Minix3 + +Some support for Minix3 has been re-added. + +=item Cygwin + +Cygwin doesn't make C<< cuserid >> visible. + +=item Win32 Mingw + +C99 math functions are now available. + +=item Windows + +=over 4 + +=item * + +The C<USE_CPLUSPLUS> build option which has long been available in +F<win32/Makefile> (for B<nmake>) and F<win32/makefile.mk> (for B<dmake>) is now +also available in F<win32/GNUmakefile> (for B<gmake>). + +=item * + +The B<nmake> makefile no longer defaults to Visual C++ 6.0 (a very old version +which is unlikely to be widely used today). As a result, it is now a +requirement to specify the C<CCTYPE> since there is no obvious choice of which +modern version to default to instead. Failure to specify C<CCTYPE> will result +in an error being output and the build will stop. + +(The B<dmake> and B<gmake> makefiles will automatically detect which compiler +is being used, so do not require C<CCTYPE> to be set. This feature has not yet +been added to the B<nmake> makefile.) + +=item * + +C<sleep()> with warnings enabled for a C<USE_IMP_SYS> build no longer +warns about the sleep timeout being too large. +L<[perl #133376]|https://rt.perl.org/Ticket/Display.html?id=133376>. + +=item * + +Support for compiling perl on Windows using Microsoft Visual Studio 2019 +(containing Visual C++ 14.2) has been added. + +=item * + +socket() now sets C<$!> if the protocol, address family and socket +type combination is not found. +L<[perl #133853]|https://rt.perl.org/Ticket/Display.html?id=133853>. + +=item * + +The Windows Server 2003 SP1 Platform SDK build, with its early x64 compiler and +tools, was accidentally broken in Perl 5.27.9. This has now been fixed. + +=back + +=back + +=head1 Internal Changes + +=over 4 + +=item * + +The sizing pass has been eliminated from the regular expression +compiler. An extra pass may instead be needed in some cases to count +the number of parenthetical capture groups. + +=item * + +A new function L<perlapi/C<my_strtod>> or its synonym, Strtod(), is +now available with the same signature as the libc strtod(). It provides +strotod() equivalent behavior on all platforms, using the best available +precision, depending on platform capabilities and F<Configure> options, +while handling locale-related issues, such as if the radix character +should be a dot or comma. + +=item * + +Added C<newSVsv_nomg()> to copy a SV without processing get magic on +the source. +L<[perl #132964]|https://rt.perl.org/Ticket/Display.html?id=132964>. + +=item * + +It is now forbidden to malloc more than C<PTRDIFF_T_MAX> bytes. Much +code (including C optimizers) assumes that all data structures will not +be larger than this, so this catches such attempts before overflow +happens. + +=item * + +Two new regnodes have been introduced C<< EXACT_ONLY8 >>, and +C<< EXACTFU_ONLY8 >>. They're equivalent to C<< EXACT >> and C<< EXACTFU >>, +except that they contain a code point which requires UTF-8 to +represent/match. Hence, if the target string isn't UTF-8, we know +it can't possibly match, without needing to try. + +=item * + +C<< print_bytes_for_locale() >> is now defined if C<< DEBUGGING >>, +Prior, it didn't get defined unless C<< LC_COLLATE >> was defined +on the platform. + +=back + +=head1 Selected Bug Fixes + +=over 4 + +=item * + +Compilation under C<-DPERL_MEM_LOG> and C<-DNO_LOCALE> have been fixed. + +=item * + +Perl 5.28 introduced an C<index()> optimization when comparing to -1 (or +indirectly, e.g. >= 0). When this optimization was triggered inside a C<when> +clause it caused a warning ("Argument %s isn't numeric in smart match"). This +has now been fixed. +L<[perl #133368]|https://rt.perl.org/Ticket/Display.html?id=133368> + +=item * + +The new in-place editing code no longer leaks directory handles. +L<[perl #133314]|https://rt.perl.org/Ticket/Display.html?id=133314>. + +=item * + +Warnings produced from constant folding operations on overloaded +values no longer produce spurious "Use of uninitialized value" +warnings. +L<[perl #132683]|https://rt.perl.org/Ticket/Display.html?id=132683>. + +=item * + +Fix for "mutator not seen in (lex = ...) .= ..." +L<[perl #133441]|https://rt.perl.org/Ticket/Display.html?id=133441>. + +=item * + +C<pack "u", "invalid uuencoding"> now properly NUL terminates the +zero-length SV produced. +L<[perl #132655]|https://rt.perl.org/Ticket/Display.html?id=132655>. + +=item * + +Improve the debugging output for calloc() calls with C<-Dm>. +L<[perl #133439]|https://rt.perl.org/Ticket/Display.html?id=133439>. + +=item * + +Regexp script runs were failing to permit ASCII digits in some cases. +L<[perl #133547]|https://rt.perl.org/Ticket/Display.html?id=133547>. + +=item * + +On Unix-like systems supporting a platform-specific technique for +determining L<< C<$^X>|perlvar/$^X >>, Perl failed to fall back to the +generic technique when the platform-specific one fails (for example, a Linux +system with /proc not mounted). This was a regression in Perl 5.28.0. +L<[perl #133573]|https://rt.perl.org/Ticket/Display.html?id=133573>. + +=item * + +L<SDBM_File> is now more robust with corrupt database files. The +improvements do not make SDBM files suitable as an interchange format. +L<[perl #132147]|https://rt.perl.org/Ticket/Display.html?id=132147>. + +=item * + +C<binmode($fh);> or C<binmode($fh, ':raw');> now properly removes the +C<:utf8> flag from the default C<:crlf> I/O layer on Win32. +L<[perl #133604]|https://rt.perl.org/Ticket/Display.html?id=133604>. + +=item * + +The experimental reference aliasing feature was misinterpreting array and +hash slice assignment as being localised, e.g. + + \(@a[3,5,7]) = \(....); + +was being interpreted as: + + local \(@a[3,5,7]) = \(....); + +L<[perl #133538]|https://rt.perl.org/Ticket/Display.html?id=133538>. + +=item * + +C<sort SUBNAME> within an C<eval EXPR> when C<EXPR> was UTF-8 upgraded +could panic if the C<SUBNAME> was non-ASCII. +L<[perl #134061]|https://rt.perl.org/Ticket/Display.html?id=134061>. + +=item * + +Correctly handle realloc() modifying C<errno> on success so that the +modification isn't visible to the perl user, since realloc() is called +implicitly by the interpreter. This modification is permitted by the +C standard, but has only been observed on FreeBSD 13.0-CURRENT. +L<[perl #133958]|https://rt.perl.org/Ticket/Display.html?id=133958>. + +=item * + +Perl now exposes POSIX C<getcwd> as C<Internals::getcwd()> if +available. This is intended for use by C<Cwd.pm> during bootstrapping +and may be removed or changed without notice. This fixes some +bootstrapping issues while building perl in a directory where some +ancestor directory isn't readable. +L<[perl #133951]|https://rt.perl.org/Ticket/Display.html?id=133951>. + +=item * + +C<pack()> no longer can return malformed UTF-8. It croaks if it would +otherwise return a UTF-8 string that contains malformed UTF-8. This +protects against potential security threats. +L<[perl #131642]|https://rt.perl.org/Ticket/Display.html?id=131642>. + +=item * + +See L</Any set of digits in the Common script are legal in a script run +of another script>. + +=item * + +Regular expression matching no longer leaves stale UTF-8 length magic +when updating C<$^R>. This could result in C<length($^R)> returning +an incorrect value. + +=item * + +Reduce recursion on ops +L<[perl #108276]|https://rt.perl.org/Ticket/Display.html?id=108276>. + +This can prevent stack overflow when processing extremely deep op +trees. + +=item * + +Avoid leak in multiconcat with overloading. +L<[perl #133789]|https://rt.perl.org/Ticket/Display.html?id=133789>. + +=item * + +The handling of user-defined C<\p{}> properties (see +L<perlunicode/User-Defined Character Properties>) has been rewritten to +be in C (instead of Perl). This speeds things up, but in the process +several inconsistencies and bug fixes are made. + +=over 4 + +=item 1 + +A few error messages have minor wording changes. This is essentially +because the new way is integrated into the regex error handling +mechanism that marks the position in the input at which the error +occurred. That was not possible previously. The messages now also +contain additional back-trace-like information in case the error occurs +deep in nested calls. + +=item 2 + +A user-defined property is implemented as a perl subroutine with certain +highly constrained naming conventions. It was documented previously +that the sub would be in the current package if the package was +unspecified. This turned out not to be true in all cases, but now it +is. + +=item 3 + +All recursive calls are treated as infinite recursion. Previously they +would cause the interpreter to panic. Now, they cause the regex pattern +to fail to compile. + +=item 4 + +Similarly, any other error likely would lead to a panic; now to just the +pattern failing to compile. + +=item 5 + +The old mechanism did not detect illegal ranges in the definition of the +property. Now, the range max must not be smaller than the range min. +Otherwise, the pattern fails to compile. + +=item 6 + +The intention was to have each sub called only once during the lifetime +of the program, so that a property's definition is immutable. This was +relaxed so that it could be called once for all /i compilations, and +potentially a second time for non-/i (the sub is passed a parameter +indicating which). However, in practice there were instances when this +was broken, and multiple calls were possible. Those have been fixed. +Now (besides the /i,non-/i cases) the only way a sub can be called +multiple times is if some component of it has not been defined yet. For +example, suppose we have sub IsA() whose definition is known at compile +time, and it in turn calls isB() whose definition is not yet known. +isA() will be called each time a pattern it appears in is compiled. If +isA() also calls isC() and that definition is known, isC() will be +called just once. + +=item 7 + +There were some races and very long hangs should one thread be compiling +the same property as another simultaneously. These have now been fixed. + +=back + +=item * + +Fixed a failure to match properly. + +An EXACTFish regnode has a finite length it can hold for the string +being matched. If that length is exceeded, a second node is used for +the next segment of the string, for as many regnodes as are needed. +Care has to be taken where to break the string, in order to deal +multi-character folds in Unicode correctly. If we want to break a +string at a place which could potentially be in the middle of a +multi-character fold, we back off one (or more) characters, leaving +a shorter EXACTFish regnode. This backing off mechanism contained +an off-by-one error. +L<[perl #133756]|https://rt.perl.org/Ticket/Display.html?id=133756>. + +=item * + +A bare C<eof> call with no previous file handle now returns true. +L<[perl #133721]|https://rt.perl.org/Ticket/Display.html?id=133721> + +=item * + +Failing to compile a format now aborts compilation. Like other errors +in sub-parses this could leave the parser in a strange state, possibly +crashing perl if compilation continued. +L<[perl #132158]|https://rt.perl.org/Ticket/Display.html?id=132158> + +=item * + +If an in-place edit is still in progress during global destruction and +the process exit code (as stored in C<$?>) is zero, perl will now +treat the in-place edit as successful, replacing the input file with +any output produced. + +This allows code like: + + perl -i -ne 'print "Foo"; last' + +to replace the input file, while code like: + + perl -i -ne 'print "Foo"; die' + +will not. Partly resolves +L<[perl #133659]|https://rt.perl.org/Ticket/Display.html?id=133659>. + +=item * + +A regression in 5.28 caused the following code to fail + + close(STDIN); open(CHILD, "|wc -l")' + +because the child's stdin would be closed on exec. This has now been fixed. + +=item * + +Fixed an issue where compiling a regexp containing both compile-time +and run-time code blocks could lead to trying to compile something +which is invalid syntax. + +=item * + +Fixed build failures with C<< -DNO_LOCALE_NUMERIC >> and +C<< -DNO_LOCALE_COLLATE >>. +L<[perl #133696]|https://rt.perl.org/Ticket/Display.html?id=133696>. + +=item * + +Prevent the tests in F<< ext/B/t/strict.t >> from being skipped. +L<[perl #133713]|https://rt.perl.org/Ticket/Display.html?id=133713>. + +=item * + +C<< /di >> nodes ending or beginning in I<s> are now C<< EXACTF >>. We do not +want two C<< EXACTFU >> to be joined together during optimization, +and to form a C<< ss >>, C<< sS >>, C<< Ss >> or C<< SS >> sequence; +they are the only multi-character sequences which may match differently +under C<< /ui >> and C<< /di >>. + +=back + +=head1 Acknowledgements + +Perl 5.30.0 represents approximately 11 months of development since Perl +5.28.0 and contains approximately 620,000 lines of changes across 1,300 +files from 58 authors. + +Excluding auto-generated files, documentation and release tools, there were +approximately 510,000 lines of changes to 750 .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.30.0: + +Aaron Crane, Abigail, Alberto Simões, Alexandr Savca, Andreas König, Andy +Dougherty, Aristotle Pagaltzis, Brian Greenfield, Chad Granum, Chris +'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Book, Dan +Dedrick, Daniel Dragan, Dan Kogai, David Cantrell, David Mitchell, Dominic +Hargreaves, E. Choroba, Ed J, Eugen Konkov, François Perrad, Graham Knop, +Hauke D, H.Merijn Brand, Hugo van der Sanden, Jakub Wilk, James Clarke, +James E Keenan, Jerry D. Hedden, Jim Cromie, John SJ Anderson, Karen +Etheridge, Karl Williamson, Leon Timmermans, Matthias Bethke, Nicholas +Clark, Nicolas R., Niko Tyni, Pali, Petr Písař, Phil Pearl (Lobbes), +Richard Leach, Ryan Voots, Sawyer X, Shlomi Fish, Sisyphus, Slaven Rezic, +Steve Hay, Sullivan Beck, Tina Müller, Tomasz Konojacki, Tom Wyant, Tony +Cook, Unicode Consortium, Yves Orton, Zak B. Elep. + +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 most of the (very much appreciated) contributors who reported +issues to the Perl bug tracker. Noteworthy in this release were the large +number of bug fixes made possible by Sergey Aleynikov's high quality perlbug +reports for issues he discovered by fuzzing with AFL. + +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<AUTHORS> 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<https://rt.perl.org/>. There may also be information at +L<http://www.perl.org/>, the Perl Home Page. + +If you believe you have an unreported bug, please run the L<perlbug> program +included with your release. Be sure to trim your bug down to a tiny but +sufficient test case. Your bug report, along with the output of C<perl -V>, +will be sent off to perlbug@perl.org to be analysed by the Perl porting team. + +If the bug you are reporting has security implications which make it +inappropriate to send to a publicly archived mailing list, then see +L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION> +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<perlthanks> program: + + perlthanks + +This will send an email to the Perl 5 Porters list with your show of thanks. + +=head1 SEE ALSO + +The F<Changes> file for an explanation of how to view exhaustive details on +what changed. + +The F<INSTALL> file for how to build Perl. + +The F<README> file for general stuff. + +The F<Artistic> and F<Copying> files for copyright information. + +=cut diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 52a6c9776e..e23ee6a8d6 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -2,652 +2,56 @@ =head1 NAME -perldelta - what is new for perl v5.30.0 +[ 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.30.1 =head1 DESCRIPTION -This document describes differences between the 5.28.0 release and the 5.30.0 +This document describes differences between the 5.30.0 release and the 5.30.1 release. -If you are upgrading from an earlier release such as 5.26.0, first read -L<perl5280delta>, which describes differences between 5.26.0 and 5.28.0. +If you are upgrading from an earlier release such as 5.29.0, first read +L<perl5300delta>, which describes differences between 5.29.0 and 5.30.0. =head1 Notice -sv_utf8_(downgrade|decode) are no longer marked as experimental. -L<[perl #133788]|https://rt.perl.org/Ticket/Display.html?id=133788>. +XXX Any important notices here =head1 Core Enhancements -=head2 Limited variable length lookbehind in regular expression pattern matching is now experimentally supported - -Using a lookbehind assertion (like C<(?<=foo?)> or C<(?<!ba{1,9}r)> previously -would generate an error and refuse to compile. Now it compiles (if the -maximum lookbehind is at most 255 characters), but raises a warning in -the new C<experimental::vlb> warnings category. This is to caution you -that the precise behavior is subject to change based on feedback from -use in the field. - -See L<perlre/(?<=pattern)> and L<perlre/(?<!pattern)>. - -=head2 The upper limit C<"n"> specifiable in a regular expression quantifier of the form C<"{m,n}"> has been doubled to 65534 - -The meaning of an unbounded upper quantifier C<"{m,}"> remains unchanged. -It matches 2**31 - 1 times on most platforms, and more on ones where a C -language short variable is more than 4 bytes long. - -=head2 Unicode 12.1 is supported - -Because of a change in Unicode release cycles, Perl jumps from Unicode -10.0 in Perl 5.28 to Unicode 12.1 in Perl 5.30. - -For details on the Unicode changes, see -L<https://www.unicode.org/versions/Unicode11.0.0/> for 11.0; -L<https://www.unicode.org/versions/Unicode12.0.0/> for 12.0; -and -L<https://www.unicode.org/versions/Unicode12.1.0/> for 12.1. -(Unicode 12.1 differs from 12.0 only in the addition of a single -character, that for the new Japanese era name.) - -The Word_Break property, as in past Perl releases, remains tailored to -behave more in line with expectations of Perl users. This means that -sequential runs of horizontal white space characters are not broken -apart, but kept as a single run. Unicode 11 changed from past versions -to be more in line with Perl, but it left several white space characters -as causing breaks: TAB, NO BREAK SPACE, and FIGURE SPACE (U+2007). We -have decided to continue to use the previous Perl tailoring with regards -to these. - -=head2 Wildcards in Unicode property value specifications are now partially supported - -You can now do something like this in a regular expression pattern - - qr! \p{nv= /(?x) \A [0-5] \z / }! - -which matches all Unicode code points whose numeric value is -between 0 and 5 inclusive. So, it could match the Thai or Bengali -digits whose numeric values are 0, 1, 2, 3, 4, or 5. - -This marks another step in implementing the regular expression features -the Unicode Consortium suggests. - -Most properties are supported, with the remainder planned for 5.32. -Details are in L<perlunicode/Wildcards in Property Values>. - -=head2 qr'\N{name}' is now supported - -Previously it was an error to evaluate a named character C<\N{...}> -within a single quoted regular expression pattern (whose evaluation is -deferred from the normal place). This restriction is now removed. - -=head2 Turkic UTF-8 locales are now seamlessly supported +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</Performance Enhancements> section. -Turkic languages have different casing rules than other languages for -the characters C<"i"> and C<"I">. The uppercase of C<"i"> is LATIN -CAPITAL LETTER I WITH DOT ABOVE (U+0130); and the lowercase of C<"I"> is LATIN -SMALL LETTER DOTLESS I (U+0131). Unicode furnishes alternate casing -rules for use with Turkic languages. Previously, Perl ignored these, -but now, it uses them when it detects that it is operating under a -Turkic UTF-8 locale. +[ List each enhancement as a =head2 entry ] -=head2 It is now possible to compile perl to always use thread-safe locale operations. +=head1 Security -Previously, these calls were only used when the perl was compiled to be -multi-threaded. To always enable them, add +XXX Any security-related notices go here. In particular, any security +vulnerabilities closed should be noted here rather than in the +L</Selected Bug Fixes> section. - -Accflags='-DUSE_THREAD_SAFE_LOCALE' - -to your F<Configure> flags. - -=head2 Eliminate opASSIGN macro usage from core - -This macro is still defined but no longer used in core - -=head2 C<-Drv> now means something on C<-DDEBUGGING> builds - -Now, adding the verbose flag (C<-Dv>) to the C<-Dr> flag turns on all -possible regular expression debugging. +[ List each security issue as a =head2 entry ] =head1 Incompatible Changes -=head2 Assigning non-zero to C<$[> is fatal - -Setting L<< C<$[>|perlvar/$[ >> to a non-zero value has been deprecated since -Perl 5.12 and now throws a fatal error. -See L<<< perldeprecation/Assigning non-zero to C<< $[ >> is fatal >>>. - -=head2 Delimiters must now be graphemes - -See L<perldeprecation/Use of unassigned code point or non-standalone grapheme -for a delimiter.> - -=head2 Some formerly deprecated uses of an unescaped left brace C<"{"> in -regular expression patterns are now illegal - -But to avoid breaking code unnecessarily, most instances that issued a -deprecation warning, remain legal and now have a non-deprecation warning -raised. See L<perldeprecation/Unescaped left braces in regular expressions>. - -=head2 Previously deprecated sysread()/syswrite() on :utf8 handles is now fatal - -Calling sysread(), syswrite(), send() or recv() on a C<:utf8> handle, -whether applied explicitly or implicitly, is now fatal. This was -deprecated in perl 5.24. - -There were two problems with calling these functions on C<:utf8> -handles: - -=over - -=item * - -All four functions only paid attention to the C<:utf8> flag. Other -layers were completely ignored, so a handle with -C<:encoding(UTF-16LE)> layer would be treated as UTF-8. Other layers, -such as compression are completely ignored with or without the -C<:utf8> flag. +XXX For a release on a stable branch, this section aspires to be: -=item * - -sysread() and recv() would read from the handle, skipping any -validation by the layers, and do no validation of their own. This -could lead to invalidly encoded perl scalars. - -=back - -L<[perl #125760]|https://rt.perl.org/Ticket/Display.html?id=125760>. - -=head2 my() in false conditional prohibited - -Declarations such as C<my $x if 0> are no longer permitted. - -L<[perl #133543]|https://rt.perl.org/Ticket/Display.html?id=133543>. - -=head2 Fatalize $* and $# - -These special variables, long deprecated, now throw exceptions when used. - -L<[perl #133583]|https://rt.perl.org/Ticket/Display.html?id=133583>. - -=head2 Fatalize unqualified use of dump() - -The C<dump()> function, long discouraged, may no longer be used unless it is -fully qualified, I<i.e.>, C<CORE::dump()>. - -L<[perl #133584]|https://rt.perl.org/Ticket/Display.html?id=133584>. - -=head2 Remove File::Glob::glob() - -The C<File::Glob::glob()> function, long deprecated, has been removed and now -throws an exception which advises use of C<File::Glob::bsd_glob()> instead. - -L<[perl #133586]|https://rt.perl.org/Ticket/Display.html?id=133586>. - -=head2 C<pack()> no longer can return malformed UTF-8 + 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</Reporting Bugs> below. -It croaks if it would otherwise return a UTF-8 string that contains -malformed UTF-8. This protects against potential security threats. This -is considered a bug fix as well. -L<[perl #131642]|https://rt.perl.org/Ticket/Display.html?id=131642>. - -=head2 Any set of digits in the Common script are legal in a script run of another script - -There are several sets of digits in the Common script. C<[0-9]> is the -most familiar. But there are also C<[\x{FF10}-\x{FF19}]> (FULLWIDTH -DIGIT ZERO - FULLWIDTH DIGIT NINE), and several sets for use in -mathematical notation, such as the MATHEMATICAL DOUBLE-STRUCK DIGITs. -Any of these sets should be able to appear in script runs of, say, -Greek. But the design of 5.30 overlooked all but the ASCII digits -C<[0-9]>, so the design was flawed. This has been fixed, so is both a -bug fix and an incompatibility. -L<[perl #133547]|https://rt.perl.org/Ticket/Display.html?id=133547>. - -All digits in a run still have to come from the same set of ten digits. - -=head2 JSON::PP enables allow_nonref by default - -As JSON::XS 4.0 changed its policy and enabled allow_nonref -by default, JSON::PP also enabled allow_nonref by default. +[ List each incompatible change as a =head2 entry ] =head1 Deprecations -=head2 In XS code, use of various macros dealing with UTF-8. - -This deprecation was scheduled to become fatal in 5.30, but has been -delayed to 5.32 due to problems that showed up with some CPAN modules. -For details of what's affected, see L<perldeprecation| -perldeprecation/In XS code, use of various macros dealing with UTF-8.>. - -=head1 Performance Enhancements - -=over 4 - -=item * - -Translating from UTF-8 into the code point it represents now is done via a -deterministic finite automaton, speeding it up. As a typical example, -C<ord("\x7fff")> now requires 12% fewer instructions than before. The -performance of checking that a sequence of bytes is valid UTF-8 is similarly -improved, again by using a DFA. - -=item * - -Eliminate recursion from finalize_op(). -L<[perl #108276]|https://rt.perl.org/Ticket/Display.html?id=108276>. - -=item * - -A handful of small optimizations related to character folding -and character classes in regular expressions. - -=item * - -Optimization of C<IV> to C<UV> conversions. -L<[perl #133677]|https://rt.perl.org/Ticket/Display.html?id=133677>. - -=item * - -Speed up of the integer stringification algorithm by processing -two digits at a time instead of one. -L<[perl #133691]|https://rt.perl.org/Ticket/Display.html?id=133691>. - -=item * - -Improvements based on LGTM analysis and recommendation. -(L<https://lgtm.com/projects/g/Perl/perl5/alerts/?mode=tree>). -L<[perl #133686]|https://rt.perl.org/Ticket/Display.html?id=133686>. -L<[perl #133699]|https://rt.perl.org/Ticket/Display.html?id=133699>. - -=item * - -Code optimizations in F<regcomp.c>, F<regcomp.h>, F<regexec.c>. - -=item * - -Regular expression pattern matching of things like C<qr/[^I<a>]/> is -significantly sped up, where I<a> is any ASCII character. Other classes -can get this speed up, but which ones is complicated and depends on the -underlying bit patterns of those characters, so differs between ASCII -and EBCDIC platforms, but all case pairs, like C<qr/[Gg]/> are included, -as is C<[^01]>. - -=back - -=head1 Modules and Pragmata - -=head2 Updated Modules and Pragmata - -=over 4 - -=item * - -L<Archive::Tar> has been upgraded from version 2.30 to 2.32. - -=item * - -L<B> has been upgraded from version 1.74 to 1.76. - -=item * - -L<B::Concise> has been upgraded from version 1.003 to 1.004. - -=item * - -L<B::Deparse> has been upgraded from version 1.48 to 1.49. - -=item * - -L<bignum> has been upgraded from version 0.49 to 0.51. - -=item * - -L<bytes> has been upgraded from version 1.06 to 1.07. - -=item * - -L<Carp> has been upgraded from version 1.38 to 1.50 - -=item * - -L<Compress::Raw::Bzip2> has been upgraded from version 2.074 to 2.084. - -=item * - -L<Compress::Raw::Zlib> has been upgraded from version 2.076 to 2.084. - -=item * - -L<Config::Extensions> has been upgraded from version 0.02 to 0.03. - -=item * - -L<Config::Perl::V>. has been upgraded from version 0.29 to 0.32. This was due -to a new configuration variable that has influence on binary compatibility: -C<USE_THREAD_SAFE_LOCALE>. - -=item * - -L<CPAN> has been upgraded from version 2.20 to 2.22. - -=item * - -L<Data::Dumper> has been upgraded from version 2.170 to 2.174 - -L<Data::Dumper> now avoids leaking when C<croak>ing. - -=item * - -L<DB_File> has been upgraded from version 1.840 to 1.843. - -=item * - -L<deprecate> has been upgraded from version 0.03 to 0.04. - -=item * - -L<Devel::Peek> has been upgraded from version 1.27 to 1.28. - -=item * - -L<Devel::PPPort> has been upgraded from version 3.40 to 3.52. - -=item * - -L<Digest::SHA> has been upgraded from version 6.01 to 6.02. - -=item * - -L<Encode> has been upgraded from version 2.97 to 3.01. - -=item * - -L<Errno> has been upgraded from version 1.29 to 1.30. - -=item * - -L<experimental> has been upgraded from version 0.019 to 0.020. - -=item * - -L<ExtUtils::CBuilder> has been upgraded from version 0.280230 to 0.280231. - -=item * - -L<ExtUtils::Manifest> has been upgraded from version 1.70 to 1.72. - -=item * - -L<ExtUtils::Miniperl> has been upgraded from version 1.08 to 1.09. - -=item * - -L<ExtUtils::ParseXS> has been upgraded from version 3.39 to 3.40. -C<OUTLIST> parameters are no longer incorrectly included in the -automatically generated function prototype. -L<[perl #133654]|https://rt.perl.org/Ticket/Display.html?id=133654>. - -=item * - -L<feature> has been upgraded from version 1.52 to 1.54. - -=item * - -L<File::Copy> has been upgraded from version 2.33 to 2.34. - -=item * - -L<File::Find> has been upgraded from version 1.34 to 1.36. - -C<$File::Find::dont_use_nlink> now defaults to 1 on all -platforms. -L<[perl #133673]|https://rt.perl.org/Ticket/Display.html?id=133673>. - -Variables C<< $Is_Win32 >> and C<< $Is_VMS >> are being initialized. - -=item * - -L<File::Glob> has been upgraded from version 1.31 to 1.32. - -=item * - -L<File::Path> has been upgraded from version 2.15 to 2.16. - -=item * - -L<File::Spec> has been upgraded from version 3.74 to 3.78. - -Silence L<Cwd> warning on Android builds if C<targetsh> is not defined. - -=item * - -L<File::Temp> has been upgraded from version 0.2304 to 0.2309. - -=item * - -L<Filter::Util::Call> has been upgraded from version 1.58 to 1.59. - -=item * - -L<GDBM_File> has been upgraded from version 1.17 to 1.18. - -=item * - -L<HTTP::Tiny> has been upgraded from version 0.070 to 0.076. - -=item * - -L<I18N::Langinfo> has been upgraded from version 0.17 to 0.18. - -=item * - -L<IO> has been upgraded from version 1.39 to 1.40. - -=item * - -IO-Compress has been upgraded from version 2.074 to 2.084. - -Adds support for C<< IO::Uncompress::Zstd >> and -C<< IO::Uncompress::UnLzip >>. - -The C<< BinModeIn >> and C<< BinModeOut >> options are now no-ops. -ALL files will be read/written in binmode. - -=item * - -L<IPC::Cmd> has been upgraded from version 1.00 to 1.02. - -=item * - -L<JSON::PP> has been upgraded from version 2.97001 to 4.02. - -L<JSON::PP> as JSON::XS 4.0 enables C<allow_nonref> by default. - -=item * - -L<lib> has been upgraded from version 0.64 to 0.65. - -=item * - -L<Locale::Codes> has been upgraded from version 3.56 to 3.57. - -=item * - -L<Math::BigInt> has been upgraded from version 1.999811 to 1.999816. - -C<< bnok() >> now supports the full Kronenburg extension. -L<[cpan #95628]|https://rt.cpan.org/Ticket/Display.html?id=95628>. - -=item * - -L<Math::BigInt::FastCalc> has been upgraded from version 0.5006 to 0.5008. - -=item * - -L<Math::BigRat> has been upgraded from version 0.2613 to 0.2614. - -=item * - -L<Module::CoreList> has been upgraded from version 5.20180622 to 5.20190520. - -Changes to B::Op_private and Config - -=item * - -L<Module::Load> has been upgraded from version 0.32 to 0.34. - -=item * - -L<Module::Metadata> has been upgraded from version 1.000033 to 1.000036. - -Properly clean up temporary directories after testing. - -=item * - -L<NDBM_File> has been upgraded from version 1.14 to 1.15. - -=item * - -L<Net::Ping> has been upgraded from version 2.62 to 2.71. - -=item * - -L<ODBM_File> has been upgraded from version 1.15 to 1.16. - -=item * - -PathTools has been upgraded from version 3.74 to 3.78. - -=item * - -L<parent> has been upgraded from version 0.236 to 0.237. - -=item * - -L<perl5db.pl> has been upgraded from version 1.54 to 1.55. - -Debugging threaded code no longer deadlocks in C<DB::sub> nor -C<DB::lsub>. - -=item * - -L<perlfaq> has been upgraded from version 5.021011 to 5.20190126. - -=item * - -L<PerlIO::encoding> has been upgraded from version 0.26 to 0.27. - -Warnings enabled by setting the C<WARN_ON_ERR> flag in -C<$PerlIO::encoding::fallback> are now only produced if warnings are -enabled with C<use warnings "utf8";> or setting C<$^W>. - -=item * - -L<PerlIO::scalar> has been upgraded from version 0.29 to 0.30. - -=item * - -podlators has been upgraded from version 4.10 to 4.11. - -=item * - -L<POSIX> has been upgraded from version 1.84 to 1.88. - -=item * - -L<re> has been upgraded from version 0.36 to 0.37. - -=item * - -L<SDBM_File> has been upgraded from version 1.14 to 1.15. - -=item * - -L<sigtrap> has been upgraded from version 1.08 to 1.09. - -=item * - -L<Storable> has been upgraded from version 3.08 to 3.15. - -Storable no longer probes for recursion limits at build time. -L<[perl #133708]|https://rt.perl.org/Ticket/Display.html?id=133708> -and others. - -Metasploit exploit code was included to test for CVE-2015-1992 -detection, this caused anti-virus detections on at least one AV suite. -The exploit code has been removed and replaced with a simple -functional test. -L<[perl #133706]|https://rt.perl.org/Ticket/Display.html?id=133706> - -=item * - -L<Test::Simple> has been upgraded from version 1.302133 to 1.302162. - -=item * - -L<Thread::Queue> has been upgraded from version 3.12 to 3.13. - -=item * - -L<threads::shared> has been upgraded from version 1.58 to 1.60. - -Added support for extra tracing of locking, this requires a -C<-DDEBUGGING> and extra compilation flags. - -=item * - -L<Time::HiRes> has been upgraded from version 1.9759 to 1.9760. - -=item * - -L<Time::Local> has been upgraded from version 1.25 to 1.28. - -=item * - -L<Time::Piece> has been upgraded from version 1.3204 to 1.33. - -=item * - -L<Unicode::Collate> has been upgraded from version 1.25 to 1.27. - -=item * - -L<Unicode::UCD> has been upgraded from version 0.70 to 0.72. - -=item * - -L<User::grent> has been upgraded from version 1.02 to 1.03. - -=item * - -L<utf8> has been upgraded from version 1.21 to 1.22. - -=item * - -L<vars> has been upgraded from version 1.04 to 1.05. - -C<vars.pm> no longer disables non-vars strict when checking if strict -vars is enabled. -L<[perl #130674]|https://rt.perl.org/Ticket/Display.html?id=130674>. - -=item * - -L<version> has been upgraded from version 0.9923 to 0.9924. - -=item * - -L<warnings> has been upgraded from version 1.42 to 1.44. +XXX Any deprecated features, syntax, modules etc. should be listed here. -=item * - -L<XS::APItest> has been upgraded from version 0.98 to 1.00. +=head2 Module removals -=item * - -L<XS::Typemap> has been upgraded from version 0.16 to 0.17. - -=back - -=head2 Removed Modules and Pragmata +XXX Remove this section if not applicable. 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. @@ -663,130 +67,112 @@ 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. -=over 4 - -=item * - -B::Debug is no longer distributed with the core distribution. It -continues to be available on CPAN as -C<< L<B::Debug|https://metacpan.org/pod/B::Debug> >>. +=over -=item * +=item XXX -Locale::Codes has been removed at the request of its author. It -continues to be available on CPAN as -C<< L<Locale::Codes|https://metacpan.org/pod/Locale::Codes> >> -L<[perl #133458]|https://rt.perl.org/Ticket/Display.html?id=133458>. +XXX Note that deprecated modules should be listed here even if they are listed +as an updated module in the L</Modules and Pragmata> section. =back -=head1 Documentation +[ List each other deprecation as a =head2 entry ] -=head2 Changes to Existing Documentation +=head1 Performance Enhancements -We have attempted to update the documentation to reflect the changes -listed in this document. If you find any we have missed, send email -to L<perlbug@perl.org|mailto:perlbug@perl.org>. +XXX Changes which enhance performance without changing behaviour go here. +There may well be none in a stable release. -=head3 L<perlapi> +[ List each enhancement as an =item entry ] =over 4 =item * -C<AvFILL()> was wrongly listed as deprecated. This has been corrected. -L<[perl #133278]|https://rt.perl.org/Ticket/Display.html?id=133278> +XXX =back -=head3 L<perlop> - -=over 4 - -=item * - -We no longer have null (empty line) here doc terminators, so -L<perlop> should not refer to them. +=head1 Modules and Pragmata -=item * +XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/> +go here. If Module::CoreList is updated, generate an initial draft of the +following sections using F<Porting/corelist-perldelta.pl>. A paragraph summary +for important changes should then be added by hand. In an ideal world, +dual-life modules would have a F<Changes> file that could be cribbed. -The behaviour of C<tr> when the delimiter is an apostrophe has been clarified. -In particular, hyphens aren't special, and C<\x{}> isn't interpolated. -L<[perl #130679]|https://rt.perl.org/Ticket/Display.html?id=130679> +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.) -=back +[ Within each section, list entries as an =item entry ] -=head3 L<perlreapi>, L<perlvar> +=head2 New Modules and Pragmata =over 4 =item * -Improve docs for lastparen, lastcloseparen. +XXX Remove this section if not applicable. =back -=head3 L<perlfunc> +=head2 Updated Modules and Pragmata =over 4 =item * -The entry for L<perlfunc/-X> has been clarified to indicate that symbolic -links are followed for most tests. +L<XXX> has been upgraded from version A.xx to B.yy. -=item * - -Clarification of behaviour of C<reset EXPR>. - -=item * - -Try to clarify that C<< ref(qr/xx/) >> returns C<Regexp> rather than -C<REGEXP> and why. -L<[perl #133751]|https://rt.perl.org/Ticket/Display.html?id=133751>. +If there was something important to note about this change, include that here. =back -=head3 L<perlreref> +=head2 Removed Modules and Pragmata =over 4 =item * -Clarification of the syntax of /(?(cond)yes)/. +XXX =back -=head3 L<perllocale> +=head1 Documentation -=over 4 +XXX Changes to files in F<pod/> go here. Consider grouping entries by +file and be sure to link to the appropriate page, e.g. L<perlfunc>. -=item * +=head2 New Documentation -There are actually two slightly different types of UTF-8 locales: one for Turkic -languages and one for everything else. Starting in Perl v5.30, Perl seamlessly -handles both types. +XXX Changes which create B<new> files in F<pod/> go here. -=back +=head3 L<XXX> -=head3 L<perlrecharclass> +XXX Description of the purpose of the new file here -=over 4 +=head2 Changes to Existing Documentation -=item * +We have attempted to update the documentation to reflect the changes +listed in this document. If you find any we have missed, send email +to L<perlbug@perl.org|mailto:perlbug@perl.org>. -Added a note for the ::xdigit:: character class. +XXX Changes which significantly change existing files in F<pod/> go here. +However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics> +section. -=back +Additionally, the following selected changes have been made: -=head3 L<perlvar> +=head3 L<XXX> =over 4 =item * -More specific documentation of paragraph mode. -L<[perl #133722]|https://rt.perl.org/Ticket/Display.html?id=133722>. +XXX Description of the change here =back @@ -796,605 +182,228 @@ The following additions or changes have been made to diagnostic output, including warnings and fatal error messages. For the complete list of diagnostic messages, see L<perldiag>. -=head2 Changes to Existing Diagnostics +XXX New or changed warnings emitted by the core's C<C> code go here. Also +include any changes in L<perldiag> that reconcile it to the C<C> code. -=over 4 - -=item * +=head2 New Diagnostics -As noted under L<Incompatible Changes> above, the deprecation warning -"Unescaped left brace in regex is deprecated here (and will be fatal in Perl -5.30), passed through in regex; marked by S<<-- HERE> in m/%s/" has been -changed to the non-deprecation warning "Unescaped left brace in regex is passed -through in regex; marked by S<<-- HERE> in m/%s/". +XXX Newly added diagnostic messages go under here, separated into New Errors +and New Warnings -=item * - -Specifying C<\o{}> without anything between the braces now yields the -fatal error message "Empty \o{}". Previously it was "Number with no -digits". This means the same wording is used for this kind of error as -with similar constructs such as C<\p{}>. - -=item * +=head3 New Errors -Within the scope of the experimental feature C<use re 'strict'>, -specifying C<\x{}> without anything between the braces now yields the -fatal error message "Empty \x{}". Previously it was "Number with no -digits". This means the same wording is used for this kind of error as -with similar constructs such as C<\p{}>. It is legal, though not wise -to have an empty C<\x> outside of C<re 'strict'>; it silently generates -a NUL character. +=over 4 =item * -L<Type of arg %d to %s must be %s (not %s)|perldiag/"Type of arg %d to %s must be %s (not %s)"> - -Attempts to push, pop, etc on a hash or glob now produce this message -rather than complaining that they no longer work on scalars. -L<[perl #130367]|https://rt.perl.org/Ticket/Display.html?id=130367>. +XXX L<message|perldiag/"message"> -=item * +=back -L<Prototype not terminated|perldiag/"Prototype not terminated"> +=head3 New Warnings -The file and line number is now reported for this error. -L<[perl #133524]|https://rt.perl.org/Ticket/Display.html?id=133524> +=over 4 =item * -Under C<< -Dr >> (or C<< use re 'Debug' >>) the compiled regex engine -program is displayed. It used to use two different spellings for I<< -infinity >>, -C<< INFINITY >>, and C<< INFTY >>. It now uses the latter exclusively, -as that spelling has been around the longest. +XXX L<message|perldiag/"message"> =back -=head1 Utility Changes +=head2 Changes to Existing Diagnostics -=head2 L<xsubpp> +XXX Changes (i.e. rewording) of diagnostic messages go here =over 4 =item * -The generated prototype (with C<< PROTOTYPES: ENABLE >>) would include -C<< OUTLIST >> parameters, but these aren't arguments to the perl function. -This has been rectified. -L<[perl #133654]|https://rt.perl.org/Ticket/Display.html?id=133654>. +XXX Describe change here =back -=head1 Configuration and Compilation - -=over 4 - -=item * +=head1 Utility Changes -Normally the thread-safe locale functions are used only on threaded -builds. It is now possible to force their use on unthreaded builds on -systems that have them available, by including the -C<-Accflags='-DUSE_THREAD_SAFE_LOCALE'> option to F<Configure>. +XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here. +Most of these are built within the directory F<utils>. -=item * +[ List utility changes as a =head2 entry for each utility and =item +entries for each change +Use L<XXX> with program names to get proper documentation linking. ] -Improve detection of memrchr, strlcat, and strlcpy +=head2 L<XXX> -=item * - -Improve Configure detection of memmem(). -L<[perl #133760]|https://rt.perl.org/Ticket/Display.html?id=133760>. +=over 4 =item * -Multiple improvements and fixes for -DPERL_GLOBAL_STRUCT build option. +XXX -=item * +=back -Fix -DPERL_GLOBAL_STRUCT_PRIVATE build option. +=head1 Configuration and Compilation -=back +XXX Changes to F<Configure>, F<installperl>, F<installman>, 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</Platform Support> section, instead. -=head1 Testing +[ List changes as an =item entry ]. =over 4 =item * -F<t/lib/croak/op> -L<[perl #130367]|https://rt.perl.org/Ticket/Display.html?id=130367>. +XXX -separate error for C<push>, etc. on hash/glob. +=back -=item * +=head1 Testing -F<t/op/svleak.t> -L<[perl #133660]|https://rt.perl.org/Ticket/Display.html?id=133660>. +XXX Any significant changes to the testing of a freshly built perl should be +listed here. Changes which create B<new> files in F<t/> go here as do any +large changes to the testing harness (e.g. when parallel testing was added). +Changes to existing files in F<t/> aren't worth summarizing, although the bugs +that they represent may be covered elsewhere. -Add test for C<goto &sub> in overload leaking. +XXX If there were no significant test changes, say this: -=item * +Tests were added and changed to reflect the other additions and changes +in this release. -Split F<t/re/fold_grind.t> into multiple test files. +XXX If instead there were significant changes, say this: -=item * +Tests were added and changed to reflect the other additions and +changes in this release. Furthermore, these significant changes were +made: -Fix intermittent tests which failed due to race conditions which -surface during parallel testing. -L<[perl #133740]|https://rt.perl.org/Ticket/Display.html?id=133740>. +[ List each test improvement as an =item entry ] -=item * - -Thoroughly test paragraph mode, using a new test file, -F<t/io/paragraph_mode.t>. -L<[perl #133722]|https://rt.perl.org/Ticket/Display.html?id=133722>. +=over 4 =item * -Some tests in F<< t/io/eintr.t >> caused the process to hang on -pre-16 Darwin. These tests are skipped for those version of Darwin. +XXX =back =head1 Platform Support -=head2 Platform-Specific Notes - -=over 4 - -=item HP-UX 11.11 - -An obscure problem in C<pack()> when compiling with HP C-ANSI-C has been fixed -by disabling optimizations in F<pp_pack.c>. +XXX Any changes to platform support should be listed in the sections below. -=item Mac OS X +[ Within the sections, list each platform as an =item entry with specific +changes as paragraphs below it. ] -Perl's build and testing process on Mac OS X for C<-Duseshrplib> -builds is now compatible with Mac OS X System Integrity Protection -(SIP). +=head2 New Platforms -SIP prevents binaries in F</bin> (and a few other places) being passed -the C<DYLD_LIBRARY_PATH> environment variable. For our purposes this -prevents C<DYLD_LIBRARY_PATH> from being passed to the shell, which -prevents that variable being passed to the testing or build process, -so running C<perl> couldn't find F<libperl.dylib>. - -To work around that, the initial build of the F<perl> executable -expects to find F<libperl.dylib> in the build directory, and the -library path is then adjusted during installation to point to the -installed library. - -L<[perl #126706]|https://rt.perl.org/Ticket/Display.html?id=126706>. - -=item Minix3 - -Some support for Minix3 has been re-added. - -=item Cygwin - -Cygwin doesn't make C<< cuserid >> visible. - -=item Win32 Mingw - -C99 math functions are now available. - -=item Windows +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 * - -The C<USE_CPLUSPLUS> build option which has long been available in -F<win32/Makefile> (for B<nmake>) and F<win32/makefile.mk> (for B<dmake>) is now -also available in F<win32/GNUmakefile> (for B<gmake>). - -=item * - -The B<nmake> makefile no longer defaults to Visual C++ 6.0 (a very old version -which is unlikely to be widely used today). As a result, it is now a -requirement to specify the C<CCTYPE> since there is no obvious choice of which -modern version to default to instead. Failure to specify C<CCTYPE> will result -in an error being output and the build will stop. +=item XXX-some-platform -(The B<dmake> and B<gmake> makefiles will automatically detect which compiler -is being used, so do not require C<CCTYPE> to be set. This feature has not yet -been added to the B<nmake> makefile.) +XXX -=item * - -C<sleep()> with warnings enabled for a C<USE_IMP_SYS> build no longer -warns about the sleep timeout being too large. -L<[perl #133376]|https://rt.perl.org/Ticket/Display.html?id=133376>. - -=item * +=back -Support for compiling perl on Windows using Microsoft Visual Studio 2019 -(containing Visual C++ 14.2) has been added. +=head2 Discontinued Platforms -=item * +XXX List any platforms that this version of perl no longer compiles on. -socket() now sets C<$!> if the protocol, address family and socket -type combination is not found. -L<[perl #133853]|https://rt.perl.org/Ticket/Display.html?id=133853>. +=over 4 -=item * +=item XXX-some-platform -The Windows Server 2003 SP1 Platform SDK build, with its early x64 compiler and -tools, was accidentally broken in Perl 5.27.9. This has now been fixed. +XXX =back -=back +=head2 Platform-Specific Notes -=head1 Internal Changes +XXX List any changes for specific platforms. This could include configuration +and compilation changes or changes in portability/compatibility. However, +changes within modules for platforms should generally be listed in the +L</Modules and Pragmata> section. =over 4 -=item * - -The sizing pass has been eliminated from the regular expression -compiler. An extra pass may instead be needed in some cases to count -the number of parenthetical capture groups. +=item XXX-some-platform -=item * - -A new function L<perlapi/C<my_strtod>> or its synonym, Strtod(), is -now available with the same signature as the libc strtod(). It provides -strotod() equivalent behavior on all platforms, using the best available -precision, depending on platform capabilities and F<Configure> options, -while handling locale-related issues, such as if the radix character -should be a dot or comma. +XXX -=item * - -Added C<newSVsv_nomg()> to copy a SV without processing get magic on -the source. -L<[perl #132964]|https://rt.perl.org/Ticket/Display.html?id=132964>. +=back -=item * +=head1 Internal Changes -It is now forbidden to malloc more than C<PTRDIFF_T_MAX> bytes. Much -code (including C optimizers) assumes that all data structures will not -be larger than this, so this catches such attempts before overflow -happens. +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. -=item * +[ List each change as an =item entry ] -Two new regnodes have been introduced C<< EXACT_ONLY8 >>, and -C<< EXACTFU_ONLY8 >>. They're equivalent to C<< EXACT >> and C<< EXACTFU >>, -except that they contain a code point which requires UTF-8 to -represent/match. Hence, if the target string isn't UTF-8, we know -it can't possibly match, without needing to try. +=over 4 =item * -C<< print_bytes_for_locale() >> is now defined if C<< DEBUGGING >>, -Prior, it didn't get defined unless C<< LC_COLLATE >> was defined -on the platform. +XXX =back =head1 Selected Bug Fixes -=over 4 - -=item * - -Compilation under C<-DPERL_MEM_LOG> and C<-DNO_LOCALE> have been fixed. - -=item * - -Perl 5.28 introduced an C<index()> optimization when comparing to -1 (or -indirectly, e.g. >= 0). When this optimization was triggered inside a C<when> -clause it caused a warning ("Argument %s isn't numeric in smart match"). This -has now been fixed. -L<[perl #133368]|https://rt.perl.org/Ticket/Display.html?id=133368> - -=item * - -The new in-place editing code no longer leaks directory handles. -L<[perl #133314]|https://rt.perl.org/Ticket/Display.html?id=133314>. - -=item * - -Warnings produced from constant folding operations on overloaded -values no longer produce spurious "Use of uninitialized value" -warnings. -L<[perl #132683]|https://rt.perl.org/Ticket/Display.html?id=132683>. - -=item * - -Fix for "mutator not seen in (lex = ...) .= ..." -L<[perl #133441]|https://rt.perl.org/Ticket/Display.html?id=133441>. - -=item * - -C<pack "u", "invalid uuencoding"> now properly NUL terminates the -zero-length SV produced. -L<[perl #132655]|https://rt.perl.org/Ticket/Display.html?id=132655>. - -=item * - -Improve the debugging output for calloc() calls with C<-Dm>. -L<[perl #133439]|https://rt.perl.org/Ticket/Display.html?id=133439>. - -=item * - -Regexp script runs were failing to permit ASCII digits in some cases. -L<[perl #133547]|https://rt.perl.org/Ticket/Display.html?id=133547>. - -=item * - -On Unix-like systems supporting a platform-specific technique for -determining L<< C<$^X>|perlvar/$^X >>, Perl failed to fall back to the -generic technique when the platform-specific one fails (for example, a Linux -system with /proc not mounted). This was a regression in Perl 5.28.0. -L<[perl #133573]|https://rt.perl.org/Ticket/Display.html?id=133573>. - -=item * - -L<SDBM_File> is now more robust with corrupt database files. The -improvements do not make SDBM files suitable as an interchange format. -L<[perl #132147]|https://rt.perl.org/Ticket/Display.html?id=132147>. - -=item * - -C<binmode($fh);> or C<binmode($fh, ':raw');> now properly removes the -C<:utf8> flag from the default C<:crlf> I/O layer on Win32. -L<[perl #133604]|https://rt.perl.org/Ticket/Display.html?id=133604>. - -=item * +XXX Important bug fixes in the core language are summarized here. Bug fixes in +files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>. -The experimental reference aliasing feature was misinterpreting array and -hash slice assignment as being localised, e.g. - - \(@a[3,5,7]) = \(....); - -was being interpreted as: - - local \(@a[3,5,7]) = \(....); - -L<[perl #133538]|https://rt.perl.org/Ticket/Display.html?id=133538>. - -=item * - -C<sort SUBNAME> within an C<eval EXPR> when C<EXPR> was UTF-8 upgraded -could panic if the C<SUBNAME> was non-ASCII. -L<[perl #134061]|https://rt.perl.org/Ticket/Display.html?id=134061>. - -=item * - -Correctly handle realloc() modifying C<errno> on success so that the -modification isn't visible to the perl user, since realloc() is called -implicitly by the interpreter. This modification is permitted by the -C standard, but has only been observed on FreeBSD 13.0-CURRENT. -L<[perl #133958]|https://rt.perl.org/Ticket/Display.html?id=133958>. - -=item * - -Perl now exposes POSIX C<getcwd> as C<Internals::getcwd()> if -available. This is intended for use by C<Cwd.pm> during bootstrapping -and may be removed or changed without notice. This fixes some -bootstrapping issues while building perl in a directory where some -ancestor directory isn't readable. -L<[perl #133951]|https://rt.perl.org/Ticket/Display.html?id=133951>. - -=item * - -C<pack()> no longer can return malformed UTF-8. It croaks if it would -otherwise return a UTF-8 string that contains malformed UTF-8. This -protects against potential security threats. -L<[perl #131642]|https://rt.perl.org/Ticket/Display.html?id=131642>. - -=item * - -See L</Any set of digits in the Common script are legal in a script run -of another script>. - -=item * - -Regular expression matching no longer leaves stale UTF-8 length magic -when updating C<$^R>. This could result in C<length($^R)> returning -an incorrect value. - -=item * - -Reduce recursion on ops -L<[perl #108276]|https://rt.perl.org/Ticket/Display.html?id=108276>. - -This can prevent stack overflow when processing extremely deep op -trees. - -=item * - -Avoid leak in multiconcat with overloading. -L<[perl #133789]|https://rt.perl.org/Ticket/Display.html?id=133789>. - -=item * - -The handling of user-defined C<\p{}> properties (see -L<perlunicode/User-Defined Character Properties>) has been rewritten to -be in C (instead of Perl). This speeds things up, but in the process -several inconsistencies and bug fixes are made. +[ List each fix as an =item entry ] =over 4 -=item 1 - -A few error messages have minor wording changes. This is essentially -because the new way is integrated into the regex error handling -mechanism that marks the position in the input at which the error -occurred. That was not possible previously. The messages now also -contain additional back-trace-like information in case the error occurs -deep in nested calls. - -=item 2 - -A user-defined property is implemented as a perl subroutine with certain -highly constrained naming conventions. It was documented previously -that the sub would be in the current package if the package was -unspecified. This turned out not to be true in all cases, but now it -is. - -=item 3 - -All recursive calls are treated as infinite recursion. Previously they -would cause the interpreter to panic. Now, they cause the regex pattern -to fail to compile. - -=item 4 - -Similarly, any other error likely would lead to a panic; now to just the -pattern failing to compile. - -=item 5 - -The old mechanism did not detect illegal ranges in the definition of the -property. Now, the range max must not be smaller than the range min. -Otherwise, the pattern fails to compile. - -=item 6 - -The intention was to have each sub called only once during the lifetime -of the program, so that a property's definition is immutable. This was -relaxed so that it could be called once for all /i compilations, and -potentially a second time for non-/i (the sub is passed a parameter -indicating which). However, in practice there were instances when this -was broken, and multiple calls were possible. Those have been fixed. -Now (besides the /i,non-/i cases) the only way a sub can be called -multiple times is if some component of it has not been defined yet. For -example, suppose we have sub IsA() whose definition is known at compile -time, and it in turn calls isB() whose definition is not yet known. -isA() will be called each time a pattern it appears in is compiled. If -isA() also calls isC() and that definition is known, isC() will be -called just once. - -=item 7 - -There were some races and very long hangs should one thread be compiling -the same property as another simultaneously. These have now been fixed. - -=back - =item * -Fixed a failure to match properly. - -An EXACTFish regnode has a finite length it can hold for the string -being matched. If that length is exceeded, a second node is used for -the next segment of the string, for as many regnodes as are needed. -Care has to be taken where to break the string, in order to deal -multi-character folds in Unicode correctly. If we want to break a -string at a place which could potentially be in the middle of a -multi-character fold, we back off one (or more) characters, leaving -a shorter EXACTFish regnode. This backing off mechanism contained -an off-by-one error. -L<[perl #133756]|https://rt.perl.org/Ticket/Display.html?id=133756>. - -=item * - -A bare C<eof> call with no previous file handle now returns true. -L<[perl #133721]|https://rt.perl.org/Ticket/Display.html?id=133721> - -=item * +XXX -Failing to compile a format now aborts compilation. Like other errors -in sub-parses this could leave the parser in a strange state, possibly -crashing perl if compilation continued. -L<[perl #132158]|https://rt.perl.org/Ticket/Display.html?id=132158> - -=item * - -If an in-place edit is still in progress during global destruction and -the process exit code (as stored in C<$?>) is zero, perl will now -treat the in-place edit as successful, replacing the input file with -any output produced. - -This allows code like: +=back - perl -i -ne 'print "Foo"; last' +=head1 Known Problems -to replace the input file, while code like: +XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any +tests that had to be C<TODO>ed for the release would be noted here. Unfixed +platform specific bugs also go here. - perl -i -ne 'print "Foo"; die' +[ List each fix as an =item entry ] -will not. Partly resolves -L<[perl #133659]|https://rt.perl.org/Ticket/Display.html?id=133659>. +=over 4 =item * -A regression in 5.28 caused the following code to fail - - close(STDIN); open(CHILD, "|wc -l")' +XXX -because the child's stdin would be closed on exec. This has now been fixed. - -=item * - -Fixed an issue where compiling a regexp containing both compile-time -and run-time code blocks could lead to trying to compile something -which is invalid syntax. +=back -=item * +=head1 Errata From Previous Releases -Fixed build failures with C<< -DNO_LOCALE_NUMERIC >> and -C<< -DNO_LOCALE_COLLATE >>. -L<[perl #133696]|https://rt.perl.org/Ticket/Display.html?id=133696>. +=over 4 =item * -Prevent the tests in F<< ext/B/t/strict.t >> from being skipped. -L<[perl #133713]|https://rt.perl.org/Ticket/Display.html?id=133713>. +XXX Add anything here that we forgot to add, or were mistaken about, in +the perldelta of a previous release. -=item * +=back -C<< /di >> nodes ending or beginning in I<s> are now C<< EXACTF >>. We do not -want two C<< EXACTFU >> to be joined together during optimization, -and to form a C<< ss >>, C<< sS >>, C<< Ss >> or C<< SS >> sequence; -they are the only multi-character sequences which may match differently -under C<< /ui >> and C<< /di >>. +=head1 Obituary -=back +XXX If any significant core contributor or member of the CPAN community has +died, add a short obituary here. =head1 Acknowledgements -Perl 5.30.0 represents approximately 11 months of development since Perl -5.28.0 and contains approximately 620,000 lines of changes across 1,300 -files from 58 authors. - -Excluding auto-generated files, documentation and release tools, there were -approximately 510,000 lines of changes to 750 .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.30.0: - -Aaron Crane, Abigail, Alberto Simões, Alexandr Savca, Andreas König, Andy -Dougherty, Aristotle Pagaltzis, Brian Greenfield, Chad Granum, Chris -'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Book, Dan -Dedrick, Daniel Dragan, Dan Kogai, David Cantrell, David Mitchell, Dominic -Hargreaves, E. Choroba, Ed J, Eugen Konkov, François Perrad, Graham Knop, -Hauke D, H.Merijn Brand, Hugo van der Sanden, Jakub Wilk, James Clarke, -James E Keenan, Jerry D. Hedden, Jim Cromie, John SJ Anderson, Karen -Etheridge, Karl Williamson, Leon Timmermans, Matthias Bethke, Nicholas -Clark, Nicolas R., Niko Tyni, Pali, Petr Písař, Phil Pearl (Lobbes), -Richard Leach, Ryan Voots, Sawyer X, Shlomi Fish, Sisyphus, Slaven Rezic, -Steve Hay, Sullivan Beck, Tina Müller, Tomasz Konojacki, Tom Wyant, Tony -Cook, Unicode Consortium, Yves Orton, Zak B. Elep. - -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 most of the (very much appreciated) contributors who reported -issues to the Perl bug tracker. Noteworthy in this release were the large -number of bug fixes made possible by Sergey Aleynikov's high quality perlbug -reports for issues he discovered by fuzzing with AFL. - -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<AUTHORS> file in the Perl source distribution. +XXX Generate this with: + + perl Porting/acknowledgements.pl v5.30.0..HEAD =head1 Reporting Bugs diff --git a/vms/descrip_mms.template b/vms/descrip_mms.template index cfdf01a2ed..29920574b2 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]perl5300delta.pod +PERLDELTA_CURRENT = [.pod]perl5301delta.pod $(PERLDELTA_CURRENT) : [.pod]perldelta.pod Copy/NoConfirm/Log $(MMS$SOURCE) $(PERLDELTA_CURRENT) diff --git a/win32/GNUmakefile b/win32/GNUmakefile index b3ea92119f..8376467acd 100644 --- a/win32/GNUmakefile +++ b/win32/GNUmakefile @@ -1762,7 +1762,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\perl5300delta.pod + copy ..\pod\perldelta.pod ..\pod\perl5301delta.pod $(MINIPERL) -I..\lib $(PL2BAT) $(UTILS) $(MINIPERL) -I..\lib ..\autodoc.pl .. $(MINIPERL) -I..\lib ..\pod\perlmodlib.PL -q .. @@ -1860,7 +1860,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 \ - perl5300delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ + perl5301delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ perlapi.pod perlbs2000.pod perlce.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 3c56be22f4..f1c7d1f61b 100644 --- a/win32/Makefile +++ b/win32/Makefile @@ -1283,7 +1283,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\perl5300delta.pod + copy ..\pod\perldelta.pod ..\pod\perl5301delta.pod cd ..\win32 $(PERLEXE) $(PL2BAT) $(UTILS) $(MINIPERL) -I..\lib ..\autodoc.pl .. @@ -1382,7 +1382,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 \ - perl5300delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ + perl5301delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ perlapi.pod perlbs2000.pod perlce.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.mk b/win32/makefile.mk index c014130bb1..0494bb509c 100644 --- a/win32/makefile.mk +++ b/win32/makefile.mk @@ -1679,7 +1679,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\perl5300delta.pod + copy ..\pod\perldelta.pod ..\pod\perl5301delta.pod $(MINIPERL) -I..\lib $(PL2BAT) $(UTILS) $(MINIPERL) -I..\lib ..\autodoc.pl .. $(MINIPERL) -I..\lib ..\pod\perlmodlib.PL -q .. @@ -1777,7 +1777,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 \ - perl5300delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ + perl5301delta.pod perlaix.pod perlamiga.pod perlandroid.pod \ perlapi.pod perlbs2000.pod perlce.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 77fda20349..e795ef221b 100644 --- a/win32/pod.mak +++ b/win32/pod.mak @@ -58,6 +58,7 @@ POD = perl.pod \ perl5281delta.pod \ perl5282delta.pod \ perl5300delta.pod \ + perl5301delta.pod \ perl561delta.pod \ perl56delta.pod \ perl581delta.pod \ @@ -211,6 +212,7 @@ MAN = perl.man \ perl5281delta.man \ perl5282delta.man \ perl5300delta.man \ + perl5301delta.man \ perl561delta.man \ perl56delta.man \ perl581delta.man \ @@ -364,6 +366,7 @@ HTML = perl.html \ perl5281delta.html \ perl5282delta.html \ perl5300delta.html \ + perl5301delta.html \ perl561delta.html \ perl56delta.html \ perl581delta.html \ @@ -517,6 +520,7 @@ TEX = perl.tex \ perl5281delta.tex \ perl5282delta.tex \ perl5300delta.tex \ + perl5301delta.tex \ perl561delta.tex \ perl56delta.tex \ perl581delta.tex \ |