X-Git-Url: http://git.shiar.net/sheet.git/blobdiff_plain/9cdf17f81bc6b6b16d82f48e1f8ae04c9f0886a7..10ebd7e89e3735dc1659c7ef01c2155694f8ba81:/perl.inc.pl?ds=inline

diff --git a/perl.inc.pl b/perl.inc.pl
index 0b6ab2c..ee7aaad 100644
--- a/perl.inc.pl
+++ b/perl.inc.pl
@@ -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 => [
-			['<code>lock</code>', 'obsolete <code>Thread</code> implementation, including a keyword to place advisory locks on shared variables', {experimental => 0, stable => 0, removed => v5.10}],
+			['<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'],
@@ -84,7 +86,7 @@ use utf8;
 			['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; $elapsed = tv_interval $μs'],
+			['Time::HiRes' => 'high resolution timers', '$μs = [gettimeofday]; sleep .1;'.$wbr.' $elapsed = tv_interval $μs'],
 		],
 		release => '2002-07-18',
 		distro => {
@@ -122,9 +124,9 @@ use utf8;
 		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") => "recompressed.zip"'],
+			['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/")->fetch(to => \$slurp)'],
+			['File::Fetch' => 'generic data retrieval/download', 'File::Fetch->new(uri => "http://localhost/")'.$wbr.'->fetch(to => \$slurp)'],
 		],
 		release => '2007-12-18',
 		distro => {
@@ -174,7 +176,7 @@ use utf8;
 		],
 		modules => [
 			[JSON => 'interface with data in JavaScript Object Notation', 'decode_json <>'],
-			['HTTP::Tiny' => 'minimal HTTP/1.1 client without <code>LWP::UserAgent</code> overhead'],
+			['HTTP::Tiny' => 'minimal HTTP/1.1 client without <code>LWP::UserAgent</code> overhead', {dropped => 0}],
 			# Unicode::Collate::Locale
 		],
 		release => '2011-05-14',
@@ -216,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',
 	},
@@ -249,6 +252,8 @@ use utf8;
 			[q"<code>use re 'strict'</code>", 'apply stricter syntax rules to regular expression patterns', {experimental => 're_strict'}],
 			['<code>0x.beep+0</code>', q"hexadecimal floating point notation with binary power; <code>printf '%a'</code> to display"],
 			['<code><s>??</s></code>', 'single match shorthand (deprecated since v5.14) requires the operator <code><em>m</em>?PATTERN?</code>'],
+			['<code><s>use CGI</s></code>' => 'deprecated interface for serving http requests removed from core'
+			.', see <a href="https://metacpan.org/pod/CGI::Alternatives" target=_blank>CGI::Alternatives</a>', {name => 'cgi'}],
 		],
 		unicode => '7.0',
 		release => '2015-06-01',
@@ -308,6 +313,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",
 	},
@@ -318,11 +324,13 @@ use utf8;
 			['<code>m(\p{nv=/.*/})</code>', 'match unicode properties by regular expressions', {experimental => 'uniprop_wildcards'}],
 			['<code><s>my $state if 0</s></code>', 'workaround for <code><a href="#state">state</a></code> (deprecated since v5.10!) is now prohibited'],
 			[q"<code>qr'\N'</code>", 'Delimiters must be graphemes; unescaped <code>{</code> illegal; <code>\N</code> in single quotes'],
+			['<code><s>use Locale::Codes</s></code>', 'removed from core, get actual lists from CPAN', {dropped => v5.30}],
 		],
 		unicode => '12.1',
 		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
 		},
 	},
 
