document the postderef feature in feature.pm

(cherry picked from commit f86d720ebb7ad53ce8b1c12cee66586eabffe0c8)

[Edited by the committer to bump the $VERSION to a value that has not
already been used in a blead release and will not be used in a future
blead release.]

1 files changed, 22 insertions, 1 deletions

diff --git a/regen/feature.pl b/regen/feature.pl
index fccfc2da16..cb2fc40ea0 100755..100644
--- a/regen/feature.pl
+++ b/regen/feature.pl
@@ -361,7 +361,7 @@ read_only_bottom_close_and_rename($h);
 __END__
 package feature;
 
-our $VERSION = '1.36';
+our $VERSION = '1.36_01';
 
 FEATURES
 
@@ -561,6 +561,27 @@ and C<our sub foo> syntax.  See L<perlsub/Lexical Subroutines> for details.
 
 This feature is available from Perl 5.18 onwards.
 
+=head2 The 'postderef' and 'postderef_qq' features
+
+B<WARNING>: This feature is still experimental and the implementation may
+change 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::postderef";
+
+The 'postderef' feature allows the use of L<postfix dereference
+syntax|perlref/Postfix Dereference Syntax>.  For example, it will make the
+following two statements equivalent:
+
+  my @x = @{ $h->{a} };
+  my @x = $h->{a}->@*;
+
+The 'postderef_qq' feature extends this, for array and scalar dereference, to
+working inside of double-quotish interpolations.
+
+This feature is available from Perl 5.20 onwards.
+
 =head2 The 'signatures' feature
 
 B<WARNING>: This feature is still experimental and the implementation may