feature: document feature bundle ':all' and why you don't use it

Fixes Perl#17209
tonycoz · Sep 21, 2023 · a75216f · a75216f
1 parent 1c5a7c5
commit a75216f
Show file tree

Hide file tree

Showing 2 changed files with 28 additions and 2 deletions.
diff --git a/lib/feature.pm b/lib/feature.pm
diff --git a/regen/feature.pl b/regen/feature.pl
@@ -538,7 +538,7 @@ sub longest {
 
 __END__
 package feature;
-our $VERSION = '1.84';
+our $VERSION = '1.85';
 
 FEATURES
 
@@ -1372,6 +1372,19 @@ =head1 FEATURE BUNDLES
   use feature ":5.14.0";    # same as ":5.14"
   use feature ":5.14.1";    # same as ":5.14"
 
+You can also do:
+
+  use feature ":all";
+
+or
+
+  no feature ":all";
+
+but the first may enable features in a later version of Perl that
+change the meaning of your code, and the second may disable mechanisms
+that are part of Perl's current behavior that have been turned into
+features, just as C<indirect> and C<bareword_filehandles> were.
+
 =head1 IMPLICIT LOADING
 
 Instead of loading feature bundles by name, it is easier to let Perl do