perl: summarise v5.36 release notes

diff --git a/perl.inc.pl b/perl.inc.pl
index 9d416eb4de5b626a6f7eb6f651e15f8b03375900..caaf912d6f51ea34dc6b682934943521b575f1b8 100644 (file)
--- a/perl.inc.pl
+++ b/perl.inc.pl
@@ -159,7 +159,7 @@ use utf8;
        v5.18 => {
                new => [
                        ['<code>${^LAST_FH}</code>', 'last read filehandle (used by <code>$.</code>)'],
-                       ['<code>/(?[ a + b ])/</code>', 'regex set operations (character substraction <code>-</code>, unions <code>&amp;</code>)', {experimental => 'regex_sets'}],
+                       ['<code>/(?[ a + b ])/</code>', 'regex set operations (character subtraction <code>-</code>, union <code>+</code>, intersection <code>&amp;</code>, xor <code>^</code>)', {experimental => 'regex_sets', stable => v5.36}],
                        ['<code>my sub</code>', 'lexical subroutines (also <code>state</code>, <code>our</code>); buggy before v5.22', {experimental => 'lexical_subs', stable => v5.26}],
                        ['<code>next $expression</code>', 'loop controls allow runtime expressions'],
                        [q"<code>no warnings 'experimental::…'</code>", 'mechanism for experimental features, as of now required for <em>smartmatch</em>'],
@@ -174,7 +174,7 @@ use utf8;
 
        v5.20 => {
                new => [
-                       ['<code>sub ($var)</code>', 'subroutine signatures', {feature => 'signatures', experimental => 'signatures'}],
+                       ['<code>sub ($var)</code>', 'subroutine signatures', {feature => 'signatures', experimental => 'signatures', stable => v5.36}],
                        ['<code>%hash{…}</code>', 'hash slices return key+value pairs'],
                        ['<code>[]->@*</code>', 'postfix dereferencing (also e.g. <code>$scalar->$*</code> for <code>$$scalar</code>)', {feature => 'postderef, postderef_qq', experimental => 'postderef', stable => v5.23.1}],
                        [q"<code>use warnings 'once'; $a</code>", 'variables $a and $b are exempt from <em>used once</em> warnings'],
@@ -242,7 +242,7 @@ use utf8;
                        ['<code>/(*…)/</code>', 'alphabetic synonyms for assertions, e.g. <code>(*atomic:…)</code> for <code>(?&gt;…)</code> and <code>(*nlb:…)</code> for <code>(?&lt;!…)</code>', {experimental => 'alpha_assertions', stable => v5.31.6}],
                        ['<code>/(*script_run:)/</code>', 'enforces all characters to be from the same script', {experimental => 'script_run', stable => v5.31.6}],
                        ['<code>state @a</code>', 'persistent lexical array or hash variables'],
-                       ['<code>perl -i -pe die</code>', 'safe in-place editing: files are replaced only after successful completion'],
+                       ['perl<code> -i -pe die</code>', 'safe in-place editing: files are replaced only after successful completion'],
                        ['<code>${^SAFE_LOCALES}</code>', 'locales are thread-safe on supported systems, indicated by this variable'],
                ],
                unicode => '10.0',
@@ -253,7 +253,7 @@ use utf8;
 
        v5.30 => {
                new => [
-                       ['<code>/(?<=var+)</code>', 'variable length lookbehind assertions', {experimental => 'vlb'}],
+                       ['<code>/(?<=var+)</code>', 'variable length lookbehind assertions', {experimental => 'vlb', stable => v5.36}],
                        ['<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>state</code> (deprecated since v5.10!) is now prohibited'],
                        [q"<code>qr'\N'</code>", 'Delimiters must be graphemes; unescaped { illegal; \N in single quotes'],
@@ -264,7 +264,7 @@ use utf8;
 
        v5.32 => {
                new => [
-                       ['<code>isa</code>', 'infix operator to check class instance'],
+                       ['<code>isa</code>', 'infix operator to check class instance', {feature => 'isa', experimental => 'isa', stable => v5.36}],
                        ['<code>$min &lt; $_ &lt;= $max</code>', 'chained comparison repeats inner part as <code>$min &lt; $_ and $_ &lt;= $max</code>'],
                        ['<code>/\p{Name=$var}/</code>', 'match Unicode Name property like \N{} but with interpolation and subpatterns'],
                        [q"<code>open F, '+&gt;&gt;', undef</code>", 'respect append mode on temporary files with mixed access'],
@@ -278,12 +278,29 @@ use utf8;
 
        v5.34 => {
                new => [
-                       ['<code>try {} catch</code>', 'exception handling similar to eval blocks', {experimental => 'try'}],
+                       ['<code>try {} catch</code>', 'exception handling similar to eval blocks', {feature => 'try', experimental => 'try'}],
                        ['<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>'],
                        ['<code>re::optimization(qr//)</code>', 'debug regular expression optimization information discovered at compile time'],
+                       ['<code>no feature …</code>', 'disable discouraged practices of <code>bareword_filehandles</code> and <code>multidimensional</code> array emulation'],
                ],
                release => '2021-05-20',
        },
+       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>is_bool(!0)</code>', 'distinguish scalar variable types (by <code>builtin</code> functions) for data interoperability'],
+                       ['<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>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>try</code> construct regardless of failure', {feature => 'try', experimental => 'try'}],
+                       ['<code>q«…»</code>', 'unicode delimiters for quoting operators', {experimental => 'extra_paired_delimiters'}],
+                       ['<code>sub ($var) {!<s>pop</s>}</code>', 'signatured 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'],
+                       ['perl<code> -g</code>', 'disable input record separator (slurp mode), alias for <code>-0777</code>'],
+               ],
+               unicode => '14.0',
+               release => '2022-05-28',
+       },
 }