Html({
title => 'perl version cheat sheet',
- version => '1.1',
+ version => '1.4',
keywords => [qw'
perl version feature features comparison
sheet cheat overview summary
:>
<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, AIX 5.2, 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;
+ my $coreeol = ($now - ONE_YEAR * 3)->strftime('%F');
+ my $vcore = first { $info->{$_}{release} ge $coreeol } sort keys %{$info};
+ say "<p>Core security support is provided for 3 years",
+ ", so typical users should run at least $_."
+ for linkversion($vcore);
+
+ 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 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";
}