summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <khw@khw-desktop.(none)>2010-07-09 13:21:33 -0600
committerKarl Williamson <khw@khw-desktop.(none)>2010-07-13 17:09:53 -0600
commit5ff2e4c00484f467453335cd2b906b7ce1e33a58 (patch)
tree2fad934c25a3cbbef62e040529bf1177866dc253
parentcc26ddeba958e8f9785b940e55b354e757252c7f (diff)
downloadperl-5ff2e4c00484f467453335cd2b906b7ce1e33a58.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