source: recognise [sample] text include references

[sheet.git] / perl.plp

diff --git a/perl.plp b/perl.plp
index f60a0be6a36955683eb3ec2f19bec46211938b9a..a5ef991145750b9fbcb617837a58b5e481059a3a 100644 (file)
--- a/perl.plp
+++ b/perl.plp
@@ -2,7 +2,7 @@
 
 Html({
        title => 'perl version cheat sheet',
-       version => 'v1.0',
+       version => '1.2',
        keywords => [qw'
                perl version feature features comparison
                sheet cheat overview summary
@@ -12,16 +12,50 @@ Html({
 });
 
 :>
-<h1>Perl cheat sheets</h1>
+<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>
 
 <:
 my $info = do 'perl.inc.pl' or die $@ // $!;
 for my $vernum (reverse sort keys %{$info}) {
        my $verrow = $info->{$vernum};
-       print '<div class="section">'."\n";
-       printf '<h2>%vd <small style="position:absolute; margin-left:1em">%s</small></h2><dl>'."\n", $vernum, $verrow->{release};
-       printf '<dt><code>%s</code><dd>%s', Entity(@{$_}), '<br/>' for @{ $verrow->{new} };
-       print "</dl>\n";
-       print "</div>\n\n";
+       defined $verrow->{unstable} and next unless exists $get{v};
+
+       say '<div class="section">';
+       say sprintf '<h2>%vd <small>%s</small></h2><dl>', $vernum, $verrow->{release};
+       for (@{ $verrow->{new} }) {
+               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 ($attr->{feature}) {
+                               $title = sprintf('<span title="%s">feature</span>', $attr->{feature})
+                                       . (defined $title && ", $title");
+                       }
+                       $desc .= sprintf ' <em class="ex">(%s)</em>', $title;
+               }
+               say sprintf '<dt>%s<dd>%s', $topic, $desc || '<br/>';
+       }
+       say sprintf '<dt>Unicode</dt><dd>v%s', $_ for $verrow->{unicode} || ();
+       say '</dl>';
+       say "</div>\n";
 }