Document "no feature" (Michael G Schwern)

p4raw-id: //depot/perl@29819

diff --git a/lib/feature.pm b/lib/feature.pm
index 39eaf8e..fde2e6a 100644 (file)
--- a/lib/feature.pm
+++ b/lib/feature.pm
@@ -46,7 +46,7 @@ scope.
 =head2 Lexical effect
 
 Like other pragmas (C<use strict>, for example), features have a lexical
-effect.  C<use feature qw(foo)> will only make the feature "foo" available
+effect. C<use feature qw(foo)> will only make the feature "foo" available
 from that point to the end of the enclosing block.
 
     {
@@ -55,6 +55,21 @@ from that point to the end of the enclosing block.
     }
     print "But not here.\n";
 
+=head2 C<no feature>
+
+Features can also be turned off by using C<no feature "foo">. This too
+has lexical effect.
+
+    use feature 'say';
+    say "say is available here";
+    {
+        no feature 'say';
+        print "But not here.\n";
+    }
+    say "Yet it is here.";
+
+C<no feature> with no features specified will turn off all features.
+
 =head2 The 'switch' feature
 
 C<use feature 'switch'> tells the compiler to enable the Perl 6