+=head2 The 'declared_refs' feature++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::declared_refs";++This allows a reference to a variable to be declared with C<my>, C<state>,+our C<our>, or localized with C<local>. It is intended mainly for use in+conjunction with the "refaliasing" feature. See L<perlref/Declaring a+Reference to a Variable> for examples.++This feature is available from Perl 5.26 onwards.+ =head1 FEATURE BUNDLES

+=item Declaring references is experimental++(S experimental::declared_refs) This warning is emitted if you use+a reference constructor on the right-hand side of C<my>, C<state>, C<our>, or+C<local>. Simply suppress the warning if you want to use the feature, but+know that in doing so you are taking the risk of using an experimental+feature which may change or be removed in a future Perl version:++ no warnings "experimental::declared_refs";+ use feature "declared_refs";+ $fooref = my \$foo;+ =for comment The following are used in lib/diagnostics.t for testing two =items that share the same description. Changes here need to be propagated to there@@ -5860,6 +5872,14 @@ think the U.S. Government thinks it's a secret, or at least that they will continue to pretend that it is. And if you quote me on that, I will deny it.

+=item The experimental declared_refs feature is not enabled++(F) To declare references to variables, as in C<my \%x>, you must first enable+the feature:++ no warnings "experimental::declared_refs";+ use feature "declared_refs";+ =item The %s function is unimplemented

+=item Declaring a reference to a variable++Introduced in Perl 5.26.0++Using this feature triggers warnings in the category+C<experimental::declared_refs>.++The ticket for this feature is+L<[perl #xxxxxx]|https://rt.perl.org/rt3/Ticket/Display.html?id=xxxxxx>.++See also: L<perlref/Declaring a Reference to a Variable>+ =item There is an C<installhtml> target in the Makefile.

The ticket for this feature isdiff --git a/pod/perlref.pod b/pod/perlref.podindex 8959ba5..a071f1f 100644--- a/pod/perlref.pod+++ b/pod/perlref.pod@@ -909,6 +909,26 @@ will only be visible within that inner sub, and will not affect the outer subroutine where the variables are declared. This bizarre behavior is subject to change.

+=head1 Declaring a Reference to a Variable++Beginning in v5.26.0, the referencing operator can come after C<my>, C<state>, C<our>, or C<local>. This syntax must be enabled with C<use feature 'declared_refs'>. It is experimental, and will war ... [76 chars truncated]++This feature makes these:++ my \$x;+ our \$y;++equivalent to:++ \my $x;+ \our $x;++It is intended mainly for use in assignments to references (see+L</Assigning to References>, above). It also allows the backslash to be+used on just some items in a list of declared variables:++ my ($foo, \@bar, \%baz); # equivalent to: my $foo, \my(@bar, %baz);+ =head1 SEE ALSO

+=head2 The 'declared_refs' feature++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::declared_refs";++This allows a reference to a variable to be declared with C<my>, C<state>,+our C<our>, or localized with C<local>. It is intended mainly for use in+conjunction with the "refaliasing" feature. See L<perlref/Declaring a+Reference to a Variable> for examples.++This feature is available from Perl 5.26 onwards.+ =head1 FEATURE BUNDLES