develooper Front page | perl.perl5.porters | Postings from May 2016

James E Keenan via RT
May 27, 2016 00:36

Message ID:
On Thu May 26 13:45:51 2016, sprout wrote:
> $ perl -ne 'print if s/^=head(.)/"  "x$1/e' pod/perlref.pod
>    Making References
>    Using References
>    Circular References
>    Symbolic references
>    Not-so-symbolic references
>    Pseudo-hashes: Using an array as a hash
>    Function Templates
>  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?

I am attaching a patch which is a slightly more than bare-bones implementation of your suggestion.  Please review.

Thank you very much.

James E Keenan (

via perlbug:  queue: perl5 status: new Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About