# Please include the string: [perl #128250]
# in the subject line of all future correspondence about this issue.
# <URL: https://rt.perl.org/Ticket/Display.html?id=128250 >
$ perl -ne 'print if s/^=head(.)/" "x$1/e' pod/perlref.pod
Pseudo-hashes: Using an array as a hash
Postfix Dereference Syntax
Postfix Reference Slicing
Assigning to References
Most of the documentation is under the DESCRIPTION section, which makes sense. The postfix dereference syntax was added after the warning, as a top-level section, and then I blithely added the section on assigning to references after it.
The WARNING is about using references as hash keys, which may not do what you want.
Should that perhaps be made a subsection of DESCRIPTION, or should we move it to the end of the documentation, where it used to be?