X-Git-Url: http://git.shiar.nl/sheet.git/blobdiff_plain/ffd2fcb2acedf1b1f98d970fbc0f701c2b810e21..21a93def2665aa147da1a9acd03b644e59b74f5c:/perl.inc.pl?ds=inline
diff --git a/perl.inc.pl b/perl.inc.pl
index 543813f..449335b 100644
--- a/perl.inc.pl
+++ b/perl.inc.pl
@@ -1,9 +1,19 @@
use utf8;
+use strict;
+my $wbr = "\N{ZERO WIDTH SPACE}";
+{
+ v5.004 => {
+ release => '1997-05-15',
+ distro => {
+ debian => '2.0', # hamm 1998-07 to potato 2000-08 eol 2003-06
+ },
+ unstable => 0,
+ },
+
v5.005 => {
new => [
- ['threads' => '', {experimental => 0, stable => 0}],
+ ['lock
', 'obsolete Thread
implementation, including a keyword to place advisory locks on shared variables', {experimental => 0, stable => 0, dropped => v5.10}],
['B::â¦
', 'backend hooks'],
['qr//
' => 'overhauled regular expression engine: precompile operator, lookahead/behind, code, conditions, localised flags'],
['⦠foreach
' => 'for(each)
as statement modifier, with large ranges optimised as counting loops'],
@@ -15,19 +25,26 @@ use utf8;
['splice â¦,â¦,-$length
', 'negative length indicates elements to keep at the end of an array'],
['$/
', 'integer or scalar separator makes <>
read records instead of lines'],
],
+ modules => [
+ ['Data::Dumper' => 'stringify data structures'],
+ ['Errno' => 'system errno.h
constants'],
+ ['File::Spec'],
+ ['Fatal'],
+ ['Test'],
+ ],
release => '1998-07-22',
unstable => 0,
},
v5.6 => {
new => [
- ['use warnings
', 'pragma to enable warnings in lexical scope'],
- ['use utf8
', 'experimental unicode semantics (completed in v5.8)', {experimental => 0, stable => v5.8}],
+ ['use warnings
', 'pragma to enable warnings in lexical scope', {name => 'warnings'}],
+ ['use utf8
', 'experimental unicode semantics (completed in v5.8)', {name => 'utf8', experimental => 0, stable => v5.8}],
['use charnames
', 'string escape \N{}
to insert named character'],
['our
', 'declare global variables'],
['v1.2.3
', q"represent strings as vector of ordinals, useful in version numbers (printf '%vd'
to display)"],
['0b0
', q"binary numbers in literals, printf '%b'
, and oct
"],
- ['sub :lvalue
', 'subroutine attribute to return a modifiable value', {experimental => 0, stable => v5.20}],
+ ['sub :lvalue
', 'subroutine attribute to return a modifiable value', {name => 'sub_lvalue', experimental => 0, stable => v5.20}],
# ['sub :locked :method
', 'syntax to declare subroutine attributes'], # can be inferred from :lvalue support
['open my $fh, $mode, $expr
', 'file handles in scoped scalars, third argument for unambiguous file name'],
[q"pack 'q'
", '64-bit integer support (also large files >2GiB)', {experimental => 0, stable => v5.8.1}],
@@ -38,28 +55,42 @@ use utf8;
],
release => '2000-03-23',
distro => {
- debian => 'woody',
+ debian => '3.0', # woody 2002-07 eol 2006-06
rhel => '2', # v5.6.0; also in red hat 7.0
solaris => '9', # v5.6.1; 2002-05 eol 2014-10
aix => '5.1', # 2001-05 eol 2006-04
opensuse => '7.1', # 2001-01
},
+ versum => 'start of modern compatibility',
unicode => '3.0.1',
},
v5.8 => {
new => [
- [q"no utf8
", 'full unicode support, utf8
pragma only for script encoding'],
- [q"binmode $fh, ':perlio'
", 'file handle behaviour altered by PerlIO layers'],
+ [q"no utf8
", 'full unicode support, utf8
pragma only for script encoding', {name => 'utf8_data'}],
+ [q"use open
", 'file handle behaviour altered by PerlIO layers', {name => 'perlio', eg => 'binmode $fh, ":bytes"'}],
[q"open $fh, '-|', @cmd
", 'open list to fork a command without spawning a shell'],
[q"open $fh, '>', \$var
", 'perl scalars as virtual files'],
[q"printf '%1$s', @args
", 'syntax to use parameters out of order'],
[q"1_2_3 == 123
", 'underscores between digits allowed in numeric constants'],
-# [q"use if
", '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 Locale::*
and L18N::*
'],
+ ['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 => {
- debian => 'sarge',
+ debian => '3.1', # sarge 2005-06 eol 2008-03, v5.8.8 in etch 2007-04 eol 2010-02
rhel => '3', # v5.8.0; v5.8.8 in RHEL6 (2007-2014)
solaris => '10', # v5.8.4; 2005-01 eol 2021-01
centos => '3-5', # v5.8.0 in v3 (2004-03); v5.8.8 in v5 (eol 2017-03)
@@ -68,7 +99,8 @@ use utf8;
freebsd => '4-6',
opensuse => '8.1', # 2002-09 eol (SLES8 2002-10 eol 2007-12 ltss 2009-12)
},
- distrosum => "dinosaur platforms such as Solaris 10, AIX 5.2, RHEL 3, SLES 8",
+ distrosum => "RHEL 3, SLES 8, AIX 5/6 until 2017, Solaris 10 until 2021",
+ versum => 'stable minimum during 20[01]\d',
support => '2021-01', # solaris
unicode => '3.2.0',
},
@@ -78,7 +110,7 @@ use utf8;
['//
', 'defined-or operator'],
['~~
', 'smart-match operator to compare different data types (updated in v5.10.1)', {experimental => 'smartmatch'}],
['say
', 'print with newline, equivalent to print @_, "\n"
', {feature => 'say'}],
- ['given
', 'switch statement to smart-match with when
/default
', {feature => 'switch', experimental => 'smartmatch'}],
+ ['given
', 'switch statement to smart-match with when
/default
', {name => 'switch', feature => 'switch', experimental => 'smartmatch'}],
['/(?<name>)/
', 'named capture buffers into %+
'],
['/(?1)/
', 'recursive regular expression patterns'],
['/(?|)/
', 'resets capture numbering for each contained branch'],
@@ -87,7 +119,14 @@ use utf8;
['/p
', 'optionally preserve ${^MATCH}
variables (avoiding $&
penalty until COW in v5.20)'],
['/\v/, /\h/
', 'vertical and horizontal whitespace escapes (\V
\H
to invert); also /\R/
for newlines'],
['my $_
', 'lexically scoped version of the default variable', {experimental => 'lexical_topic', dropped => v5.23.4}],
- ['state
', 'persistent my
variables', {feature => 'state'}],
+ ['state
', 'persistent my
variables (scalars only until 5.28)', {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 => {
@@ -98,7 +137,8 @@ use utf8;
aix => '7.1', # v5.10.1 (2010-09 eol 2023-04)
opensuse => '11.0', # 2008-06 (SLES11 2009-03 eol 2019-03 ltss 2022-03)
},
- distrosum => "dinosaur platforms such as AIX 7.1, SLES 11, RHEL 6, Solaris 11",
+ distrosum => "SLES 11 until 2022, RHEL 6 until 2020 or commercially 2024, AIX 7.1 until 2023",
+ versum => "supported commercially until 2024",
support => '2024-11', # aix
unicode => '5.0.0',
},
@@ -111,6 +151,7 @@ use utf8;
['⦠when
', 'when
is now allowed to be used as a statement modifier'],
[q"use overload 'qr'
", 'customisable conversion to regular expressions'],
['/\N/
', 'inverse \n to match any character except newline regardless of /s
', {experimental => 0, stable => v5.18}],
+ ['each $ref
e.a.', 'array and hash container functions accept references', {experimental => 'autoderef', dropped => v5.23.1}],
],
release => '2010-04-12',
unicode => '5.2',
@@ -130,17 +171,21 @@ use utf8;
['/dalu
', 'regexp modifiers to restrict character classes: either default, ascii, locale, or unicode semantics.'],
[q"use re '/flags'
", 'customise default modifiers'],
['/(?^)/
', 'construct to reset to default modifiers'],
- ['each $ref
e.a.', 'array and hash container functions accept references', {experimental => 'postderef', dropped => v5.23.1}],
['FH->method
', 'filehandle method calls load IO::File on demand (eg. STDOUT->flush
)'],
['\o{}
', '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 LWP::UserAgent
overhead', {dropped => 0}],
+ # Unicode::Collate::Locale
+ ],
release => '2011-05-14',
distro => {
debian => '7', # wheezy 2013-05 eol 2018-05 elts 2020-06
ubuntu => '12.04',
opensuse => '12.1', # 2011-11 (SLES12 2014-10 eol 2024-10 ltss 2027-10)
},
- distrosum => "stable servers such as Debian 7, Ubuntu 12.04, CentOS 7",
+ distrosum => "Debian 7 until 2020, Ubuntu 12.04, SLES 12 until 2027",
support => '2027-10', # suse
unicode => '6.0+#8',
},
@@ -173,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',
},
@@ -192,7 +238,8 @@ use utf8;
aix => '7.2', # 2015-12 eol 2028?
opensuse => '13.2', # 2014-11 eol 2017-01
},
- distrosum => "legacy servers such as Debian 8, Ubuntu 14.10, FreeBSD 10, openSUSE 13.2, AIX 7.2",
+ distrosum => "Debian 8 until 2025, Ubuntu 14.10, openSUSE 13.2, AIX 7.2",
+ versum => "extended vendor support 202X",
},
v5.22 => {
@@ -205,6 +252,8 @@ use utf8;
[q"use re 'strict'
", 'apply stricter syntax rules to regular expression patterns', {experimental => 're_strict'}],
['0x.beep+0
', q"hexadecimal floating point notation with binary power; printf '%a'
to display"],
['??
', 'single match shorthand (deprecated since v5.14) requires the operator m?PATTERN?
'],
+ ['use CGI
' => 'deprecated interface for serving http requests removed from core'
+ .', see CGI::Alternatives', {name => 'cgi'}],
],
unicode => '7.0',
release => '2015-06-01',
@@ -235,6 +284,9 @@ use utf8;
['@{^CAPTURE}
', q"array of last match's captures, so ${^CAPTURE}[0]
is $1
"],
['//xx
', 'extended modifier to also ignore whitespace in bracketed character classes'],
],
+ modules => [
+ ['Test2::V0' => 'generic testing framework to replace Test::*
and TAP::*
'],
+ ],
unicode => '9.0', # also Script_Extensions/scx in "\p{script}"
release => '2017-05-30',
distro => {
@@ -251,7 +303,7 @@ use utf8;
['delete %hash{â¦}
', 'hash slices can be deleted with key+value pairs'],
['/(*â¦)/
', 'alphabetic synonyms for assertions, e.g. (*atomic:â¦)
for (?>â¦)
and (*nlb:â¦)
for (?<!â¦)
', {experimental => 'alpha_assertions', stable => v5.31.6}],
['/(*script_run:)/
', 'enforces all characters to be from the same script', {experimental => 'script_run', stable => v5.31.6}],
- ['state @a
', 'persistent lexical array or hash variables'],
+ ['state @a
', 'persistent lexical array or hash variables (in addition to scalars)', {name => 'state_ext'}],
['perl -i -pe die
', 'safe in-place editing: files are replaced only after successful completion'],
['${^SAFE_LOCALES}
', 'locales are thread-safe on supported systems, indicated by this variable'],
],
@@ -261,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",
},
@@ -269,13 +322,15 @@ use utf8;
new => [
['/(?<=var+)
', 'variable length lookbehind assertions', {experimental => 'vlb', stable => v5.36}],
['m(\p{nv=/.*/})
', 'match unicode properties by regular expressions', {experimental => 'uniprop_wildcards'}],
- ['my $state if 0
', 'workaround for state
(deprecated since v5.10!) is now prohibited'],
- [q"qr'\N'
", 'Delimiters must be graphemes; unescaped { illegal; \N in single quotes'],
+ ['my $state if 0
', 'workaround for state
(deprecated since v5.10!) is now prohibited'],
+ [q"qr'\N'
", 'Delimiters must be graphemes; unescaped {
illegal; \N
in single quotes'],
+ ['use Locale::Codes
', '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
},
},
@@ -283,7 +338,7 @@ use utf8;
new => [
['isa
', 'infix operator to check class instance', {feature => 'isa', experimental => 'isa', stable => v5.36}],
['$min < $_ <= $max
', 'chained comparison repeats inner part as $min < $_ and $_ <= $max
'],
- ['/\p{Name=$var}/
', 'match Unicode Name property like \N{} but with interpolation and subpatterns'],
+ ['/\p{Name=$var}/
', 'match Unicode Name property like \N{}
but with interpolation and subpatterns'],
[q"open F, '+>>', undef
", 'respect append mode on temporary files with mixed access'],
["no feature 'indirect'
", 'disable indirect object notation such as new Class
instead of Class->new
'],
['streamzip', 'program distributed with core IO::Compress::Base to compress stdin into a zip container'],
@@ -321,20 +376,36 @@ use utf8;
new => [
['use v5.36
', "use warnings
; use feature qw'signatures isa
'; no feature qw'indirect multidimensional switch
'"],
['use builtin
', 'namespace for interpreter functions, such as weaken
and blessed
from Scalar::Util
, ceil
/floor
from POSIX
, and trim
like String::Util
', {experimental => 'builtin'}],
- ['is_bool(!0)
', 'distinguish scalar variable types (by builtin
functions) for data interoperability'],
+ ['is_bool(!0)
', 'distinguish scalar variable types (by builtin
functions) for data interoperability', {name => 'is_bool'}],
['for my ($k, $v) (%hash)
', 'iterate over multiple values at a time (including builtin::indexed
for arrays)', {experimental => 'for_list', feature => 'for_list'}],
['defer {}
', 'queue code to be executed when going out of scope', {feature => 'defer', experimental => 'defer'}],
- ['try {} finally {}
', 'run code at the end of a try
construct regardless of failure', {feature => 'try', experimental => 'try'}],
+ ['try {} finally {}
', 'run code at the end of a try
construct regardless of failure', {name => 'finally', feature => 'try', experimental => 'try'}],
['q«â¦Â»
', 'unicode delimiters for quoting operators', {experimental => 'extra_paired_delimiters'}],
- ['sub ($var) {!pop}
', 'signatured subs are stable, but mixing with the arguments array @_
remains experimental', {feature => 'signatures', experimental => 'args_array_with_signatures'}],
- ['$SIG{FPE}
', 'floating-point exceptions no longer deferred but delivered immediately like other signals'],
+ ['sub ($var) {!pop}
', 'signatured subs are stable, but mixing with the arguments array @_
remains experimental', {feature => 'signatures', experimental => 'args_array_with_signatures'}],
+ ['$SIG{FPE}
', 'floating-point exceptions no longer deferred but delivered immediately like other signals', {name => 'sig_fpe'}],
['perl -g
', 'disable input record separator (slurp mode), alias for -0777
'],
],
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 => [
+ ['use feature "module_true"
', 'default in use 5.37 and up, also no feature "bareword_filehandles"
'],
+ ['sub ($var ||=
default)
', 'assign values when false (or undefined on //=
) instead of omitted'],
+ ['/(*{ ⦠})/
', 'optimistic eval: (?{ ⦠})
with regex optimisations enabled'],
+ ['class
', "define object classes: packages with field
variables and method
subroutines", {feature => 'class', experimental => 'class'}],
+ ['${^LAST_SUCCESSFUL_PATTERN}
', 'explicit variable to access the previous match as in s//â¦/
'],
+ ['%{^HOOK}
', "perform tasks require__before
and require__after
when calling require
"], # also @INC hook enhancements
+ ['PERL_RAND_SEED
', 'environment variable to set srand
random number seed', {dropped => 0}],
+ ['is_tainted
', 'builtin
function to check variable tainting like Scalar::Util::tainted
', {dropped => 0, experimental => 'builtin', eg => 'builtin::is_tainted($ENV{PWD}) and say "running perl -T"'}],
+ ['export_lexically
', 'builtin
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',
+ },
}