From: Sinan Unur <sinan@unur.com>
Date: Tue, 8 Jun 2010 22:53:27 +0000 (-0400)
Subject: It may not be obvious to a new Perl programmer that $#ary is explained in perldata... 
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=db2ed3fb308b082577e9315ba52b2cb266a2bd0a;p=p5sagit%2Fp5-mst-13.2.git

It may not be obvious to a new Perl programmer that $#ary is explained in perldata.pod (see stackoverflow.com/questions/2997042/ ).

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
--- 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