X-Git-Url: http://git.shiar.nl/sheet.git/blobdiff_plain/bb06ade4941ab8a981256d06b1d1a36a5564c690..325da7e90ea83a856317d84934141a5313716194:/perl.plp

diff --git a/perl.plp b/perl.plp
index b1ea1c7..57a7dc8 100644
--- a/perl.plp
+++ b/perl.plp
@@ -33,24 +33,41 @@ eval {
 	use Time::Seconds;
 
 	my $now = Time::Piece->new;
-	$now = $now->strptime($_, '%Y-%m-%d') for $get{at} // ();
+	if (my $ts = $get{at}) {
+		$now = $now->strptime($ts, '%Y-%m-%d');
+		say "Compatibility details emulated for <em>$ts</em>.";
+	}
+	my $ts = $now->strftime('%F');
+	my @versions = sort grep { $info->{$_}{release} le $ts } keys %{$info};
+
+	# 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 +79,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) = @{$_};
@@ -81,15 +100,27 @@ for my $vernum (reverse sort keys %{$info}) {
 			if ($attr->{experimental}) {
 				$title = sprintf '<span title="experimental::%s">%s</span>',
 					$attr->{experimental}, $title;
+				$attr->{name} //= $attr->{experimental};
 			}
 			if ($attr->{feature}) {
 				my $prefix = sprintf '<span title="%s">feature</span>',
 					$attr->{feature};
 				$title = join ', ', $prefix, $title // ();
+				$attr->{name} //= $attr->{feature};
 			}
-			$desc .= sprintf ' <em class="ex">(%s)</em>', $title;
+			$desc .= sprintf ' <em class="ex">(%s)</em>', $title if $title;
+		}
+		my $ref = defined $attr->{name} && sprintf ' id="%s"', $attr->{name};
+		say sprintf '<dt%s>%s<dd>%s', $ref, $topic, $desc || '<br/>';
+	}
+	if (my $mods = $verrow->{modules}) {
+		for (@{$mods}) {
+			my ($name, $desc, $eg) = @{$_};
+			my $ref = lc $name =~ s/::/_/gr;
+			$desc .= sprintf ' <small>{<code>%s</code>}</small>', Entity($_) for $eg // ();
+			printf '<dt id="%s"><code>use %s</code>', $ref, $name;
+			say '<dd>', $desc;
 		}
-		say sprintf '<dt>%s<dd>%s', $topic, $desc || '<br/>';
 	}
 	say sprintf '<dt>Unicode</dt><dd>v%s', $_ for $verrow->{unicode} || ();
 	say '</dl>';