From: Father Chrysostomos <sprout@cpan.org>
Date: Fri, 26 Nov 2010 22:51:07 +0000 (-0800)
Subject: Clarify op_lvalue’s docs
X-Git-Tag: accepted/trunk/20130322.191538~6586^2~132
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=001c3c51d1d471266e2a6c3da873e448b161c64b;p=platform%2Fupstream%2Fperl.git

Clarify op_lvalue’s docs

as requested by Reini Urban [perl #78908]
---

diff --git a/op.c b/op.c
index 5346a89..2da3db4 100644
--- a/op.c
+++ b/op.c
@@ -1420,10 +1420,14 @@ Propagate lvalue ("modifiable") context to an op and its children.
 I<type> represents the context type, roughly based on the type of op that
 would do the modifying, although C<local()> is represented by OP_NULL,
 because it has no op type of its own (it is signalled by a flag on
-the lvalue op).  This function detects things that can't be modified,
-such as C<$x+1>, and generates errors for them.  It also flags things
-that need to behave specially in an lvalue context, such as C<$$x>
-which might have to vivify a reference in C<$x>.
+the lvalue op).
+
+This function detects things that can't be modified, such as C<$x+1>, and
+generates errors for them. For example, C<$x+1 = 2> would cause it to be
+called with an op of type OP_ADD and a C<type> argument of OP_SASSIGN.
+
+It also flags things that need to behave specially in an lvalue context,
+such as C<$$x = 5> which might have to vivify a reference in C<$x>.
 
 =cut
 */