From: Elizabeth Mattijsen <liz@dijkmat.nl>
Date: Fri, 12 Jul 2002 23:45:52 +0000 (+0200)
Subject: [DOC PATCH] threads::shared.pm, share( $hashref->{key} ) bug
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=3d32476b6ac7ae195aafe3bae3fdc0b9546c0e7a;p=p5sagit%2Fp5-mst-13.2.git

[DOC PATCH] threads::shared.pm, share( $hashref->{key} ) bug
Message-Id: <4.2.0.58.20020712234444.0209f350@mickey.dijkmat.nl>

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

diff --git a/ext/threads/shared/shared.pm b/ext/threads/shared/shared.pm
index 3016039..cd39da6 100644
--- a/ext/threads/shared/shared.pm
+++ b/ext/threads/shared/shared.pm
@@ -182,6 +182,11 @@ Taking references to the elements of shared arrays and hashes does not
 autovivify the elements, and neither does slicing a shared array/hash
 over non-existent indices/keys autovivify the elements.
 
+share() allows you to C<share $hashref->{key}> without giving any error
+message.  But the C<$hashref->{key}> is B<not> shared, causing the error
+"locking can only be used on shared values" to occur when you attempt to
+C<lock $hasref->{key}>.
+
 =head1 AUTHOR
 
 Arthur Bergman E<lt>arthur at contiller.seE<gt>