X-Git-Url: http://git.shiar.net/sheet.git/blobdiff_plain/3f2e8ba4921b56a70b889858772731fb92ef9847..bb06ade4941ab8a981256d06b1d1a36a5564c690:/perl.plp

diff --git a/perl.plp b/perl.plp
index 9591ad7..b1ea1c7 100644
--- a/perl.plp
+++ b/perl.plp
@@ -2,7 +2,7 @@
 
 Html({
 	title => 'perl version cheat sheet',
-	version => '1.1',
+	version => '1.4',
 	keywords => [qw'
 		perl version feature features comparison
 		sheet cheat overview summary
@@ -14,42 +14,85 @@ Html({
 :>
 <h1>Perl release summary</h1>
 
-<p>The most significant features introduced for recent versions of the Perl scripting language.
-Depending on desired compatibility you'll want to support a minimum of
-<span title="on dinosaur platforms such as Solaris 10, RHEL 3, SLES 8">v5.8</span> or
-<span title="on stable servers such as Debian wheezy, Ubuntu 12.04, CentOS 7">v5.14</span>.
-</p>
-
+<p>The most significant features introduced for recent versions of the Perl
+scripting language.
 <:
-my $info = do 'perl.inc.pl' or die $@ // $!;
+my $info = Data('perl');
+
+use feature 'signatures';
+sub vname ($v) {
+	return sprintf 'v%d%03d', unpack 'C*', $v;
+}
+sub linkversion ($v) {
+	return showlink(sprintf('%vd', $v), '#'.vname($v));
+}
+
+eval {
+	use List::Util 'first';
+	use Time::Piece;
+	use Time::Seconds;
+
+	my $now = Time::Piece->new;
+	$now = $now->strptime($_, '%Y-%m-%d') for $get{at} // ();
+
+	my $coreeol = ($now - ONE_YEAR * 3)->strftime('%F');
+	my $vcore = first { $info->{$_}{release} ge $coreeol } sort keys %{$info};
+	print "<p>Core security support is provided for 3 years";
+	print ", so typical users should run at least ", linkversion($_)
+		for $vcore // ();
+	say '.';
+
+	my $vendoreol = ($now - ONE_YEAR * 5)->strftime('%F');
+	my $vdebian = first {
+		$info->{$_}{release} ge $vendoreol && $info->{$_}{distro}{debian}
+	} sort keys %{$info};
+	say sprintf "Stable distributions such as Debian %s maintain %s+.",
+		$info->{$_}{distro}{debian}, linkversion($_) for $vdebian // ();
+
+	my $nowcmp = $now->strftime('%F');
+	my $vdino = first { $info->{$_}{support} ge $nowcmp } sort keys %{$info};
+	say "Enterprise platforms retain versions up to $_."
+		for map { linkversion($_) } $vdino // ();
+	return 1;
+} or Alert('Missing version recommendations', $@);
+say '</p>';
+
 for my $vernum (reverse sort keys %{$info}) {
 	my $verrow = $info->{$vernum};
-	$verrow->{unstable} and next unless exists $get{v};
+	defined $verrow->{unstable} and next unless exists $get{v};
 
-	print '<div class="section">'."\n";
-	printf '<h2>%vd <small>%s</small></h2><dl>'."\n", $vernum, $verrow->{release};
+	say sprintf '<div class="section" id="%s">', vname($vernum);
+	say sprintf '<h2>%vd <small>%s</small></h2>', $vernum, $verrow->{release};
+	say '<dl>';
 	for (@{ $verrow->{new} }) {
-		if (defined (my $experimental = $_->[2])) {
-			my $title = 'experimental';
-			my $class = ' class="ex"';
-			if (ref \$experimental eq 'VSTRING') {
-				my $dropped = $experimental =~ s/^\0//
-					and (exists $get{v} or next);
-				$title = sprintf('%s %vd',
-					$dropped ? 'removed in ' : "$title until",
-					$experimental,
-				);
-				$experimental = $_->[3];  # optional additional class
+		my ($topic, $desc, $attr) = @{$_};
+		if ($attr) {
+			my $title;
+			if (defined $attr->{experimental}) {
+				$title = 'experimental';
+			}
+			if ($attr->{dropped}) {
+				next unless exists $get{v};
+				$title = sprintf 'removed in %vd', $attr->{dropped};
+			}
+			elsif ($attr->{stable}) {
+				$title .= sprintf ' until %vd', $attr->{stable};
+			}
+			if ($attr->{experimental}) {
+				$title = sprintf '<span title="experimental::%s">%s</span>',
+					$attr->{experimental}, $title;
 			}
-			if ($experimental) {
-				$class .= sprintf ' title="%s"', $experimental;
+			if ($attr->{feature}) {
+				my $prefix = sprintf '<span title="%s">feature</span>',
+					$attr->{feature};
+				$title = join ', ', $prefix, $title // ();
 			}
-			$_->[1] .= qq{ <em$class>($title)</em>};
+			$desc .= sprintf ' <em class="ex">(%s)</em>', $title;
 		}
-		printf '<dt>%s<dd>%s'."\n", @{$_}, '<br/>'
+		say sprintf '<dt>%s<dd>%s', $topic, $desc || '<br/>';
 	}
-	printf '<dt>Unicode</dt><dd>v%s'."\n", $_ for $verrow->{unicode} || ();
-	print "</dl>\n";
-	print "</div>\n\n";
+	say sprintf '<dt>Unicode</dt><dd>v%s', $_ for $verrow->{unicode} || ();
+	say '</dl>';
+	say "</div>\n";
 }