@@ -7,7 +7,7 @@ use warnings;
77
88use Scalar::Util qw( reftype refaddr blessed) ;
99
10- our $VERSION = ' 1.52 ' ; # Please update the pod, too.
10+ our $VERSION = ' 1.57 ' ; # Please update the pod, too.
1111my $XS_VERSION = $VERSION ;
1212$VERSION = eval $VERSION ;
1313
@@ -195,7 +195,7 @@ threads::shared - Perl extension for sharing data structures between threads
195195
196196=head1 VERSION
197197
198- This document describes threads::shared version 1.52
198+ This document describes threads::shared version 1.57
199199
200200=head1 SYNOPSIS
201201
@@ -570,16 +570,18 @@ not propagate the blessing to the shared reference:
570570Therefore, you should bless objects before sharing them.
571571
572572It is often not wise to share an object unless the class itself has been
573- written to support sharing. For example, an object's destructor may get
574- called multiple times, once for each thread's scope exit. Another danger is
575- that the contents of hash-based objects will be lost due to the above
576- mentioned limitation. See F<examples/class.pl> (in the CPAN distribution of
577- this module) for how to create a class that supports object sharing.
573+ written to support sharing. For example, a shared object's destructor may
574+ get called multiple times, once for each thread's scope exit, or may not
575+ get called at all if it is embedded inside another shared object. Another
576+ issue is that the contents of hash-based objects will be lost due to the
577+ above mentioned limitation. See F<examples/class.pl> (in the CPAN
578+ distribution of this module) for how to create a class that supports object
579+ sharing.
578580
579581Destructors may not be called on objects if those objects still exist at
580582global destruction time. If the destructors must be called, make sure
581583there are no circular references and that nothing is referencing the
582- objects, before the program ends.
584+ objects before the program ends.
583585
584586Does not support C<splice > on arrays. Does not support explicitly changing
585587array lengths via $#array -- use C<push > and C<pop > instead.
0 commit comments