X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/62ccb3663dda15008496bdae6114043fd0504f3e..0374b0a2a50c6e91951723a4d9ee1d7f534b03eb:/pod/perl5120delta.pod diff --git a/pod/perl5120delta.pod b/pod/perl5120delta.pod index b290bff..f8a1810 100644 --- a/pod/perl5120delta.pod +++ b/pod/perl5120delta.pod @@ -29,7 +29,7 @@ for C and similar constructs. E.g. There are several advantages to this: -=over +=over =item * @@ -117,7 +117,7 @@ Extension modules can now cleanly hook into the Perl parser to define new kinds of keyword-headed expression and compound statement. The syntax following the keyword is defined entirely by the extension. This allow a completely non-Perl sublanguage to be parsed inline, with the -correct ops cleanly generated. +correct ops cleanly generated. See L for the mechanism. The Perl core source distribution also includes a new module @@ -199,9 +199,9 @@ See the documentation for C or C for more on how to specify C when creating a distribution for CPAN. -=head2 C is now more flexible +=head2 C, C, C are now more flexible -The C function can now operate on arrays. +The C, C, C function can now operate on arrays. =head2 C as a statement modifier @@ -251,7 +251,7 @@ C file for that release. To disable this feature in a given lexical scope, you should use C For information about which language features are deprecated and explanations of various deprecation warnings, please -see L. See L below for the list of features +see L. See L below for the list of features and modules Perl's developers have deprecated as part of this release. =head2 Version number formats @@ -287,12 +287,11 @@ those installed in C and C. =head2 REGEXPs are now first class -Internally, Perl now treates compiled regular expressions (such as +Internally, Perl now treats compiled regular expressions (such as those created with C) as first class entities. Perl modules which serialize, deserialize or otherwise have deep interaction with Perl's -internal data structures need to be updated for this change. Affected -modules include L,L and L. - +internal data structures need to be updated for this change. Most +affected CPAN modules have already been updated as of this writing. =head2 Switch statement changes @@ -457,7 +456,6 @@ have been removed from this distribution. C no longer contains the C<%:patchlevel> hash. - =item * C now returns undef. @@ -495,6 +493,12 @@ EOF type. To better match all other flow control statements, C may no longer be used as an attribute. +=item * + +Perl's command-line switch "-P", which was deprecated in version 5.10.0, has +now been removed. The CPAN module C<< Filter::cpp >> can be used as an +alternative. + =back @@ -524,7 +528,6 @@ The following items are now deprecated: C is no longer part of Perl. It used to provide a mechanism to emulate setuid permission bits on systems that don't support it properly. - =item Use of C<:=> to mean an empty attribute list An accident of Perl's parser meant that these constructions were all @@ -556,7 +559,6 @@ The method C<< UNIVERSAL->import() >> is now deprecated. Attempting to pass import arguments to a C statement will result in a deprecation warning. - =item Use of "goto" to jump into a construct Using C to jump from an outer scope into an inner scope is now @@ -584,7 +586,7 @@ on CPAN which require these should add them to their prerequisites. The core versions of these modules warnings will issue a deprecation warning. If you ship a packaged version of Perl, either alone or as part of a -larger system, then you should carefully consider the reprecussions of +larger system, then you should carefully consider the repercussions of core module deprecations. You may want to consider shipping your default build of Perl with packages for some or all deprecated modules which install into C or C perl library directories. This will @@ -598,6 +600,10 @@ installation of a single package provides the given functionality, to a later release where the system administrator needs to know to install multiple packages to get that same functionality. +You can silence these deprecation warnings by installing the modules +in question from CPAN. To install the latest version of all of them, +just install C. + =over =item L @@ -638,7 +644,14 @@ F, F, F, F, F, F, F, F, F, F, F, F, F, F, F, F, F, F, and -F are all now deprecated. Using them will incur a warning. +F are all now deprecated. Earlier, Perl's developers +intended to remove these libraries from Perl's core for the 5.14.0 release. + +During final testing before the release of 5.12.0, several developers +discovered current production code using these ancient libraries, some +inside the Perl core itself. Accordingly, the pumpking granted them +a stay of execution. They will begin to warn about their deprecation +in the 5.14.0 release and will be removed in the 5.16.0 release. =back @@ -1417,7 +1430,6 @@ the beginnings of a document on Perl porting policies. =over - =item * The various large F files (which listed every change made @@ -1431,7 +1443,6 @@ F has been deleted, as it mainly described interacting with the old Perforce-based repository, which is now obsolete. Information still relevant has been moved to L. - =item * The syntax C is now documented as valid, @@ -1439,7 +1450,6 @@ as is the syntax C, although actually using the latter may not be the best idea for the readability of your source code. - =item * Documented -X overloading. @@ -1499,7 +1509,7 @@ The documentation for C<$1> in perlvar.pod has been clarified. =item * -C<\N{U+I}> is now documented. +C<\N{U+I}> is now documented. =back @@ -1634,7 +1644,7 @@ and proper citations added, thanks to a patch from Tom Christiansen. =item * The internal structure of the dual-life modules traditionally found in -the F and F directories y in the perl source has changed +the F and F directories in the perl source has changed significantly. Where possible, dual-lifed modules have been extracted from F and F. @@ -1650,8 +1660,8 @@ C<\N{...}> now compiles better, always forces UTF-8 internal representation Perl's developers have fixed several problems with the recognition of C<\N{...}> constructs. As part of this, perl will store any scalar -or regex containing C<\N{I}> or C<\N{U+I}> in its -definition in UTF-8 format. (This was true previously for all occurences +or regex containing C<\N{I}> or C<\N{U+I}> in its +definition in UTF-8 format. (This was true previously for all occurrences of C<\N{I}> that did not use a custom translator, but now it's always true.) @@ -2069,7 +2079,7 @@ because it's beyond the limit of representation. This uses a new warnings category: "imprecision". -=item * +=item * C, C, C, and C warn when passed undef. @@ -2090,7 +2100,6 @@ passed a position that is not within the scalar's string buffer. This could be caused by buggy XS code, and at this point recovery is not possible. - =item * The fatal error C is now produced if the @@ -2308,7 +2317,7 @@ to gcc's search path. =item * F no longer incorrectly treats enum values like macros. -It also now handles C++ style comments (C) properly in enums. +It also now handles C++ style comments (C) properly in enums. =item * @@ -3019,6 +3028,14 @@ from either 5.10.x or 5.8.x. =item * +Some CPANPLUS tests may fail if there is a functioning file +F<../../cpanp-run-perl> outside your build directory. The failure +shouldn't imply there's a problem with the actual functional +software. The bug is already fixed in [RT #74188] and is scheduled for +inclusion in perl-v5.12.1. + +=item * + C misbehaves in the presence of a lexical C<$_> (typically introduced by C or implicitly by C). The variable which gets set for each iteration is the package variable C<$_>, not the @@ -3152,7 +3169,8 @@ analyzed 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 please send it to perl5-security-report@perl.org. This points to a closed subscription -unarchived mailing list, which includes all the core committers, who be able +unarchived mailing list, which includes +all the core committers, who will be able to help assess the impact of issues, figure out a resolution, and help co-ordinate the release of patches to mitigate or fix the problem across all platforms on which Perl is supported. Please only use this address for @@ -3170,4 +3188,8 @@ The F file for general stuff. The F and F files for copyright information. +L for a list of issues +found after this release, as well as a list of CPAN modules known +to be incompatible with this release. + =cut