perl: links between features and later references

diff --git a/perl.inc.pl b/perl.inc.pl
index 1291ceb12a1ae1ec9b543be0484421cb6a024c16..e010b2656ba43b96f505720e8f931ee64917e540 100644 (file)
--- a/perl.inc.pl
+++ b/perl.inc.pl
@@ -212,7 +212,7 @@ my $wbr = "\N{ZERO WIDTH SPACE}";
                        ['<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'],
                        ['<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>'],
+                       [q"<code>no warnings 'experimental::…'</code>", 'mechanism for experimental features, as of now required for <a href="#switch">smartmatch</a>'],

                ],
                release => '2013-05-18',
                distro => {
                ],
                release => '2013-05-18',
                distro => {


@@ -245,7 +245,7 @@ my $wbr = "\N{ZERO WIDTH SPACE}";
        v5.22 => {
                new => [
                        ['<code>\$alias =</code>', 'aliasing via reference (scoped as of v5.25.3)', {experimental => 'refaliasing'}],
        v5.22 => {
                new => [
                        ['<code>\$alias =</code>', 'aliasing via reference (scoped as of v5.25.3)', {experimental => 'refaliasing'}],

-                       ['<code>&lt;&lt;>></code>', 'safe <code>readline</code> ignoring open flags in arguments'],
+                       ['<code>&lt;&lt;…>></code>', 'safe <code>readline</code> ignoring open flags in arguments'],

                        ['<code>/()/n</code>', 'flag to disable numbered capturing, turning <code>()</code> into <code>(?:)</code>'],
                        ['<code>/\b{}/</code>', 'boundary types: <em>gcb</em> (grapheme cluster), <em>sb</em> (sentence), <em>wb</em> (word)'],
                        ['<code>&.</code>', '<code>& | ^ ~</code> consistently numeric, dotted operators for strings', {feature => 'bitwise', experimental => 'bitwise', stable => v5.28}],
                        ['<code>/()/n</code>', 'flag to disable numbered capturing, turning <code>()</code> into <code>(?:)</code>'],
                        ['<code>/\b{}/</code>', 'boundary types: <em>gcb</em> (grapheme cluster), <em>sb</em> (sentence), <em>wb</em> (word)'],
                        ['<code>&.</code>', '<code>& | ^ ~</code> consistently numeric, dotted operators for strings', {feature => 'bitwise', experimental => 'bitwise', stable => v5.28}],


@@ -340,7 +340,7 @@ my $wbr = "\N{ZERO WIDTH SPACE}";
                        ['<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 <code>\N{}</code> but with interpolation and subpatterns'],
                        [q"<code>open F, '+&gt;&gt;', undef</code>", 'respect append mode on temporary files with mixed access'],
                        ['<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 <code>\N{}</code> but with interpolation and subpatterns'],
                        [q"<code>open F, '+&gt;&gt;', undef</code>", 'respect append mode on temporary files with mixed access'],

-                       ["<code>no feature 'indirect'</code>", 'disable indirect object notation such as <code>new Class</code> instead of <code>Class-&gt;new</code>'],
+                       ["<code>no feature 'indirect'</code>", 'disable indirect object notation such as <code>new Class</code> instead of <code>Class-&gt;new</code>, enforced since use <a href="#v5036">5.36</a>', {name => 'indirect'}],

                        ['streamzip', 'program distributed with core IO::Compress::Base to compress stdin into a zip container'],
                ],
                unicode => '13.0',
                        ['streamzip', 'program distributed with core IO::Compress::Base to compress stdin into a zip container'],
                ],
                unicode => '13.0',


@@ -363,7 +363,7 @@ my $wbr = "\N{ZERO WIDTH SPACE}";
                        ['<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(${wbr}qr//)</code>", 'debug regular expression optimization information discovered at compile time'],
                        ['<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(${wbr}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'],
+                       ['<code>no feature …</code>', 'disable discouraged practices of <code>multidimensional</code> and <code>bareword_filehandles</code> array emulation, applied in <a href="#v5036">5.36</a> and <a href="#v5038">5.38</a>', {name => 'feature_534'}],

                ],
                release => '2021-05-20',
                distro => {
                ],
                release => '2021-05-20',
                distro => {


@@ -374,7 +374,7 @@ my $wbr = "\N{ZERO WIDTH SPACE}";
 
        v5.36 => {
                new => [
 
        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 v5.36</code>', q{use <code><a href="#warnings">warnings</a></code>; use feature qw'<code><a href="#signature">signatures</a> <a href="#isa">isa</a></code>'; no feature qw'<code><a href="#indirect">indirect</a> <a href="#feature_534">multidimensional</a> <a href="#switch">switch</a></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', 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', stable => v5.40}],
                        ['<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', stable => v5.40}],


@@ -395,7 +395,7 @@ my $wbr = "\N{ZERO WIDTH SPACE}";
 
        v5.38 => {
                new => [
 
        v5.38 => {
                new => [

-                       ['<code>use feature "module_true"</code>', 'default in use 5.37 and up, also <code>no feature "bareword_filehandles"</code>'],
+                       ['<code>use feature "module_true"</code>', 'default in use 5.37 and up, also <code>no feature "<a href="#feature_534">bareword_filehandles</a>"</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>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'}],