Bug 23936

Summary: man page for pthread_cond_wait is unclear
Product: Documentation Reporter: rooneg <rooneg>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description rooneg 2000-12-29 03:50:01 UTC 
The man page for pthread_cond_wait reads as follows: "The waiting thread 
unblocks only after another thread calls pthread_cond_signal(3), or 
pthread_cond_broadcast(3) with the same condition variable, and the current 
thread requires the lock on mutex."  While this is technically correct, it is 
slightly unclear, and "reaquires" the mutex would be clearer.

Fix: apply the following patch:
How-To-Repeat: 
man 3 pthread_cond_wait
Comment 1 lrooney01 2000-12-29 19:26:48 UTC 
the patch i sent managed to misspell 'reacquire' ;-(  
here's a corrected version.

--- /usr/src/lib/libc_r/man/pthread_cond_wait.3 Sat Apr 22 12:35:03 2000
+++ pthread_cond_wait.3 Thu Dec 28 22:27:12 2000
@@ -50,7 +50,7 @@
The waiting thread unblocks only after another thread calls
.Xr pthread_cond_signal 3 , or
.Xr pthread_cond_broadcast 3
-with the same condition variable, and the current thread requires the lock
+with the same condition variable, and the current thread reacquires the lock on
.Fa mutex .
.Sh RETURN VALUES
Comment 2 nik freebsd_committer freebsd_triage 2001-02-02 03:32:13 UTC 
State Changed
From-To: open->closed

Committed, thanks.