From: Casey West <casey@geeknest.com>
Date: Fri, 9 May 2003 11:09:39 +0000 (-0400)
Subject: [perl #8702] Clean up perltrap mis-information
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=418272e4394459ff8d3580f3ac6ed7225c26fa9a;p=p5sagit%2Fp5-mst-13.2.git

[perl #8702] Clean up perltrap mis-information
Message-ID: <20030509150939.GN49820@geeknest.com>

p4raw-id: //depot/perl@19464
---

diff --git a/pod/perltrap.pod b/pod/perltrap.pod
index d06f84f..835f879 100644
--- a/pod/perltrap.pod
+++ b/pod/perltrap.pod
@@ -1435,13 +1435,26 @@ perl4 programs which unconsciously rely on the bugs in earlier perl versions.
 
 =item * Interpolation
 
-You also have to be careful about array references.
+You also have to be careful about array and hash brackets during
+interpolation.
+
+    print "$foo["
+
+    perl 4 prints: [
+    perl 5 prints: syntax error
 
     print "$foo{"
 
     perl 4 prints: {
     perl 5 prints: syntax error
 
+Perl 5 is expecting to find an index or key name following the respective
+brackets, as well as an ending bracket of the appropriate type.  In order
+to mimic the behavior of Perl 4, you must escape the bracket like so.
+
+    print "$foo\[";
+    print "$foo\{";
+
 =item * Interpolation
 
 Similarly, watch out for: