In perl.git, the branch blead has been updated <http://perl5.git.perl.org/perl.git/commitdiff/7c825fcad57027ee06ac8c734df998f50937ce57?hp=2c4393cceb72ac358b1127131a605f20eb3e7588>
- Log ----------------------------------------------------------------- commit 7c825fcad57027ee06ac8c734df998f50937ce57 Author: Karl Williamson <[email protected]> Date: Sat May 20 21:41:42 2017 -0600 perldelta: Add a C<> formatting code. M pod/perldelta.pod commit b10de59c4daa1cc55b63aa6d28f9b97c47d4cd99 Author: Karl Williamson <[email protected]> Date: Sat May 20 21:38:10 2017 -0600 perldelta: Cleanup documentation changes section I looked at all the files in /pod for their changes since 5.24. I think this action should be added to the RMG. I removed the changes that are described elswhere in perldelta, adding boiler plate to that effect. I removed the changes I thought would not be useful for someone reading this, but added significant numbers of substantive changes that had been omitted. M pod/perldelta.pod commit 1f81bc188d3574dfda690659ebeed2bdc92a42d6 Author: Karl Williamson <[email protected]> Date: Sat May 20 21:36:16 2017 -0600 perldelta: Add a section for undeprecations and populate it. M pod/perldelta.pod commit 8b70433fb674b1a2c48fde64317866d982d51e5d Author: Karl Williamson <[email protected]> Date: Sat May 20 21:31:57 2017 -0600 perldelta: Note that utf8_hop_safe is for XS code I actually don't think this should be here. I think it should be in Internal Changes. Note that there were a bunch more functions added for XS code, and these are there. Perhaps there should be some separate sections there, with one for enhancements. M pod/perldelta.pod ----------------------------------------------------------------------- Summary of changes: pod/perldelta.pod | 185 +++++++++++++++++------------------------------------- 1 file changed, 57 insertions(+), 128 deletions(-) diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 85f863acae..829b3a2bc9 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -168,7 +168,7 @@ be called with ampersand syntax (C<&CORE::keys(\%hash>) and via reference (C<< my $k = \&CORE::keys; $k-E<gt>(\%hash) >>). Previously they could only be used when inlined. -=head2 create a safer utf8_hop() called utf8_hop_safe() +=head2 for XS code, create a safer utf8_hop() called utf8_hop_safe() Unlike utf8_hop(), utf8_hop_safe() won't navigate before the beginning or after the end of the supplied buffer. @@ -473,6 +473,15 @@ delimiter that isn't a grapheme by itself. These are unlikely to exist in actual code, as they would typically display as attached to the character in front of them. +=head1 Removed Deprecations + +The C<\cI<X>> construct is intended to be a way to specify non-printable +characters. Previously it was deprecated to use it for a printable one, +which is better written as simply itself, perhaps preceded by a +backslash for non-word characters. Now this raises a warning, but not a +deprecation. See +L<http://www.nntp.perl.org/group/perl.perl5.porters/2017/02/msg242944.html>. + =head1 Performance Enhancements =over 4 @@ -1163,126 +1172,91 @@ work after an upgrade of their perl. =head2 Changes to Existing Documentation -=head3 L<perlcall> - -=over 4 +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<mailto:[email protected]>. -=item * +Additionally all references to Usenet have been removed, and the +following selected changes have been made: -Use of unassigned code point or non-standalone grapheme for a delimiter will be a fatal error starting in Perl 5.30 +=head3 L<perlfunc> -This was changed to drop a leading C<v> in C<v5.30>, so it uses the same -style as other deprecation messages. +=over 4 =item * -"\c%c" is more clearly written simply as "%s". - -It was decided to undeprecate the use of C<\c%c>, see L<http://www.nntp.perl.org/group/perl.perl5.porters/2017/02/msg242944.html> +Removed obsolete text about L<C<defined()>|perlfunc/defined> +on aggregates that should have been deleted earlier, when the feature +was removed. =item * -Removed redundant C<dSP> from an example. - -=back - -=head3 L<perlcommunity> - -=over 4 +Corrected documentation of L<C<eval()>|perlfunc/eval>, +and L<C<evalbytes()>|perlfunc/evalbytes>. =item * -All references to Usenet have been removed. - -=back - -=head3 L<perldata> - -=over 4 +Clarified documentation of L<C<seek()>|perlfunc/seek>, +L<C<tell()>|perlfunc/tell> and L<C<sysseek()>|perlfunc/sysseek> +regarding that positions are in bytes vs. characters. +L<[perl #128607]|https://rt.perl.org/Public/Bug/Display.html?id=128607> =item * -Updated documentation of C<scalar(%hash)>. See L</scalar(%hash) return -signature changed> above. +Clarified documentation of L<C<sort()>|perlfunc/sort LIST> concerning +the variables C<$a> and C<$b>. =item * -Use of single character variables, with the variable name a non printable -character in the range C<\x80>-C<\xFF> is no longer allowed. Update the docs to -reflect this. - -=back - -=head3 L<perldelta> - -=over 4 +In L<C<split()>|perlfunc/split> added a caution about its use in Perls +before 5.11, and noted that certain pattern modifiers are legal in it. =item * -All references to Usenet have been removed. - -=back - -=head3 L<perldiag> - -=over 4 +Removed obsolete documentation of L<C<study()>|perlfunc/study>, noting +that it is now a no-op. =item * -Deprecations are to be marked with a D. -C<"%s() is deprecated on :utf8 handles"> use a deprecation message, and as -such, such be marked C<"(D deprecated)"> and not C<"(W deprecated)">. +Noted that L<C<vec()>|perlfunc/vec> doesn't work well when the string +contains characters whose code points are above 255. =back -=head3 L<perlexperiment> +=head3 L<perlguts> =over 4 =item * -Documented new feature: See L</Declaring a reference to a variable> above. +Added advice on +L<formatted printing of operands of C<Size_t> and C<SSize_t>|perlguts/Formatted Printing of Size_t and SSize_t> =back -=head3 L<perlfunc> +=head3 L<perlhack> =over 4 =item * -Defined on aggregates is no longer allowed. Perlfunc was still reporting it as -deprecated, and that it will be deleted in the future. - -=item * - -Clarified documentation of L<C<seek()>|perlfunc/seek>, -L<C<tell()>|perlfunc/tell> and L<C<sysseek()>|perlfunc/sysseek>. -L<[perl #128607]|https://rt.perl.org/Public/Bug/Display.html?id=128607> - -=item * - -Removed obsolete documentation of L<C<study()>|perlfunc/study>. +Clariy indentation rules, and note that we are migrating away from using +tabs to indent, replacing them with sequences of SPACE characters. =back -=head3 L<perlguts> +=head3 L<perlhacktips> =over 4 =item * -Add C<pTHX_> to magic method examples. - -=back - -=head3 L<perlhack> - -=over 4 +Give another reason to use C<cBOOL> to cast an expression to boolean. =item * -Document Tab VS Space. +Note that there are macros C<TRUE> and C<FALSE> available to express +boolean values. =back @@ -1301,14 +1275,8 @@ hunt around in the parser for how a given operator is handled. =over 4 -=item * - -Document C<NUL> collation handling. - -=item * - -Some locales aren't compatible with Perl. Note the potential bad -consequences of using them. +Some locales aren't compatible with Perl. Note that these can cause +core dumps. =back @@ -1318,7 +1286,7 @@ consequences of using them. =item * -All references to Usenet have been removed. +Various clarifications have been added. =back @@ -1328,21 +1296,7 @@ All references to Usenet have been removed. =item * -Updated the mirror list. - -=item * - -All references to Usenet have been removed. - -=back - -=head3 L<perlnewmod> - -=over 4 - -=item * - -All references to Usenet have been removed. +Updated the site mirror list. =back @@ -1366,10 +1320,6 @@ Do not discourage manual @ISA. =item * -Tidy the document. - -=item * - Mention C<Moo> more. =back @@ -1394,38 +1344,24 @@ The first part was extensively rewritten to incorporate various basic points, that in earlier versions were mentioned in sort of an appendix on Version 8 regular expressions. -Several minor enhancements to the documentation. - -=back - -=head3 L<perlsec> - -=over 4 - -=item * - -Fixed link to Crosby paper on hash complexity attack. +Note that it is common to have the C</x> modifier and forget that this +means that C<"#"> has to be escaped. =back -=head3 L<perlref> +=head3 L<perlretut> =over 4 =item * -Documented new feature: See L</Declaring a reference to a variable> above. - -=back - -=head3 L<perltie> - -=over 4 +Add introductory material =item * -Updated documentation of C<scalar(%hash)>. See L</scalar(%hash) return -signature changed> above. +Note that a metacharacter occurring in a context where it can't mean +that, silently loses its meta-ness and matches literally. +L<C<use re 'strict'>|re/'strict' mode> can catch some of these. =back @@ -1435,9 +1371,7 @@ signature changed> above. =item * -Documented change to C<\p{I<script>}> to now use the improved Script_Extensions -property. See L</Use of \p{script} uses the improved Script_Extensions -property> above. +Corrected the text about Unicode BYTE ORDER MARK handling. =item * @@ -1452,11 +1386,6 @@ regular expressions, and Perl compatibility with what it says. =item * -Removed obsolete documentation of C<${^ENCODING}>. See L</${^ENCODING} has -been removed> above. - -=item * - Document C<@ISA>. Was documented other places, not not in L<perlvar>. =back @@ -3111,7 +3040,7 @@ 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 [email protected] to be analysed by the Perl porting team. +will be sent off to C<[email protected]> 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 -- Perl5 Master Repository
