This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Change the warning for $* to add ", and will become a syntax error".
[perl5.git] / pod / perldiag.pod
index d9ebe57..069e1aa 100644 (file)
@@ -2602,12 +2602,16 @@ with 'useperlio'.
 (F) Your machine doesn't implement the sockatmark() functionality,
 neither as a system call nor an ioctl call (SIOCATMARK).
 
-=item $* is no longer supported
+=item $* is no longer supported, and will become a syntax error
 
-(D deprecated, syntax) The special variable C<$*>, deprecated in older
-perls, has been removed as of 5.9.0 and is no longer supported.  In
-previous versions of perl the use of C<$*> enabled or disabled multi-line
-matching within a string.
+(D deprecated, syntax) The special variable C<$*>, which has had no
+effect since v5.10.0, will be removed soon.  Currently code which mentions
+this variable compiles with this warning, but the variable is no longer
+magical, hence reads and writes have no side effects.  In future such code
+will fail to compile with a syntax error.
+
+Prior to v5.10.0 the use of C<$*> enabled or disabled multi-line matching
+within a string.
 
 Instead of using C<$*> you should use the C</m> (and maybe C</s>) regexp
 modifiers.  You can enable C</m> for a lexical scope (even a whole file)