perl: version descriptions after release dates

[sheet.git] / perl.plp

diff --git a/perl.plp b/perl.plp
index b1ea1c760501c25df2c2819ee744a9e8f4dd15fa..99863ff4ed625fed79754b1f543c885174ad92aa 100644 (file)
--- a/perl.plp
+++ b/perl.plp
@@ -32,25 +32,38 @@ eval {
        use Time::Piece;
        use Time::Seconds;
 
+       my @versions = sort keys %{$info};
        my $now = Time::Piece->new;
        $now = $now->strptime($_, '%Y-%m-%d') for $get{at} // ();
 
+       # perlpolicy: «We "officially" support the two most recent stable release
+       # series. [...] we will attempt to fix critical issues»
+       $info->{ $versions[-2] }{versum} //= "active core support";
+       $info->{ $versions[-1] }{versum} //= "latest stable release";
+
+       # perlpolicy: «we will attempt to fix critical issues in the two most
+       # recent stable 5.x release series»
        my $coreeol = ($now - ONE_YEAR * 3)->strftime('%F');
-       my $vcore = first { $info->{$_}{release} ge $coreeol } sort keys %{$info};
+       my $vcore = first { $info->{$_}{release} ge $coreeol } @versions;
        print "<p>Core security support is provided for 3 years";
        print ", so typical users should run at least ", linkversion($_)
                for $vcore // ();
        say '.';
+       $info->{$vcore}{versum} //= "official security patches";
 
+       # «We encourage vendors to ship the most recent supported release of Perl
+       # at the time of their code freeze» with debian&ubuntu having 5 years LTS
        my $vendoreol = ($now - ONE_YEAR * 5)->strftime('%F');
        my $vdebian = first {
                $info->{$_}{release} ge $vendoreol && $info->{$_}{distro}{debian}
-       } sort keys %{$info};
+       } @versions;
        say sprintf "Stable distributions such as Debian %s maintain %s+.",
                $info->{$_}{distro}{debian}, linkversion($_) for $vdebian // ();
+       $info->{$vdebian}{versum} //= "still maintained by common vendors";
 
+       # extended support given at random
        my $nowcmp = $now->strftime('%F');
-       my $vdino = first { $info->{$_}{support} ge $nowcmp } sort keys %{$info};
+       my $vdino = first { $info->{$_}{support} ge $nowcmp } @versions;
        say "Enterprise platforms retain versions up to $_."
                for map { linkversion($_) } $vdino // ();
        return 1;
@@ -62,7 +75,9 @@ for my $vernum (reverse sort keys %{$info}) {
        defined $verrow->{unstable} and next unless exists $get{v};
 
        say sprintf '<div class="section" id="%s">', vname($vernum);
-       say sprintf '<h2>%vd <small>%s</small></h2>', $vernum, $verrow->{release};
+       my $title = $verrow->{release} // '?';
+       $title .= ": $_" for $verrow->{versum} // ();
+       say sprintf '<h2>%vd <small>%s</small></h2>', $vernum, $title;
        say '<dl>';
        for (@{ $verrow->{new} }) {
                my ($topic, $desc, $attr) = @{$_};