This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl5db] Get rid of leading ampersands.
[perl5.git] / lib / feature.pm
index 8afd53f..46b43a8 100644 (file)
@@ -5,7 +5,7 @@
 
 package feature;
 
-our $VERSION = '1.30';
+our $VERSION = '1.31';
 
 our %feature = (
     fc              => 'feature_fc',
@@ -230,6 +230,20 @@ See L<perlfunc/fc> for details.
 
 This feature is available from Perl 5.16 onwards.
 
+=head2 The 'lexical_subs' feature
+
+B<WARNING>: This feature is still experimental and the implementation may
+change in future versions of Perl.  For this reason, F<feature.pm> will
+warn when you enable the feature, unless you have explicitly disabled the
+warning:
+
+    no warnings "experimental::lexical_subs";
+
+This enables declaration of subroutines via C<my sub foo>, C<state sub foo>
+and C<our sub foo> syntax.  See L<perlsub/Lexical Subroutines> for details.
+
+This feature is available from Perl 5.18 onwards.
+
 =head1 FEATURE BUNDLES
 
 It's possible to load multiple features together, using
@@ -368,7 +382,7 @@ sub __common {
            $^H |= $hint_uni8bit if $name eq 'unicode_strings';
            if ($experimental{$name}) {
                require warnings;
-               warnings::warnif("experimental:$name",
+               warnings::warnif("experimental::$name",
                                 "The $name feature is experimental");
            }
        } else {