@@ -350,7 +358,7 @@ use utf8;
 
 	v5.34 => {
 		new => [
-			['<code>try {} catch</code>', 'exception handling similar to eval blocks', {feature => 'try', experimental => 'try'}],
+			['<code>try {} catch</code>', 'exception handling similar to eval blocks', {feature => 'try', experimental => 'try', stable => v5.40}],
 			['<code>/{,<i>n</i>}/</code>', 'empty lower bound quantifier is accepted as shorthand for 0'],
 			['<code>\x{ … }</code>', 'insignificant space within curly braces, also for <code>\b{}</code>, <code>\g{}</code>, <code>\k{}</code>, <code>\N{}</code>, <code>\o{}</code> as well as <code>/{m,n}/</code> quantifiers'],
 			['<code>0o0</code>', 'octal prefix <code>0o</code> alternative to <code>0…</code> and <code>oct</code>'],
@@ -367,11 +375,11 @@ use utf8;
 	v5.36 => {
 		new => [
 			['<code>use v5.36</code>', "use <code>warnings</code>; use feature qw'<code>signatures isa</code>'; no feature qw'<code>indirect multidimensional switch</code>'"],
-			['<code>use builtin</code>', 'namespace for interpreter functions, such as <code>weaken</code> and <code>blessed</code> from <code>Scalar::Util</code>, <code>ceil</code>/<code>floor</code> from <code>POSIX</code>, and <code>trim</code> like <code>String::Util</code>', {experimental => 'builtin'}],
+			['<code>use builtin</code>', 'namespace for interpreter functions, such as <code>weaken</code> and <code>blessed</code> from <code>Scalar::Util</code>, <code>ceil</code>/<code>floor</code> from <code>POSIX</code>, and <code>trim</code> like <code>String::Util</code>', {experimental => 'builtin', stable => v5.40}],
 			['<code>is_bool(!0)</code>', 'distinguish scalar variable types (by <code>builtin</code> functions) for data interoperability', {name => 'is_bool'}],
-			['<code>for my ($k, $v) (%hash)</code>', 'iterate over multiple values at a time (including <code>builtin::indexed</code> for arrays)', {experimental => 'for_list', feature => 'for_list'}],
+			['<code>for my ($k, $v) (%hash)</code>', 'iterate over multiple values at a time (including <code>builtin::indexed</code> for arrays)', {experimental => 'for_list', feature => 'for_list', stable => v5.40}],
 			['<code>defer {}</code>', 'queue code to be executed when going out of scope', {feature => 'defer', experimental => 'defer'}],
-			['<code>try {} finally {}</code>', 'run code at the end of a <code><a href="#try">try</a></code> construct regardless of failure', {name => 'finally', feature => 'try', experimental => 'try'}],
+			['<code>try {} finally {}</code>', 'run code at the end of a <code><a href="#try">try</a></code> construct regardless of failure', {name => 'finally', feature => 'try', experimental => 'try', stable => 0}], # not stable in v5.40
 			['<code>q«…»</code>', 'unicode delimiters for quoting operators', {experimental => 'extra_paired_delimiters'}],
 			['<code>sub ($var) {!<s>pop</s>}</code>', '<a href="#signatures">signature</a>d subs are stable, but mixing with the arguments array <code>@_</code> remains experimental', {feature => 'signatures', experimental => 'args_array_with_signatures'}],
 			['<code>$SIG{FPE}</code>', 'floating-point exceptions no longer deferred but delivered immediately like other signals', {name => 'sig_fpe'}],
@@ -380,8 +388,40 @@ 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',
+	},
+
+	v5.40 => {
+		new => [
+			['<code>use v5.40</code>', 'import <a href="#builtin">builtin</a> functions and enable the <a href="#try">try</a> feature'],
+			['<code>__CLASS__</code>', 'keyword to reference to the current class name, similar to <code>__PACKAGE__</code>', {feature => 'class'}],
+			['<code>:reader</code>', 'attribute for <a href="#class">field</a> variables to create corresponding accessor methods', {feature => 'class'}],
+			['<code>^^</code>', 'higher precedence logical <code>xor</code> operator, as <code>||</code> is to <code>or</code>'],
+			['perl<code> -M&nbsp;…</code>', 'whitespace allowed after <code>-M</code> options', {dropped => 0}],
+			['<code>builtin::inf</code>, <code>builtin::nan</code>', 'constants equivalent to special floating point values <em>infinity</em> and <em>Not a Number</em>'],
+		],
+		modules => [
+			['Test2::Suite' => 'comprehensive set of test tools for writing unit tests, providing a drop in replacement to <code>Test::More</code>'],
+			['Term::Table' => 'format rows of data as ASCII tables, as in <a href="#test2_suite">Test2</a> diffs', {dropped => 0}],
+		],
+		release => '2024-06-09',
+	},
 }