Re: cond_timedwait's ABS_TIMEOUT is not explained well enough.
Thanks for the feedback. I'm going to change the text to:
=item cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR
In its two-argument form, C<cond_timedwait> takes a B<locked> variable and an
absolute timeout in I<epoch> seconds (see L<time() in perlfunc|perlfunc/time>
for more) as parameters, unlocks the variable, and blocks until the
timeout is reached or another thread signals the variable. A false value is
returned if the timeout is reached, and a true value otherwise. In either
case, the variable is re-locked upon return.
This should make it more clear. This will go out with the next release of threads::shared (which will come not later than the release of Perl 5.18.0).