perl5280delta - Man Page

what is new for perl v5.28.0

Description

This document describes differences between the 5.26.0 release and the 5.28.0 release.

If you are upgrading from an earlier release such as 5.24.0, first read perl5260delta, which describes differences between 5.24.0 and 5.26.0.

Core Enhancements

Unicode 10.0 is supported

A list of changes is at <http://www.unicode.org/versions/Unicode10.0.0>.

delete on key/value hash slices

delete can now be used on key/value hash slices, returning the keys along with the deleted values. [perl #131328] <https://rt.perl.org/Ticket/Display.html?id=131328>

Experimentally, there are now alphabetic synonyms for some regular expression assertions

If you find it difficult to remember how to write certain of the pattern assertions, there are now alphabetic synonyms.

 CURRENT                NEW SYNONYMS
 ------                 ------------
 (?=...)        (*pla:...) or (*positive_lookahead:...)
 (?!...)        (*nla:...) or (*negative_lookahead:...)
 (?<=...)       (*plb:...) or (*positive_lookbehind:...)
 (?<!...)       (*nlb:...) or (*negative_lookbehind:...)
 (?>...)        (*atomic:...)

These are considered experimental, so using any of these will raise (unless turned off) a warning in the experimental::alpha_assertions category.

Mixed Unicode scripts are now detectable

A mixture of scripts, such as Cyrillic and Latin, in a string is often the sign of a spoofing attack.  A new regular expression construct now allows for easy detection of these.  For example, you can say

 qr/(*script_run: \d+ \b )/x

And the digits matched will all be from the same set of 10.  You won't get a look-alike digit from a different script that has a different value than what it appears to be.

Or:

 qr/(*sr: \b \w+ \b )/x

makes sure that all the characters come from the same script.

You can also combine script runs with (?>...) (or *atomic:...)).

Instead of writing:

    (*sr:(?<...))

you can now run:

    (*asr:...)
    # or
    (*atomic_script_run:...)

This is considered experimental, so using it will raise (unless turned off) a warning in the experimental::script_run category.

See “Script Runs” in perlre.

In-place editing with perl -i is now safer

Previously in-place editing (perl -i) would delete or rename the input file as soon as you started working on a new file.

Without backups this would result in loss of data if there was an error, such as a full disk, when writing to the output file.

This has changed so that the input file isn't replaced until the output file has been completely written and successfully closed.

This works by creating a work file in the same directory, which is renamed over the input file once the output file is complete.

Incompatibilities:

  • Since this renaming needs to only happen once, if you create a thread or child process, that renaming will only happen in the original thread or process.
  • If you change directories while processing a file, and your operating system doesn't provide the unlinkat(), renameat() and fchmodat() functions, the final rename step may fail.

