From: david nicol <whatever@davidnicol.com>
Date: Sun, 26 Oct 2003 22:34:04 +0000 (-0600)
Subject: DOCPATCH: does STORE need to return anything and if so what?
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=a177e38d770b4b5d49ef8808413f901616f208a9;p=p5sagit%2Fp5-mst-13.2.git

DOCPATCH: does STORE need to return anything and if so what?
Message-Id: <1067229244.1071.51.camel@plaza.davidnicol.com>

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

diff --git a/pod/perltie.pod b/pod/perltie.pod
index 4befdae..b81a51b 100644
--- a/pod/perltie.pod
+++ b/pod/perltie.pod
@@ -129,7 +129,9 @@ probably the right thing to do.
 
 This method will be triggered every time the tied variable is set
 (assigned).  Beyond its self reference, it also expects one (and only one)
-argument--the new value the user is trying to assign.
+argument--the new value the user is trying to assign. Don't worry about
+returning a value from STORE -- the semantic of assignment returning the
+assigned value is implemented with FETCH.
 
     sub STORE {
         my $self = shift;
@@ -154,7 +156,6 @@ argument--the new value the user is trying to assign.
         unless (defined setpriority(PRIO_PROCESS, $$self, $new_nicety)) {
             confess "setpriority failed: $!";
         }
-        return $new_nicety;
     }
 
 =item UNTIE this