From: Fergal Daly <fergal@esatclear.ie>
Date: Tue, 2 Sep 2003 17:36:52 +0000 (+0100)
Subject: [DOCPATCH] Re: [perl #23630] problem with "used only once" warning
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=64b374f47ab87515a3309424011c03542689c7c6;p=p5sagit%2Fp5-mst-13.2.git

[DOCPATCH] Re: [perl #23630] problem with "used only once" warning
Message-Id: <200309021736.52725.fergal@esatclear.ie>

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

diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index 2d29e70..ad8b8c7 100644
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -2199,6 +2199,11 @@ 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.
 
+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 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.
+
 =item Negative '/' count in unpack
 
 (F) The length count obtained from a length/code unpack operation was