From: Abigail <abigail@abigail.be>
Date: Tue, 23 Jan 2001 01:41:10 +0000 (+0100)
Subject: pod/perlvar.pod
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=1555b0cb66309ad3ec47bc7df6e8af6e243fc26d;p=p5sagit%2Fp5-mst-13.2.git

pod/perlvar.pod
Message-ID: <20010123004110.22259.qmail@foad.org>

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

diff --git a/pod/perlvar.pod b/pod/perlvar.pod
index 49cdcb2..718484f 100644
--- a/pod/perlvar.pod
+++ b/pod/perlvar.pod
@@ -193,17 +193,22 @@ examples given for the C<@-> variable.
 
 =item $*
 
-Set to 1 to do multi-line matching within a string, 0 to tell Perl
-that it can assume that strings contain a single line, for the purpose
-of optimizing pattern matches.  Pattern matches on strings containing
-multiple newlines can produce confusing results when C<$*> is 0.  Default
-is 0.  (Mnemonic: * matches multiple things.)  This variable
-influences the interpretation of only C<^> and C<$>.  A literal newline can
-be searched for even when C<$* == 0>.
+Set to a non-zero integer value to do multi-line matching within a
+string, 0 (or undefined) to tell Perl that it can assume that strings
+contain a single line, for the purpose of optimizing pattern matches.
+Pattern matches on strings containing multiple newlines can produce
+confusing results when C<$*> is 0 or undefined. Default is undefined.
+(Mnemonic: * matches multiple things.) This variable influences the
+interpretation of only C<^> and C<$>. A literal newline can be searched
+for even when C<$* == 0>.
 
 Use of C<$*> is deprecated in modern Perl, supplanted by 
 the C</s> and C</m> modifiers on pattern matching.
 
+Assigning a non-numerical value to C<$*> triggers a warning (and makes
+C<$*> act if C<$* == 0>), while assigning a numerical value to C<$*>
+makes that an implicit C<int> is applied on the value.
+
 =item input_line_number HANDLE EXPR
 
 =item $INPUT_LINE_NUMBER