index: release v1.18 with only altgr index linked
[sheet.git] / perl.inc.pl
index faf530eb1bf213d013668e670badde7612e5f74c..e26cbcd4603722a25fbc935e5469eee3ca367ec4 100644 (file)
@@ -1,5 +1,7 @@
 use utf8;
+use strict;
 
+my $wbr = "\N{ZERO WIDTH SPACE}";
 +{
        v5.004 => {
                release => '1997-05-15',
@@ -11,7 +13,7 @@ use utf8;
 
        v5.005 => {
                new => [
-                       ['threads' => '', {experimental => 0, stable => 0}],
+                       ['<code>lock</code>', 'obsolete <code>Thread</code> implementation, including a keyword to place advisory locks on shared variables', {experimental => 0, stable => 0, dropped => v5.10}],
                        ['<code>B::…</code>', 'backend hooks'],
                        ['<code>qr//</code>' => 'overhauled regular expression engine: precompile operator, lookahead/behind, code, conditions, localised flags'],
                        ['<code>… foreach</code>' => '<code>for(each)</code> as statement modifier, with large ranges optimised as counting loops'],
@@ -23,6 +25,13 @@ use utf8;
                        ['<code>splice …,…,-$length</code>', 'negative length indicates elements to keep at the end of an array'],
                        ['<code>$/</code>', 'integer or scalar separator makes <code>&lt;&gt;</code> read records instead of lines'],
                ],
+               modules => [
+                       ['Data::Dumper' => 'stringify data structures'],
+                       ['Errno' => 'system <code>errno.h</code> constants'],
+                       ['File::Spec'],
+                       ['Fatal'],
+                       ['Test'],
+               ],
                release => '1998-07-22',
                unstable => 0,
        },
@@ -59,12 +68,25 @@ use utf8;
        v5.8 => {
                new => [
                        [q"<code>no utf8</code>", 'full unicode support, <code>utf8</code> pragma only for script encoding', {name => 'utf8_data'}],
-                       [q"<code>binmode $fh, ':perlio'</code>", 'file handle behaviour altered by PerlIO layers', {name => 'perlio'}],
+                       [q"<code>use open</code>", 'file handle behaviour altered by PerlIO layers', {name => 'perlio', eg => 'binmode $fh, ":bytes"'}],
                        [q"<code>open $fh, '-|', @cmd</code>", 'open list to fork a command without spawning a shell'],
                        [q"<code>open $fh, '>', \$var</code>", 'perl scalars as virtual files'],
                        [q"<code>printf '%1$s', @args</code>", 'syntax to use parameters out of order'],
                        [q"<code>1_2_3 == 123</code>", 'underscores between digits allowed in numeric constants'],
-#                      [q"<code>use if</code>", 'conditional module inclusion'], # also installable in earlier versions
+               ],
+               modules => [
+                       [bignum => 'transparent big number support', 'length 1e100 == 101'],
+                       [if => 'conditional module inclusion', 'no if $] >= 5.022, "warnings", "redundant"'],
+                       [sort => 'override sort() algorithm', {dropped => v5.28, eg => 'sort::current eq "stable"'}],
+                       [Digest => 'calculate various message digests (data hashes)', '$hash = sha256_hex($data)'],
+                       [Encode => 'character set conversion', 'encode("utf8", decode("iso-8859-1", $octets))'],
+                       ['File::Temp' => 'create a temporary file or directory safely', '$fh = tempfile();'],
+                       ['List::Util' => 'general-utility list subroutines', '@cards = shuffle 0..51'],
+                       ['Locale::Maketext' => 'various localization and internationalization in <code>Locale::*</code> and <code>L18N::*</code>'],
+                       ['Memoize' => 'remember function results, trading space for time', 'memoize "stat"'],
+                       ['MIME::Base64' => 'base64 encoded strings as in email attachments'],
+                       ['Test::More' => 'modern framework for unit testing', 'is $got, $expected'],
+                       ['Time::HiRes' => 'high resolution timers', '$μs = [gettimeofday]; sleep .1;'.$wbr.' $elapsed = tv_interval $μs'],
                ],
                release => '2002-07-18',
                distro => {
@@ -99,6 +121,13 @@ use utf8;
                        ['<code>my $_</code>', 'lexically scoped version of the default variable', {experimental => 'lexical_topic', dropped => v5.23.4}],
                        ['<code>state</code>', 'persistent <code>my</code> variables (scalars only until <a href="#state_ext">5.28</a>)', {feature => 'state'}],
                ],
+               modules => [
+                       [autodie => 'replace builtin functions to throw exceptions instead of returning failure', 'eval {open ...} or $@->matches("open") || die'],
+                       # overloading
+                       ['IO::Compress::Zip' => 'various file compression standards', 'zip IO::Uncompress::Gunzip->new("test.gz")'.$wbr.' => "recompressed.zip"'],
+                       ['Time::Piece' => 'timestamps as objects', 'localtime->year > 1900'],
+                       ['File::Fetch' => 'generic data retrieval/download', 'File::Fetch->new(uri => "http://localhost/")'.$wbr.'->fetch(to => \$slurp)'],
+               ],
                release => '2007-12-18',
                distro => {
                        debian => '5.0', # lenny 2009-02 eol 2012-02
@@ -145,6 +174,11 @@ use utf8;
                        ['<code>FH->method</code>', 'filehandle method calls load IO::File on demand (eg. <code>STDOUT->flush</code>)'],
                        ['<code>\o{}</code>', 'escape sequence for octal values beyond \777'],
                ],
+               modules => [
+                       [JSON => 'interface with data in JavaScript Object Notation', 'decode_json <>'],
+                       ['HTTP::Tiny' => 'minimal HTTP/1.1 client without <code>LWP::UserAgent</code> overhead', {dropped => 0}],
+                       # Unicode::Collate::Locale
+               ],
                release => '2011-05-14',
                distro => {
                        debian => '7', # wheezy 2013-05 eol 2018-05 elts 2020-06
@@ -184,6 +218,7 @@ use utf8;
                distro => {
                        ubuntu => '14.04 LTS', # trusty
                        opensuse => '13.1', # 2013-11 eol 2016-01
+                       macos => '10.15', # pre-installed catalina 2019-10
                },
                unicode => '6.2',
        },
@@ -247,6 +282,9 @@ use utf8;
                        ['<code>@{^CAPTURE}</code>', q"array of last match's captures, so <code>${^CAPTURE}[0]</code> is <code>$1</code>"],
                        ['<code>//xx</code>', 'extended modifier to also ignore whitespace in bracketed character classes'],
                ],
+               modules => [
+                       ['Test2::V0' => 'generic testing framework to replace <code>Test::*</code> and <code>TAP::*</code>'],
+               ],
                unicode => '9.0', # also Script_Extensions/scx in "\p{script}"
                release => '2017-05-30',
                distro => {
@@ -273,6 +311,7 @@ use utf8;
                        debian => '10', # buster 2019-07
                        ubuntu => '19.04', # disco 2019-04 eol 2020-01
                        freebsd => '11', # eol 2021-09
+                       macos => '11', # big sur 2020-11
                },
                distrosum => "stable systems such as Debian 10, Ubuntu 19.04, FreeBSD 11",
        },
@@ -288,6 +327,7 @@ use utf8;
                release => '2019-05-22',
                distro => {
                        ubuntu => '20.04', # focal LTS 2020-04 eol 2025-04
+                       macos => '11.3', # big sur 2021-04 and monterrey 2021-10, alongside compatibility v5.18
                },
        },
 
