v5.8 => {
new => [
[q"<code>no utf8</code>", 'full unicode support, <code>utf8</code> pragma only for script encoding', {name => 'utf8_data'}],
- [q"<code>binmode $fh, ':perlio'</code>", 'file handle behaviour altered by PerlIO layers', {name => 'perlio'}],
+ [q"<code>use open</code>", 'file handle behaviour altered by PerlIO layers', {name => 'perlio', eg => 'binmode $fh, ":bytes"'}],
[q"<code>open $fh, '-|', @cmd</code>", 'open list to fork a command without spawning a shell'],
[q"<code>open $fh, '>', \$var</code>", 'perl scalars as virtual files'],
[q"<code>printf '%1$s', @args</code>", 'syntax to use parameters out of order'],
}
if (my $mods = $verrow->{modules}) {
for (@{$mods}) {
- my ($name, $desc, $eg) = @{$_};
+ my ($name, $desc, $attr) = @{$_};
my $ref = lc $name =~ s/::/_/gr;
- $desc .= sprintf ' <small>{<code>%s</code>}</small>', Entity($_) for $eg // ();
+ $desc .= featattrs($attr);
printf '<dt id="%s"><code>use %s</code>', $ref, $name;
say '<dd>', $desc;
}
}
sub featattrs ($attr) {
+ $attr or return '';
+ ref $attr or $attr = {eg => $attr};
my $title;
if (defined $attr->{experimental}) {
$title = 'experimental';
$title = join ', ', $prefix, $title // ();
$attr->{name} //= $attr->{feature};
}
- return sprintf ' <em class="ex">(%s)</em>', $title if $title;
- return '';
+ $title = $title ? sprintf ' <em class="ex">(%s)</em>', $title : '';
+
+ if (my $eg = $attr->{eg}) {
+ my $pre = sprintf ' <small>{<code>%s</code>}</small>', Entity($eg);
+ $title = $pre . $title;
+ }
+ return $title;
}