[perl #127663] <https://rt.perl.org/Public/Bug/Display.html?id=127663>

Initialisation of aggregate state variables

A persistent lexical array or hash variable can now be initialized, by an expression such as state @a = qw(x y z).  Initialization of a list of persistent lexical variables is still not possible.

Full-size inode numbers

On platforms where inode numbers are of a type larger than perl's native integer numerical types, stat will preserve the full content of large inode numbers by returning them in the form of strings of decimal digits.  Exact comparison of inode numbers can thus be achieved by comparing with eq rather than ==.  Comparison with ==, and other numerical operations (which are usually meaningless on inode numbers), work as well as they did before, which is to say they fall back to floating point, and ultimately operate on a fairly useless rounded inode number if the real inode number is too big for the floating point format.

The sprintf %j format size modifier is now available with pre-C99 compilers

The actual size used depends on the platform, so remains unportable.

Close-on-exec flag set atomically

When opening a file descriptor, perl now generally opens it with its close-on-exec flag already set, on platforms that support doing so. This improves thread safety, because it means that an exec initiated by one thread can no longer cause a file descriptor in the process of being opened by another thread to be accidentally passed to the executed program.

Additionally, perl now sets the close-on-exec flag more reliably, whether it does so atomically or not.  Most file descriptors were getting the flag set, but some were being missed.

String- and number-specific bitwise ops are no longer experimental

The new string-specific (&. |. ^. ~.) and number-specific (& | ^ ~) bitwise operators introduced in Perl 5.22 that are available within the scope of use feature 'bitwise' are no longer experimental. Because the number-specific ops are spelled the same way as the existing operators that choose their behaviour based on their operands, these operators must still be enabled via the “bitwise” feature, in either of these two ways:

    use feature "bitwise";

    use v5.28; # "bitwise" now included

They are also now enabled by the -E command-line switch.

The “bitwise” feature no longer emits a warning.  Existing code that disables the “experimental::bitwise” warning category that the feature previously used will continue to work.

One caveat that module authors ought to be aware of is that the numeric operators now pass a fifth TRUE argument to overload methods.  Any methods that check the number of operands may croak if they do not expect so many. XS authors in particular should be aware that this:

    SV *
    bitop_handler (lobj, robj, swap)

may need to be changed to this:

    SV *
    bitop_handler (lobj, robj, swap, ...)

Locales are now thread-safe on systems that support them

These systems include Windows starting with Visual Studio 2005, and in POSIX 2008 systems.

The implication is that you are now free to use locales and change them in a threaded environment.  Your changes affect only your thread. See “Multi-threaded operation” in perllocale

New read-only predefined variable ${^SAFE_LOCALES}

This variable is 1 if the Perl interpreter is operating in an environment where it is safe to use and change locales (see perllocale.)  This variable is true when the perl is unthreaded, or compiled in a platform that supports thread-safe locale operation (see previous item).

Security

[CVE-2017-12837] Heap buffer overflow in regular expression compiler

Compiling certain regular expression patterns with the case-insensitive modifier could cause a heap buffer overflow and crash perl.  This has now been fixed. [perl #131582] <https://rt.perl.org/Public/Bug/Display.html?id=131582>

[CVE-2017-12883] Buffer over-read in regular expression parser

For certain types of syntax error in a regular expression pattern, the error message could either contain the contents of a random, possibly large, chunk of memory, or could crash perl.  This has now been fixed. [perl #131598] <https://rt.perl.org/Public/Bug/Display.html?id=131598>

[CVE-2017-12814] $ENV{$key} stack buffer overflow on Windows

A possible stack buffer overflow in the %ENV code on Windows has been fixed by removing the buffer completely since it was superfluous anyway. [perl #131665] <https://rt.perl.org/Public/Bug/Display.html?id=131665>

Default Hash Function Change

Perl 5.28.0 retires various older hash functions which are not viewed as sufficiently secure for use in Perl. We now support four general purpose hash functions, Siphash (2-4 and 1-3 variants), and  Zaphod32, and StadtX hash. In addition we support SBOX32 (a form of tabular hashing) for hashing short strings, in conjunction with any of the other hash functions provided.

By default Perl is configured to support SBOX hashing of strings up to 24 characters, in conjunction with StadtX hashing on 64 bit builds, and Zaphod32 hashing for 32 bit builds.

You may control these settings with the following options to Configure:

    -DPERL_HASH_FUNC_SIPHASH
    -DPERL_HASH_FUNC_SIPHASH13
    -DPERL_HASH_FUNC_STADTX
    -DPERL_HASH_FUNC_ZAPHOD32

To disable SBOX hashing you can use

    -DPERL_HASH_USE_SBOX32_ALSO=0

And to set the maximum length to use SBOX32 hashing on with:

    -DSBOX32_MAX_LEN=16

The maximum length allowed is 256. There probably isn't much point in setting it higher than the default.

Incompatible Changes

Subroutine attribute and signature order

The experimental subroutine signatures feature has been changed so that subroutine attributes must now come before the signature rather than after. This is because attributes like :lvalue can affect the compilation of code within the signature, for example:

    sub f :lvalue ($a = do { $x = "abc"; return substr($x,0,1)}) { ...}

Note that this the second time they have been flipped:

    sub f :lvalue ($a, $b) { ... }; # 5.20; 5.28 onwards
    sub f ($a, $b) :lvalue { ... }; # 5.22 - 5.26

Comma-less variable lists in formats are no longer allowed

Omitting the commas between variables passed to formats is no longer allowed.  This has been deprecated since Perl 5.000.

The :locked and :unique attributes have been removed

These have been no-ops and deprecated since Perl 5.12 and 5.10, respectively.

\N{} with nothing between the braces is now illegal

This has been deprecated since Perl 5.24.

Opening the same symbol as both a file and directory handle is no longer allowed

Using open() and opendir() to associate both a filehandle and a dirhandle to the same symbol (glob or scalar) has been deprecated since Perl 5.10.

Use of bare << to mean <<“” is no longer allowed

Use of a bare terminator has been deprecated since Perl 5.000.

Setting $/ to a reference to a non-positive integer no longer allowed

This used to work like setting it to undef, but has been deprecated since Perl 5.20.

Unicode code points with values exceeding IV_MAX are now fatal

This was deprecated since Perl 5.24.

The B::OP::terse method has been removed

Use B::Concise::b_terse instead.

Use of inherited AUTOLOAD for non-methods is no longer allowed

This was deprecated in Perl 5.004.

Use of strings with code points over 0xFF is not allowed for bitwise string operators

Code points over 0xFF do not make sense for bitwise operators and such an operation will now croak, except for a few remaining cases. See perldeprecation.

This was deprecated in Perl 5.24.

Setting ${^ENCODING} to a defined value is now illegal

This has been deprecated since Perl 5.22 and a no-op since Perl 5.26.

Backslash no longer escapes colon in PATH for the -S switch

Previously the -S switch incorrectly treated backslash (“\”) as an escape for colon when traversing the PATH environment variable. [perl #129183] <https://rt.perl.org/Ticket/Display.html?id=129183>

the -DH (DEBUG_H) misfeature has been removed

On a perl built with debugging support, the H flag to the -D debugging option has been removed. This was supposed to dump hash values, but has been broken for many years.

Yada-yada is now strictly a statement

By the time of its initial stable release in Perl 5.12, the ... (yada-yada) operator was explicitly intended to serve as a statement, not an expression.  However, the original implementation was confused on this point, leading to inconsistent parsing.  The operator was accidentally accepted in a few situations where it did not serve as a complete statement, such as

    ... . "foo";
    ... if $a < $b;

The parsing has now been made consistent, permitting yada-yada only as a statement.  Affected code can use do{...} to put a yada-yada into an arbitrary expression context.

Sort algorithm can no longer be specified

Since Perl 5.8, the sort pragma has had subpragmata _mergesort, _quicksort, and _qsort that can be used to specify which algorithm perl should use to implement the sort builtin. This was always considered a dubious feature that might not last, hence the underscore spellings, and they were documented as not being portable beyond Perl 5.8.  These subpragmata have now been deleted, and any attempt to use them is an error.  The sort pragma otherwise remains, and the algorithm-neutral stable subpragma can be used to control sorting behaviour. [perl #119635] <https://rt.perl.org/Ticket/Display.html?id=119635>

Over-radix digits in floating point literals

Octal and binary floating point literals used to permit any hexadecimal digit to appear after the radix point.  The digits are now restricted to those appropriate for the radix, as digits before the radix point always were.

Return type of unpackstring()

The return types of the C API functions unpackstring() and unpack_str() have changed from I32 to SSize_t, in order to accommodate datasets of more than two billion items.

Deprecations

Use of vec on strings with code points above 0xFF is deprecated

Such strings are represented internally in UTF-8, and vec is a bit-oriented operation that will likely give unexpected results on those strings.

Some uses of unescaped “{” in regexes are no longer fatal

Perl 5.26.0 fatalized some uses of an unescaped left brace, but an exception was made at the last minute, specifically crafted to be a minimal change to allow GNU Autoconf to work.  That tool is heavily depended upon, and continues to use the deprecated usage.  Its use of an unescaped left brace is one where we have no intention of repurposing "{" to be something other than itself.

That exception is now generalized to include various other such cases where the "{" will not be repurposed.

Note that these uses continue to raise a deprecation message.

Use of unescaped “{” immediately after a “(” in regular expression patterns is deprecated

Using unescaped left braces is officially deprecated everywhere, but it is not enforced in contexts where their use does not interfere with expected extensions to the language.  A deprecation is added in this release when the brace appears immediately after an opening parenthesis. Before this, even if the brace was part of a legal quantifier, it was not interpreted as such, but as the literal characters, unlike other quantifiers that follow a "(" which are considered errors.  Now, their use will raise a deprecation message, unless turned off.

Assignment to $[ will be fatal in Perl 5.30

Assigning a non-zero value to $[ has been deprecated since Perl 5.12, but was never given a deadline for removal.  This has now been scheduled for Perl 5.30.

hostname() won't accept arguments in Perl 5.32

Passing arguments to Sys::Hostname::hostname() was already deprecated, but didn't have a removal date.  This has now been scheduled for Perl 5.32.  [perl #124349] <https://rt.perl.org/Ticket/Display.html?id=124349>

Module removals

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 "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.

B::Debug

Locale::Codes and its associated Country, Currency and Language modules

Performance Enhancements

Modules and Pragmata

Key highlights in this release across several modules:

Removal of use vars

The usage of use vars has been discouraged since the introduction of our in Perl 5.6.0. Where possible the usage of this pragma has now been removed from the Perl source code.

This had a slight effect (for the better) on the output of WARNING_BITS in B::Deparse.

Use of DynaLoader changed to XSLoader in many modules

XSLoader is more modern, and most modules already require perl 5.6 or greater, so no functionality is lost by switching. In some cases, we have also made changes to the local implementation that may not be reflected in the version on CPAN due to a desire to maintain more backwards compatibility.

Updated Modules and Pragmata

  • Archive::Tar has been upgraded from version 2.24 to 2.30.

    This update also handled CVE-2018-12015: directory traversal vulnerability. [cpan #125523] <https://rt.cpan.org/Ticket/Display.html?id=125523>

  • arybase has been upgraded from version 0.12 to 0.15.
  • Attribute::Handlers has been upgraded from version 0.99 to 1.01.
  • attributes has been upgraded from version 0.29 to 0.33.
  • B has been upgraded from version 1.68 to 1.74.
  • B::Concise has been upgraded from version 0.999 to 1.003.
  • B::Debug has been upgraded from version 1.24 to 1.26.

    NOTE: B::Debug is deprecated and may be removed from a future version of Perl.

  • B::Deparse has been upgraded from version 1.40 to 1.48.

    It includes many bug fixes, and in particular, it now deparses variable attributes correctly:

        my $x :foo;  # used to deparse as
                     # 'attributes'->import('main', \$x, 'foo'), my $x;
  • base has been upgraded from version 2.25 to 2.27.
  • bignum has been upgraded from version 0.47 to 0.49.
  • blib has been upgraded from version 1.06 to 1.07.
  • bytes has been upgraded from version 1.05 to 1.06.
  • Carp has been upgraded from version 1.42 to 1.50.

    If a package on the call stack contains a constant named ISA, Carp no longer throws a “Not a GLOB reference” error.

    Carp, when generating stack traces, now attempts to work around longstanding bugs resulting from Perl's non-reference-counted stack. [perl #52610] <https://rt.perl.org/Ticket/Display.html?id=52610>

    Carp has been modified to avoid assuming that objects cannot be overloaded without the overload module loaded (this can happen with objects created by XS modules).  Previously, infinite recursion would result if an XS-defined overload method itself called Carp. [perl #132828] <https://rt.perl.org/Ticket/Display.html?id=132828>

    Carp now avoids using overload::StrVal, partly because older versions of overload (included with perl 5.14 and earlier) load Scalar::Util at run time, which will fail if Carp has been invoked after a syntax error.

  • charnames has been upgraded from version 1.44 to 1.45.
  • Compress::Raw::Zlib has been upgraded from version 2.074 to 2.076.

    This addresses a security vulnerability in older versions of the 'zlib' library (which is bundled with Compress-Raw-Zlib).

  • Config::Extensions has been upgraded from version 0.01 to 0.02.
  • Config::Perl::V has been upgraded from version 0.28 to 0.29.
  • CPAN has been upgraded from version 2.18 to 2.20.
  • Data::Dumper has been upgraded from version 2.167 to 2.170.

    Quoting of glob names now obeys the Useqq option [perl #119831] <https://rt.perl.org/Ticket/Display.html?id=119831>.

    Attempts to set an option to undef through a combined getter/setter method are no longer mistaken for getter calls [perl #113090] <https://rt.perl.org/Ticket/Display.html?id=113090>.

  • Devel::Peek has been upgraded from version 1.26 to 1.27.
  • Devel::PPPort has been upgraded from version 3.35 to 3.40.

    Devel::PPPort has moved from cpan-first to perl-first maintenance

    Primary responsibility for the code in Devel::PPPort has moved into core perl. In a practical sense there should be no change except that hopefully it will stay more up to date with changes made to symbols in perl, rather than needing to be updated after the fact.

  • Digest::SHA has been upgraded from version 5.96 to 6.01.
  • DirHandle has been upgraded from version 1.04 to 1.05.
  • DynaLoader has been upgraded from version 1.42 to 1.45.

    Its documentation now shows the use of __PACKAGE__ and direct object syntax [perl #132247] <https://rt.perl.org/Ticket/Display.html?id=132247>.

  • Encode has been upgraded from version 2.88 to 2.97.
  • encoding has been upgraded from version 2.19 to 2.22.
  • Errno has been upgraded from version 1.28 to 1.29.
  • experimental has been upgraded from version 0.016 to 0.019.
  • Exporter has been upgraded from version 5.72 to 5.73.
  • ExtUtils::CBuilder has been upgraded from version 0.280225 to 0.280230.
  • ExtUtils::Constant has been upgraded from version 0.23 to 0.25.
  • ExtUtils::Embed has been upgraded from version 1.34 to 1.35.
  • ExtUtils::Install has been upgraded from version 2.04 to 2.14.
  • ExtUtils::MakeMaker has been upgraded from version 7.24 to 7.34.
  • ExtUtils::Miniperl has been upgraded from version 1.06 to 1.08.
  • ExtUtils::ParseXS has been upgraded from version 3.34 to 3.39.
  • ExtUtils::Typemaps has been upgraded from version 3.34 to 3.38.
  • ExtUtils::XSSymSet has been upgraded from version 1.3 to 1.4.
  • feature has been upgraded from version 1.47 to 1.52.
  • fields has been upgraded from version 2.23 to 2.24.
  • File::Copy has been upgraded from version 2.32 to 2.33.

    It will now use the sub-second precision variant of utime() supplied by Time::HiRes where available. [perl #132401] <https://rt.perl.org/Ticket/Display.html?id=132401>.

  • File::Fetch has been upgraded from version 0.52 to 0.56.
  • File::Glob has been upgraded from version 1.28 to 1.31.
  • File::Path has been upgraded from version 2.12_01 to 2.15.
  • File::Spec and Cwd have been upgraded from version 3.67 to 3.74.
  • File::stat has been upgraded from version 1.07 to 1.08.
  • FileCache has been upgraded from version 1.09 to 1.10.
  • Filter::Simple has been upgraded from version 0.93 to 0.95.
  • Filter::Util::Call has been upgraded from version 1.55 to 1.58.
  • GDBM_File has been upgraded from version 1.15 to 1.17.

    Its documentation now explains that each and delete don't mix in hashes tied to this module [perl #117449] <https://rt.perl.org/Ticket/Display.html?id=117449>.

    It will now retry opening with an acceptable block size if asking gdbm to default the block size failed [perl #119623] <https://rt.perl.org/Ticket/Display.html?id=119623>.

  • Getopt::Long has been upgraded from version 2.49 to 2.5.
  • Hash::Util::FieldHash has been upgraded from version 1.19 to 1.20.
  • I18N::Langinfo has been upgraded from version 0.13 to 0.17.

    This module is now available on all platforms, emulating the system nl_langinfo(3) on systems that lack it.  Some caveats apply, as detailed in its documentation, the most severe being that, except for MS Windows, the CODESET item is not implemented on those systems, always returning "".

    It now sets the UTF-8 flag in its returned scalar if the string contains legal non-ASCII UTF-8, and the locale is UTF-8 [perl #127288] <https://rt.perl.org/Ticket/Display.html?id=127288>.

    This update also fixes a bug in which the underlying locale was ignored for the RADIXCHAR (always was returned as a dot) and the THOUSEP (always empty).  Now the locale-appropriate values are returned.

  • I18N::LangTags has been upgraded from version 0.42 to 0.43.
  • if has been upgraded from version 0.0606 to 0.0608.
  • IO has been upgraded from version 1.38 to 1.39.
  • IO::Socket::IP has been upgraded from version 0.38 to 0.39.
  • IPC::Cmd has been upgraded from version 0.96 to 1.00.
  • JSON::PP has been upgraded from version 2.27400_02 to 2.97001.
  • The libnet distribution has been upgraded from version 3.10 to 3.11.
  • List::Util has been upgraded from version 1.46_02 to 1.49.
  • Locale::Codes has been upgraded from version 3.42 to 3.56.

    NOTE: Locale::Codes scheduled to be removed from core in Perl 5.30.

  • Locale::Maketext has been upgraded from version 1.28 to 1.29.
  • Math::BigInt has been upgraded from version 1.999806 to 1.999811.
  • Math::BigInt::FastCalc has been upgraded from version 0.5005 to 0.5006.
  • Math::BigRat has been upgraded from version 0.2611 to 0.2613.
  • Module::CoreList has been upgraded from version 5.20170530 to 5.20180622.
  • mro has been upgraded from version 1.20 to 1.22.
  • Net::Ping has been upgraded from version 2.55 to 2.62.
  • NEXT has been upgraded from version 0.67 to 0.67_01.
  • ODBM_File has been upgraded from version 1.14 to 1.15.
  • Opcode has been upgraded from version 1.39 to 1.43.
  • overload has been upgraded from version 1.28 to 1.30.
  • PerlIO::encoding has been upgraded from version 0.25 to 0.26.
  • PerlIO::scalar has been upgraded from version 0.26 to 0.29.
  • PerlIO::via has been upgraded from version 0.16 to 0.17.
  • Pod::Functions has been upgraded from version 1.11 to 1.13.
  • Pod::Html has been upgraded from version 1.2202 to 1.24.

    A title for the HTML document will now be automatically generated by default from a “NAME” section in the POD document, as it used to be before the module was rewritten to use Pod::Simple::XHTML to do the core of its job [perl #110520] <https://rt.perl.org/Ticket/Display.html?id=110520>.

  • Pod::Perldoc has been upgraded from version 3.28 to 3.2801.
  • The podlators distribution has been upgraded from version 4.09 to 4.10.

    Man page references and function names now follow the Linux man page formatting standards, instead of the Solaris standard.

  • POSIX has been upgraded from version 1.76 to 1.84.

    Some more cautions were added about using locale-specific functions in threaded applications.

  • re has been upgraded from version 0.34 to 0.36.
  • Scalar::Util has been upgraded from version 1.46_02 to 1.50.
  • SelfLoader has been upgraded from version 1.23 to 1.25.
  • Socket has been upgraded from version 2.020_03 to 2.027.
  • sort has been upgraded from version 2.02 to 2.04.
  • Storable has been upgraded from version 2.62 to 3.08.
  • Sub::Util has been upgraded from version 1.48 to 1.49.
  • subs has been upgraded from version 1.02 to 1.03.
  • Sys::Hostname has been upgraded from version 1.20 to 1.22.
  • Term::ReadLine has been upgraded from version 1.16 to 1.17.
  • Test has been upgraded from version 1.30 to 1.31.
  • Test::Harness has been upgraded from version 3.38 to 3.42.
  • Test::Simple has been upgraded from version 1.302073 to 1.302133.
  • threads has been upgraded from version 2.15 to 2.22.

    The documentation now better describes the problems that arise when returning values from threads, and no longer warns about creating threads in BEGIN blocks. [perl #96538] <https://rt.perl.org/Ticket/Display.html?id=96538>

  • threads::shared has been upgraded from version 1.56 to 1.58.
  • Tie::Array has been upgraded from version 1.06 to 1.07.
  • Tie::StdHandle has been upgraded from version 4.4 to 4.5.
  • Time::gmtime has been upgraded from version 1.03 to 1.04.
  • Time::HiRes has been upgraded from version 1.9741 to 1.9759.
  • Time::localtime has been upgraded from version 1.02 to 1.03.
  • Time::Piece has been upgraded from version 1.31 to 1.3204.
  • Unicode::Collate has been upgraded from version 1.19 to 1.25.
  • Unicode::Normalize has been upgraded from version 1.25 to 1.26.
  • Unicode::UCD has been upgraded from version 0.68 to 0.70.

    The function num now accepts an optional parameter to help in diagnosing error returns.

  • User::grent has been upgraded from version 1.01 to 1.02.
  • User::pwent has been upgraded from version 1.00 to 1.01.
  • utf8 has been upgraded from version 1.19 to 1.21.
  • vars has been upgraded from version 1.03 to 1.04.
  • version has been upgraded from version 0.9917 to 0.9923.
  • VMS::DCLsym has been upgraded from version 1.08 to 1.09.
  • VMS::Stdio has been upgraded from version 2.41 to 2.44.
  • warnings has been upgraded from version 1.37 to 1.42.

    It now includes new functions with names ending in _at_level, allowing callers to specify the exact call frame. [perl #132468] <https://rt.perl.org/Ticket/Display.html?id=132468>

  • XS::Typemap has been upgraded from version 0.15 to 0.16.
  • XSLoader has been upgraded from version 0.27 to 0.30.

    Its documentation now shows the use of __PACKAGE__, and direct object syntax for example DynaLoader usage [perl #132247] <https://rt.perl.org/Ticket/Display.html?id=132247>.

    Platforms that use mod2fname to edit the names of loadable libraries now look for bootstrap (.bs) files under the correct, non-edited name.

Removed Modules and Pragmata

  • The VMS::stdio compatibility shim has been removed.

Documentation

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 perlbug@perl.org <mailto:perlbug@perl.org>.

Additionally, the following selected changes have been made:

perlapi

  • The API functions perl_parse(), perl_run(), and perl_destruct() are now documented comprehensively, where previously the only documentation was a reference to the perlembed tutorial.
  • The documentation of newGIVENOP() has been belatedly updated to account for the removal of lexical $_.
  • The API functions newCONSTSUB() and newCONSTSUB_flags() are documented much more comprehensively than before.

perldata

  • The section “Truth and Falsehood” in perlsyn has been moved into perldata.

perldebguts

perldiag

  • “Variable length lookbehind not implemented in regex m/%s/” in perldiag

    This now gives more ideas as to workarounds to the issue that was introduced in Perl 5.18 (but not documented explicitly in its perldelta) for the fact that some Unicode /i rules cause a few sequences such as

     (?<!st)

    to be considered variable length, and hence disallowed.

  • “Use of state $_ is experimental” in perldiag

    This entry has been removed, as the experimental support of this construct was removed in perl 5.24.0.

  • The diagnostic Initialization of state variables in list context currently forbidden has changed to Initialization of state variables in list currently forbidden, because list-context initialization of single aggregate state variables is now permitted.

perlembed

  • The examples in perlembed have been made more portable in the way they exit, and the example that gets an exit code from the embedded Perl interpreter now gets it from the right place.  The examples that pass a constructed argv to Perl now show the mandatory null argv[argc].
  • An example in perlembed used the string value of ERRSV as a format string when calling croak().  If that string contains format codes such as %s this could crash the program.

    This has been changed to a call to croak_sv().

    An alternative could have been to supply a trivial format string:

      croak("%s", SvPV_nolen(ERRSV));

    or as a special case for ERRSV simply:

      croak(NULL);

perlfunc

  • There is now a note that warnings generated by built-in functions are documented in perldiag and warnings. [perl #116080] <https://rt.perl.org/Ticket/Display.html?id=116080>
  • The documentation for the exists operator no longer says that autovivification behaviour “may be fixed in a future release”. We've determined that we're not going to change the default behaviour. [perl #127712] <https://rt.perl.org/Ticket/Display.html?id=127712>
  • A couple of small details in the documentation for the bless operator have been clarified. [perl #124428] <https://rt.perl.org/Ticket/Display.html?id=124428>
  • The description of @INC hooks in the documentation for require has been corrected to say that filter subroutines receive a useless first argument. [perl #115754] <https://rt.perl.org/Ticket/Display.html?id=115754>
  • The documentation of ref has been rewritten for clarity.
  • The documentation of use now explains what syntactically qualifies as a version number for its module version checking feature.
  • The documentation of warn has been updated to reflect that since Perl 5.14 it has treated complex exception objects in a manner equivalent to die. [perl #121372] <https://rt.perl.org/Ticket/Display.html?id=121372>
  • The documentation of die and warn has been revised for clarity.
  • The documentation of each has been improved, with a slightly more explicit description of the sharing of iterator state, and with caveats regarding the fragility of while-each loops. [perl #132644] <https://rt.perl.org/Ticket/Display.html?id=132644>
  • Clarification to require was added to explain the differences between

        require Foo::Bar;
        require "Foo/Bar.pm";

perlgit

  • The precise rules for identifying smoke-me branches are now stated.

perlguts

  • The section on reference counting in perlguts has been heavily revised, to describe references in the way a programmer needs to think about them rather than in terms of the physical data structures.
  • Improve documentation related to UTF-8 multibytes.

perlintern

  • The internal functions newXS_len_flags() and newATTRSUB_x() are now documented.

perlobj

perlop

perlrequick

  • Clarifications on metacharacters and character classes

perlretut

  • Clarify metacharacters.

perlrun

perlsec

perlsyn

  • The section “Truth and Falsehood” in perlsyn has been removed from that document, where it didn't belong, and merged into the existing paragraph on the same topic in perldata.
  • The means to disambiguate between code blocks and hash constructors, already documented in perlref, are now documented in perlsyn too. [perl #130958] <https://rt.perl.org/Ticket/Display.html?id=130958>

perluniprops

  • perluniprops has been updated to note that \p{Word} now includes code points matching the \p{Join_Control} property.  The change to the property was made in Perl 5.18, but not documented until now.  There are currently only two code points that match this property U+200C (ZERO WIDTH NON-JOINER) and U+200D (ZERO WIDTH JOINER).
  • For each binary table or property, the documentation now includes which characters in the range \x00-\xFF it matches, as well as a list of the first few ranges of code points matched above that.

perlvar

  • The entry for $+ in perlvar has been expanded upon to describe handling of multiply-named capturing groups.

perlfunc, perlop, perlsyn

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 perldiag.

New Diagnostics

New Errors

  • Can't “goto” into a “given” block

    (F) A “goto” statement was executed to jump into the middle of a given block.  You can't get there from here.  See “goto” in perlfunc.

  • Can't “goto” into a binary or list expression

    Use of goto to jump into the parameter of a binary or list operator has been prohibited, to prevent crashes and stack corruption. [perl #130936] <https://rt.perl.org/Ticket/Display.html?id=130936>

    You may only enter the first argument of an operator that takes a fixed number of arguments, since this is a case that will not cause stack corruption. [perl #132854] <https://rt.perl.org/Ticket/Display.html?id=132854>

New Warnings

  • Old package separator used in string

    (W syntax) You used the old package separator, “”', in a variable named inside a double-quoted string; e.g., "In $name's house".  This is equivalent to "In $name::s house".  If you meant the former, put a backslash before the apostrophe ("In $name\'s house").

  • “Locale '%s' contains (at least) the following characters which have unexpected meanings: %s  The Perl program will use the expected meanings” in perldiag

Changes to Existing Diagnostics

  • A false-positive warning that was issued when using a numerically-quantified sub-pattern in a recursive regex has been silenced. [perl #131868] <https://rt.perl.org/Public/Bug/Display.html?id=131868>
  • The warning about useless use of a concatenation operator in void context is now generated for expressions with multiple concatenations, such as $a.$b.$c, which used to mistakenly not warn. [perl #6997] <https://rt.perl.org/Ticket/Display.html?id=6997>
  • Warnings that a variable or subroutine “masks earlier declaration in same ...”, or that an our variable has been redeclared, have been moved to a new warnings category “shadow”.  Previously they were in category “misc”.
  • The deprecation warning from Sys::Hostname::hostname() saying that it doesn't accept arguments now states the Perl version in which the warning will be upgraded to an error. [perl #124349] <https://rt.perl.org/Ticket/Display.html?id=124349>
  • The perldiag entry for the error regarding a set-id script has been expanded to make clear that the error is reporting a specific security vulnerability, and to advise how to fix it.
  • The Unable to flush stdout error message was missing a trailing newline. [debian #875361]

Utility Changes

perlbug

  • --help and --version options have been added.

Configuration and Compilation

Testing

Packaging

For the past few years we have released perl using three different archive formats: bzip (.bz2), LZMA2 (.xz) and gzip (.gz). Since xz compresses better and decompresses faster, and gzip is more compatible and uses less memory, we have dropped the .bz2 archive format with this release. (If this poses a problem, do let us know; see “Reporting Bugs”, below.)

Platform Support

Discontinued Platforms

PowerUX / Power MAX OS

Compiler hints and other support for these apparently long-defunct platforms has been removed.

Platform-Specific Notes

CentOS

Compilation on CentOS 5 is now fixed.

Cygwin

A build with the quadmath library can now be done on Cygwin.

Darwin

Perl now correctly uses reentrant functions, like asctime_r, on versions of Darwin that have support for them.

FreeBSD

FreeBSD's /usr/share/mk/sys.mk specifies -O2 for architectures other than ARM and MIPS. By default, perl is now compiled with the same optimization levels.

VMS

Several fix-ups for configure.com, marking function VMS has (or doesn't have).

CRTL features can now be set by embedders before invoking Perl by using the decc$feature_set and decc$feature_set_value functions. Previously any attempt to set features after image initialization were ignored.

Windows
  • Support for compiling perl on Windows using Microsoft Visual Studio 2017 (containing Visual C++ 14.1) has been added.
  • Visual C++ compiler version detection has been improved to work on non-English language systems.
  • We now set $Config{libpth} correctly for 64-bit builds using Visual C++ versions earlier than 14.1.

Internal Changes

Selected Bug Fixes

Acknowledgements

Perl 5.28.0 represents approximately 13 months of development since Perl 5.26.0 and contains approximately 730,000 lines of changes across 2,200 files from 77 authors.

Excluding auto-generated files, documentation and release tools, there were approximately 580,000 lines of changes to 1,300 .pm, .t, .c and .h files.

Perl continues to flourish into its fourth decade thanks to a vibrant community of users and developers. The following people are known to have contributed the improvements that became Perl 5.28.0:

Aaron Crane, Abigail, AEvar Arnfjoerð Bjarmason, Alberto Simoes, Alexandr Savca, Andrew Fresh, Andy Dougherty, Andy Lester, Aristotle Pagaltzis, Ask Bjorn Hansen, Chris 'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari Mannsaaker, Dan Collins, Daniel Dragan, David Cantrell, David Mitchell, Dmitry Ulanov, Dominic Hargreaves, E. Choroba, Eric Herman, Eugen Konkov, Father Chrysostomos, Gene Sullivan, George Hartzell, Graham Knop, Harald Joerg, H.Merijn Brand, Hugo van der Sanden, Jacques Germishuys, James E Keenan, Jarkko Hietaniemi, Jerry D. Hedden, J. Nick Koston, John Lightsey, John Peacock, John P. Linderman, John SJ Anderson, Karen Etheridge, Karl Williamson, Ken Brown, Ken Cotterill, Leon Timmermans, Lukas Mai, Marco Fontani, Marc-Philip Werner, Matthew Horsfall, Neil Bowers, Nicholas Clark, Nicolas R., Niko Tyni, Pali, Paul Marquess, Peter John Acklam, Reini Urban, Renee Baecker, Ricardo Signes, Robin Barker, Sawyer X, Scott Lanning, Sergey Aleynikov, Shirakata Kentaro, Shoichi Kaji, Slaven Rezic, Smylers, Steffen Mueller, Steve Hay, Sullivan Beck, Thomas Sibley, Todd Rinaldo, Tomasz Konojacki, Tom Hukins, Tom Wyant, Tony Cook, Vitali Peil, Yves Orton, Zefram.

The list above is almost certainly incomplete as it is automatically generated from version control history. In particular, it does not include the names of the (very much appreciated) contributors who reported issues to the Perl bug tracker.

Many of the changes included in this version originated in the CPAN modules included in Perl's core. We're grateful to the entire CPAN community for helping Perl to flourish.

For a more complete list of all of Perl's historical contributors, please see the AUTHORS file in the Perl source distribution.

Reporting Bugs

If you find what you think is a bug, you might check the perl bug database at <https://rt.perl.org/> .  There may also be information at <http://www.perl.org/> , the Perl Home Page.

If you believe you have an unreported bug, please run the 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 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 “Security VULNERABILITY CONTACT INFORMATION” in perlsec for details of how to report the issue.

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 perlthanks program:

    perlthanks

This will send an email to the Perl 5 Porters list with your show of thanks.

See Also

The Changes file for an explanation of how to view exhaustive details on what changed.

The INSTALL file for how to build Perl.

The README file for general stuff.

The Artistic and Copying files for copyright information.

Info

2020-10-14 perl v5.32.0 Perl Programmers Reference Guide