summaryrefslogtreecommitdiff
path: root/pod/perldiag.pod
diff options
context:
space:
mode:
authorAristotle Pagaltzis <pagaltzis@gmx.de>2014-03-11 01:57:19 +0100
committerKarl Williamson <public@khwilliamson.com>2014-03-10 20:41:13 -0600
commit08a33b6b0b73cadc9417b2e9e278d4bf6db28233 (patch)
tree98ecea4ef8ae8a2b24074ebc928e1019d7ff6f52 /pod/perldiag.pod
parent4e56b5b96e186b4dac180dc79cdb51d373a215e6 (diff)
downloadperl-08a33b6b0b73cadc9417b2e9e278d4bf6db28233.tar.gz
perldiag: Clarify that lexicals do not trigger "used only once"
Diffstat (limited to 'pod/perldiag.pod')
-rw-r--r--pod/perldiag.pod8
1 files changed, 5 insertions, 3 deletions
diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index 69d9622d46..5482684ddf 100644
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -3223,10 +3223,12 @@ local() if you want to localize a package variable.
(W once) Typographical errors often show up as unique variable
names. If you had a good reason for having a unique name, then
just mention it again somehow to suppress the message. The C<our>
-declaration is provided for this purpose.
+declaration is also provided for this purpose.
-NOTE: This warning detects symbols that have been used only once
-so $c, @c, %c, *c, &c, sub c{}, c(), and c (the filehandle or
+NOTE: This warning detects package symbols that have been used only
+once. This means lexical variables will never trigger this warning.
+It also means that all of the package variables $c, @c, %c, as well
+as *c, &c, sub c{}, c(), and c (the filehandle or
format) are considered the same; if a program uses $c only once
but also uses any of the others it will not trigger this warning.
Symbols beginning with an underscore and symbols using special