Document "Ambiguous use of %c resolved as operator %c"

1 files changed, 9 insertions, 0 deletions

diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index 91664571b2..55e53f1255 100644
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -89,6 +89,15 @@ C<tr/a-y//>, which was probably not what you would have expected.)
 you thought.  Normally it's pretty easy to disambiguate it by supplying
 a missing quote, operator, parenthesis pair or declaration.
 
+=item Ambiguous use of %c resolved as operator %c
+
+(W ambiguous) C<%>, C<&>, and C<*> are both infix operators (modulus,
+bitwise and, and multpication), and you said something like C<*foo *
+foo> that might be interpreted as either of them.  We assumed you
+meant the infix operator, but please try to make it more clear -- in
+the example given, you might write C<*foo * foo()> if you really meant
+to multiply a glob by the result of calling a function.
+
 =item '|' and '<' may not both be specified on command line
 
 (F) An error peculiar to VMS.  Perl does its own command line