It may not be obvious to a new Perl programmer that $#ary is explained in perldata...

A possible solution is to place an entry in perlvar.pod pointing out
that $# was removed and pointing the user to perldata.pod for the
explanation of $#ary usage.

diff --git a/pod/perlvar.pod b/pod/perlvar.pod
index 8068099..6c04c2e 100644 (file)
--- a/pod/perlvar.pod
+++ b/pod/perlvar.pod
@@ -553,6 +553,11 @@ taken for something more important.)
 Consider using "real" multidimensional arrays as described
 in L<perllol>.
 
+=item $#
+X<$#>
+
+C<$#> was removed in Perl 5.10.0. See L<perldata/"Variable names"> for C<$#ary> usage.
+
 =item HANDLE->format_page_number(EXPR)
 
 =item $FORMAT_PAGE_NUMBER