summaryrefslogtreecommitdiff
path: root/dist/threads
diff options
context:
space:
mode:
authorDaniel Dragan <bulk88@hotmail.com>2013-09-26 04:39:55 -0400
committerJames E Keenan <jkeenan@cpan.org>2013-09-28 01:13:05 +0200
commit9270a63125f4fc3e15263d9e3c2a84c327aebb87 (patch)
treee3f397bf12fa49510ba54128fac416c7ea7f5775 /dist/threads
parent4da0549cabdc083ce465e29f25eba4ccd78c21fd (diff)
downloadperl-9270a63125f4fc3e15263d9e3c2a84c327aebb87.tar.gz
better pod for threads::_handle
First time I tried to get the OS handle I wrote unpack('P[Q || L /*PICK ONE*/]', $thread->_handle()) it crashed because _handle returns a number, not a packed string. unpack wants a packed string. Mention the pointer is numeric and not to ever pass the retval to unpack('P[.
Diffstat (limited to 'dist/threads')
-rw-r--r--dist/threads/lib/threads.pm7
1 files changed, 4 insertions, 3 deletions
diff --git a/dist/threads/lib/threads.pm b/dist/threads/lib/threads.pm
index 4addf9ced7..cff41c02b1 100644
--- a/dist/threads/lib/threads.pm
+++ b/dist/threads/lib/threads.pm
@@ -5,7 +5,7 @@ use 5.008;
use strict;
use warnings;
-our $VERSION = '1.87';
+our $VERSION = '1.88';
my $XS_VERSION = $VERSION;
$VERSION = eval $VERSION;
@@ -134,7 +134,7 @@ threads - Perl interpreter-based threads
=head1 VERSION
-This document describes threads version 1.87
+This document describes threads version 1.88
=head1 SYNOPSIS
@@ -428,7 +428,8 @@ This I<private> method returns the memory location of the internal thread
structure associated with a threads object. For Win32, this is a pointer to
the C<HANDLE> value returned by C<CreateThread> (i.e., C<HANDLE *>); for other
platforms, it is a pointer to the C<pthread_t> structure used in the
-C<pthread_create> call (i.e., C<pthread_t *>).
+C<pthread_create> call (i.e., C<pthread_t *>). The pointer is numeric (UV) and
+not packed. It can not be direct passed to C<unpack('P[4]', >.
This method is of no use for general Perl threads programming. Its intent is
to provide other (XS-based) thread modules with the capability to access, and