summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <khw@khw-desktop.(none)>2010-07-09 13:21:33 -0600
committerSteffen Mueller <smueller@cpan.org>2010-08-23 16:07:40 +0200
commite99c83c053fe52ff17d870415b31d0a59f95955a (patch)
tree41c233704d3f6cbe92c3637657b468b302bdaaf3
parente2ea3c5f9f6a1726b593f5948152c04b37c3d3c1 (diff)
downloadperl-e99c83c053fe52ff17d870415b31d0a59f95955a.tar.gz
perlpragma.pod: Clarify that runtime %^H is ro
You can use (caller(0))[10} to retrieve the contents of %^H, and any changes you make to your local copy will be lost, but that may not be immediately apparent to the pod reader.
-rw-r--r--pod/perlpragma.pod4
1 files changed, 2 insertions, 2 deletions
diff --git a/pod/perlpragma.pod b/pod/perlpragma.pod
index 51292a8a12..856014438e 100644
--- a/pod/perlpragma.pod
+++ b/pod/perlpragma.pod
@@ -117,8 +117,8 @@ for the user's code.
User pragmata store their state by writing to the magical hash C<%^H>,
hence these two routines manipulate it. The state information in C<%^H> is
-stored in the optree, and can be retrieved at runtime with C<caller()>, at
-index 10 of the list of returned results. In the example pragma, retrieval
+stored in the optree, and can be retrieved read-only at runtime with C<caller()>,
+at index 10 of the list of returned results. In the example pragma, retrieval
is encapsulated into the routine C<in_effect()>, which takes as parameter
the number of call frames to go up to find the value of the pragma in the
user's script. This uses C<caller()> to determine the value of