In perl.git, the branch rjbs/perldelta has been updated <http://perl5.git.perl.org/perl.git/commitdiff/765d5fa885eceedc23951770fd3f4ceba8d9cc48?hp=854d109c16e4a94f23c420ba8bc726d7bf50cdf4>
- Log ----------------------------------------------------------------- commit 765d5fa885eceedc23951770fd3f4ceba8d9cc48 Author: Ricardo Signes <[email protected]> Date: Sun Apr 26 19:56:48 2015 -0400 perldelta: combine and sort the various perldoc updates M Porting/perl5220delta.pod commit 653c70b997bbb238d18535ec84075692bbb69869 Author: Ricardo Signes <[email protected]> Date: Sun Apr 26 18:35:32 2015 -0400 perldelta: minor reordering of optimizations M Porting/perl5220delta.pod commit dbdfa15452cd96e2869bcb34fbed69b491f3521d Author: Ricardo Signes <[email protected]> Date: Sun Apr 26 18:29:29 2015 -0400 perldelta: remove modules-to-be-removed section I do not think we will be needing it either. M Porting/perl5220delta.pod commit 32a6aae6be5943371697f80b92d765c68a9fc795 Author: Ricardo Signes <[email protected]> Date: Sun Apr 26 18:27:04 2015 -0400 perldelta: remove Notice section I do not think we will be needing it. M Porting/perl5220delta.pod ----------------------------------------------------------------------- Summary of changes: Porting/perl5220delta.pod | 341 ++++++++++++---------------------------------- 1 file changed, 90 insertions(+), 251 deletions(-) diff --git a/Porting/perl5220delta.pod b/Porting/perl5220delta.pod index 8181d1c..db55f05 100644 --- a/Porting/perl5220delta.pod +++ b/Porting/perl5220delta.pod @@ -12,10 +12,6 @@ release. If you are upgrading from an earlier release such as 5.18.0, first read L<perl5200delta>, which describes differences between 5.18.0 and 5.20.0. -=head1 Notice - -XXX Any important notices here - =head1 Core Enhancements =head2 New bitwise operators @@ -267,7 +263,6 @@ Note that this isn't necessarily a huge step since in many platforms the step had already been taken several years ago: many Linux distributions (like Fedora) have been using this option for Perl, and OS X has enforced the same for many years. -[ List each security issue as a =head2 entry ] =head1 Incompatible Changes @@ -518,45 +513,12 @@ The documentation for L<fatal warnings|warnings/Fatal Warnings> notes that C<< use warnings FATAL => 'all' >> is discouraged and provides stronger language about the risks of fatal warnings in general. -=head2 Module removals - -XXX Remove this section if inapplicable. - -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 - -=item XXX - -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 Performance Enhancements =over 4 =item * -Win32 Perl uses 8 KB less of per-process memory than before for every perl -process of this version. This data is now memory mapped from disk and shared -between perl processes from the same perl binary. - -=item * - If method and class names are known at compile time, hashes are precomputed to speed up run-time method lookup. Also, compound method names like C<SUPER::new> are parsed at compile time, to save having to parse them at @@ -692,6 +654,11 @@ The functions C<utf8::native_to_unicode()> and C<utf8::unicode_to_native()> a minimal performance hit in writing code portable between ASCII and EBCDIC platforms. +=item * + +Win32 Perl uses 8 KB less of per-process memory than before for every perl +process of this version. This data is now memory mapped from disk and shared +between perl processes from the same perl binary. =back @@ -746,214 +713,143 @@ Perl. =head2 Changes to Existing Documentation -=head3 L<perlebcdic> +=head3 L<perlapi> =over 4 =item * -This document has been significantly updated in the light of recent -improvements to EBCDIC support. - -=back - -=head3 L<perlfunc> - -=over 4 +Note that C<SvSetSV> doesn't do set magic. =item * -Mention that C<study()> is currently a no-op. - -=back - -=head3 L<perlguts> +C<sv_usepvn_flags> - Fix documentation to mention the use of C<NewX> instead of +C<malloc>. -=over 4 +L<[perl #121869]|https://rt.perl.org/Ticket/Display.html?id=121869> =item * -The OOK example has been updated to account for COW changes and a change in the -storage of the offset. - -=back - -=head3 L<perlhacktips> - -=over 4 +Clarify where C<NUL> may be embedded or is required to terminate a string. =item * -Documentation has been added illustrating the perils of assuming the contents -of static memory pointed to by the return values of Perl wrappers for C library -functions doesn't change. - -=back - -=head3 L<perlport> - -=over 4 +Previously missing documentation due to formatting errors are now included. =item * -Out-of-date VMS-specific information has been fixed/simplified. - -=back - -=head3 L<perluniintro> - -=over 4 +Entries are now organized into groups rather than by file where they are found. =item * -Advice for how to make sure your strings and regular expression patterns are -interpreted as Unicode has been revised to account for the new Perl 5.22 EBCDIC -handling. +Alphabetical sorting of entries is now handled by the POD generator to make +entries easier to find when scanning. =back -=head3 L<perlvms> +=head3 L<perldata> =over 4 =item * -Out-of-date and/or incorrect material has been removed. +The syntax of single-character variable names has been brought +up-to-date and more fully explained. =back - -=head3 L<perlunicode> +=head3 L<perlebcdic> =over 4 =item * -Update B<Default Word Boundaries> under -L<perlunicode/"Unicode Regular Expression Support Level">'s -B<Extended Unicode Support>. +This document has been significantly updated in the light of recent +improvements to EBCDIC support. =back -=head3 L<perlunicook> +=head3 L<perlfunc> =over 4 =item * -Clarify that autodie E<gt>= 2.26 works with C<use open>. +Mention that C<study()> is currently a no-op. =item * -Correct warning message for C<use autodie> and C<use open>. - -=back - -=head3 L<perlfaq> - -=over 4 +Calling C<delete> or C<exists> on array values is now described as "strongly +discouraged" rather than "deprecated". =item * -L<perlfaq> has been synchronized with version 5.021009 from CPAN. - -=back - -=head3 L<perlop> - -=over 4 +Improve documentation of C<< our >>. =item * -Correct the version number which removes C<m?PATTERN?>. It was Perl 5.22.0. - -=back - -=head3 L<perlvar> +C<-l> now notes that it will return false if symlinks aren't supported by the +file system. -=over 4 +L<[perl #121523]|https://rt.perl.org/Ticket/Display.html?id=121523> =item * -Further clarify version number representations and usage. - -=back - -=head3 L<perlmodstyle> - -=over 4 +Note that C<exec LIST> and C<system LIST> may fall back to the shell on +Win32. Only C<exec PROGRAM LIST> and C<system PROGRAM LIST> indirect object +syntax will reliably avoid using the shell. -=item * +This has also been noted in L<perlport>. -Instead of pointing to the module list, we are now pointing to -L<PrePAN|http://prepan.org/>. +L<[perl #122046]|https://rt.perl.org/Ticket/Display.html?id=122046> =back -=head3 L<perlrebackslash> +=head3 L<perlguts> =over 4 =item * -Added documentation of C<\b{sb}>, C<\b{wb}>, C<\b{gcb}>, and C<\b{g}>. - -=back - -=head3 L<perlrequick> - -=over 4 +The OOK example has been updated to account for COW changes and a change in the +storage of the offset. =item * -Added example for C<\b{wb}>. +Details on C level symbols and libperl.t added. =back -=head3 L<perlretut> +=head3 L<perlhacktips> =over 4 =item * -Added example for C<\b{wb}>. - -=back - -=head3 L<perldata/Identifier parsing> - -=over 4 +Documentation has been added illustrating the perils of assuming the contents +of static memory pointed to by the return values of Perl wrappers for C library +functions doesn't change. =item * -The syntax of single-character variable names has been brought -up-to-date and more fully explained. - -=back - -=head3 L<perlrecharclass> - -=over 4 +Recommended replacements for tmpfile, atoi, strtol, and strtoul added. =item * -Clarifications have been added to L<perlrecharclass/Character Ranges> -to the effect that Perl guarantees that C<[A-Z]>, C<[a-z]>, C<[0-9]> and -any subranges thereof in regular expression bracketed character classes -are guaranteed to match exactly what a naive English speaker would -expect them to match, even on platforms (such as EBCDIC) where special -handling is required to accomplish this. +Updated documentation for the C<test.valgrind> C<make> target. + +L<[perl #121431]|https://rt.perl.org/Ticket/Display.html?id=121431> =back -=head3 L<perlfunc> +=head3 L<perlmodstyle> =over 4 =item * -Calling C<delete> or C<exists> on array values is now described as "strongly -discouraged" rather than "deprecated". +Instead of pointing to the module list, we are now pointing to +L<PrePAN|http://prepan.org/>. =back @@ -963,70 +859,64 @@ discouraged" rather than "deprecated". =item * -The conditions for marking an experimental feature as non-experimental are now -set out. - -=back - -=head3 L<perlrecharclass> - -=over 4 +We now have a code of conduct for the I<< p5p >> mailing list, as documented +in L<< perlpolicy/STANDARDS OF CONDUCT >>. =item * -The documentation of Bracketed Character Classes has been expanded to cover the -improvements in C<qr/[\N{named sequence}]/> (see under L</Selected Bug Fixes>). +The conditions for marking an experimental feature as non-experimental are now +set out. =back -=head3 L<perlsyn> +=head3 L<perlport> =over 4 =item * -An ambiguity in the documentation of the Ellipsis statement has been corrected. -L<[perl #122661]|https://rt.perl.org/Ticket/Display.html?id=122661> +Out-of-date VMS-specific information has been fixed/simplified. =back -=head3 L<perlxs> +=head3 L<perlre> =over 4 =item * -Added a discussion of locale issues in XS code. +The C</x> modifier has been clarified to note that comments cannot be continued +onto the next line by escaping them. =back -=head3 L<perlguts> +=head3 L<perlrebackslash> =over 4 =item * -Details on C level symbols and libperl.t added. +Added documentation of C<\b{sb}>, C<\b{wb}>, C<\b{gcb}>, and C<\b{g}>. =back -=head3 L<perlhacktips> +=head3 L<perlrecharclass> =over 4 =item * -Recommended replacements for tmpfile, atoi, strtol, and strtoul added. - -=back - -=head3 L<perlop> - -=over 4 +Clarifications have been added to L<perlrecharclass/Character Ranges> +to the effect that Perl guarantees that C<[A-Z]>, C<[a-z]>, C<[0-9]> and +any subranges thereof in regular expression bracketed character classes +are guaranteed to match exactly what a naive English speaker would +expect them to match, even on platforms (such as EBCDIC) where special +handling is required to accomplish this. =item * -ASCII v. EBCDIC clarifications added. +The documentation of Bracketed Character Classes has been expanded to cover the +improvements in C<qr/[\N{named sequence}]/> (see under L</Selected Bug Fixes>). =back @@ -1040,132 +930,81 @@ Comments added on algorithmic complexity and tied hashes. =back -=head3 L<perlvms> - -=over 4 - -=item * - -Updated documentation on environment and shell interaction in VMS. - -=back - -=head3 L<perlfunc> +=head3 L<perlsyn> =over 4 =item * -Improve documentation of C<< our >>. - -=item * - -C<-l> now notes that it will return false if symlinks aren't supported by the -file system. - -L<[perl #121523]|https://rt.perl.org/Ticket/Display.html?id=121523> +An ambiguity in the documentation of the C<...> statement has been corrected. +L<[perl #122661]|https://rt.perl.org/Ticket/Display.html?id=122661> =item * -Note that C<exec LIST> and C<system LIST> may fall back to the shell on -Win32. Only C<exec PROGRAM LIST> and C<system PROGRAM LIST> indirect object -syntax will reliably avoid using the shell. - -This has also been noted in L<perlport>. - -L<[perl #122046]|https://rt.perl.org/Ticket/Display.html?id=122046> +The empty conditional in C<< for >> and C<< while >> is now documented +in L<< perlsyn >>. =back -=head3 L<perlapi> +=head3 L<perlunicode> =over 4 =item * -Note that C<SvSetSV> doesn't do set magic. - -=item * - -C<sv_usepvn_flags> - Fix documentation to mention the use of C<NewX> instead of -C<malloc>. - -L<[perl #121869]|https://rt.perl.org/Ticket/Display.html?id=121869> - -=item * - -Clarify where C<NUL> may be embedded or is required to terminate a string. - -=item * - -Previously missing documentation due to formatting errors are now included. - -=item * - -Entries are now organized into groups rather than by file where they are found. - -=item * - -Alphabetical sorting of entries is now handled by the POD generator to make -entries easier to find when scanning. +Update B<Default Word Boundaries> under +L<perlunicode/"Unicode Regular Expression Support Level">'s +B<Extended Unicode Support>. =back -=head3 L<perlhacktips> +=head3 L<perluniintro> =over 4 =item * -Updated documentation for the C<test.valgrind> C<make> target. - -L<[perl #121431]|https://rt.perl.org/Ticket/Display.html?id=121431> +Advice for how to make sure your strings and regular expression patterns are +interpreted as Unicode has been revised to account for the new Perl 5.22 EBCDIC +handling. =back -=head3 L<perlre> +=head3 L<perlvar> =over 4 =item * -The C</x> modifier has been clarified to note that comments cannot be continued -onto the next line by escaping them. +Further clarify version number representations and usage. =back -=head3 L<< perlpolicy >> +=head3 L<perlvms> =over 4 =item * -We now have a code of conduct for the I<< p5p >> mailing list, as documented -in L<< perlpolicy/STANDARDS OF CONDUCT >>. - -=back - -=head3 L<< perlsyn >> - -=over 4 +Out-of-date and/or incorrect material has been removed. =item * -The empty conditional in C<< for >> and C<< while >> is now documented -in L<< perlsyn >>. +Updated documentation on environment and shell interaction in VMS. =back -=head3 L<Unicode::UCD> +=head3 L<perlxs> =over 4 =item * -The documentation includes many clarifications and fixes. +Added a discussion of locale issues in XS code. =back + =head1 Diagnostics The following additions or changes have been made to diagnostic output, -- Perl5 Master Repository
