Document that use feature 'defer' is still experimental

Perl · May 24, 2022 · fd5e27c · fd5e27c
1 parent cb47076
commit fd5e27c
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 0 deletions.
diff --git a/lib/feature.pm b/lib/feature.pm
diff --git a/regen/feature.pl b/regen/feature.pl
@@ -855,6 +855,12 @@ =head2 The 'try' feature.
 
 =head2 The 'defer' feature
 
+B<WARNING>: This feature is still experimental and the implementation may
+change or be removed in future versions of Perl.  For this reason, Perl will
+warn when you use the feature, unless you have explicitly disabled the warning:
+
+    no warnings "experimental::defer";
+
 This feature enables the C<defer> block syntax, which allows a block of code
 to be deferred until when the flow of control leaves the block which contained
 it. For more details, see L<perlsyn/defer>.