Document that use feature 'defer' is still experimental

2 files changed, 12 insertions, 0 deletions

diff --git a/lib/feature.pm b/lib/feature.pm
index c16f0e4557..a73bca6e61 100644
--- a/lib/feature.pm
+++ b/lib/feature.pm
@@ -445,6 +445,12 @@ For more information, see L<perlsyn/"Try Catch Exception Handling">.
 
 =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>.
diff --git a/regen/feature.pl b/regen/feature.pl
index 88530097a2..ee54ed953a 100755
--- a/regen/feature.pl
+++ b/regen/feature.pl
@@ -855,6 +855,12 @@ For more information, see L<perlsyn/"Try Catch Exception Handling">.
 
 =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>.