@@ -345,8 +385,24 @@ use utf8;
                unicode => '14.0',
                release => '2022-05-28',
                distro => {
-                       debian => '12', # bookworm 2023 upcoming
+                       debian => '12', # bookworm 2023-06
                        ubuntu => '23.04', # lunar upcoming
                },
        },
+
+       v5.38 => {
+               new => [
+                       ['<code>use feature "module_true"</code>', 'default in use 5.37 and up, also <code>no feature "bareword_filehandles"</code>'],
+                       ['<code>sub ($var ||=</code> default<code>)</code>', 'assign values when false (or undefined on <code>//=</code>) instead of omitted'],
+                       ['<code>/(*{ … })/</code>', 'optimistic eval: <code>(?{ … })</code> with regex optimisations enabled'],
+                       ['<code>class</code>', "define object classes: packages with <code>field</code> variables and <code>method</code> subroutines", {feature => 'class', experimental => 'class'}],
+                       ['<code>${^LAST_<wbr>SUCCESSFUL_<wbr>PATTERN}</code>', 'explicit variable to access the previous match as in <code>s//…/</code>'],
+                       ['<code>%{^HOOK}</code>', "perform tasks <code>require__before</code> and <code>require__after</code> when calling <code>require</code>"], # also @INC hook enhancements
+                       ['<code>PERL_RAND_<wbr>SEED</code>', 'environment variable to set <code>srand</code> random number seed', {dropped => 0}],
+                       ['<code>is_tainted</code>', '<code>builtin</code> function to check variable tainting like <code>Scalar::Util::tainted</code>', {dropped => 0, experimental => 'builtin', eg => 'builtin::is_tainted($ENV{PWD}) and say "running perl -T"'}],
+                       ['<code>export_lexically</code>', '<code>builtin</code> function to export named functions into the calling scope', {dropped => 0, experimental => 'builtin', eg => 'method import {builtin::export_lexically {map {$_ => $self->can($_)} @_}}'}],
+               ],
+               unicode => '15.0',
+               release => '2023-07-02',
+       },
 }