man pthread

[Gavin Atkinson]

On Mon, 21 Jul 2014, Malcolm Douglas wrote:
> Sorry, not sure if this is the right way to handle this, but I saw a
> doc error.
> 
> The pthread_cond_wait and pthread_cond_timedwait descriptions are
> incorrect in man pthread.
> 
> The description is:
> Wait for a condition and lock the specified mutex.
> 
> It should be:
> Wait for a condition and unlock the specified mutex.

The current description is actually correct, but not clear.  How about:

pthread_cond_timedwait()
   Unlock the specified mutex, wait no longer than the specified time for
   a condition, and then relock the mutex.

pthread_cond_wait()
   Unlock the specified mutex, wait for a condition, and relock the mutex.

Would that be better?

Thanks,

Gavin
> 
> pthread_cond_timedwait has an analogous error.
> 
> The pages for man pthread_cond_wait and pthread_cond_timedwait do not
> have this error, it is just in the descriptions in the page for
> pthread.
> _______________________________________________
> freebsd-doc at freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"
>