From: David Golden Date: Sun, 23 May 2010 02:46:50 +0000 (-0400) Subject: Rephrase perlop for non-destructive substitution X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=000c65fce914409ad42f49763dbced48187b5baf;p=p5sagit%2Fp5-mst-13.2.git Rephrase perlop for non-destructive substitution --- diff --git a/pod/perlop.pod b/pod/perlop.pod index 0acf7b9..8f1d1f5 100644 --- a/pod/perlop.pod +++ b/pod/perlop.pod @@ -235,11 +235,11 @@ of operation work on some other string. The right argument is a search pattern, substitution, or transliteration. The left argument is what is supposed to be searched, substituted, or transliterated instead of the default $_. When used in scalar context, the return value generally indicates the -success of the operation. Not always though: the non-destructive substitution -option (C) causes the return value to be the result of the substition, for -example. Behavior in list context depends on the particular operator. See -L for details and L for examples -using these operators. +success of the operation. The exception is substitution with the C +(non-destructive) option, which causes the return value to be the result of +the substition. Behavior in list context depends on the particular operator. +See L for details and L for +examples using these operators. If the right argument is an expression rather than a search pattern, substitution, or transliteration, it is interpreted as a search pattern at run @@ -253,7 +253,7 @@ pattern C<\>, which it will consider a syntax error. Binary "!~" is just like "=~" except the return value is negated in the logical sense. -Binary "!~" is not permitted to bind to a non-destructive substitute (s///r). +Binary "!~" with a non-destructive substitution (s///r) is a syntax error. =head2 Multiplicative Operators X