[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 (file)
--- 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>