[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 (file)
--- 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