NetBSD Problem Report #53477

From www@NetBSD.org  Sat Jul 28 13:48:49 2018
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 596CC7A159
	for <gnats-bugs@gnats.NetBSD.org>; Sat, 28 Jul 2018 13:48:49 +0000 (UTC)
Message-Id: <20180728134848.12C4A7A1DB@mollari.NetBSD.org>
Date: Sat, 28 Jul 2018 13:48:48 +0000 (UTC)
From: netbsd@eq.cz
Reply-To: netbsd@eq.cz
To: gnats-bugs@NetBSD.org
Subject: typo/bug in a man page
X-Send-Pr-Version: www-1.0

>Number:         53477
>Category:       lib
>Synopsis:       typo/bug in a man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    lib-bug-people
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Jul 28 13:50:00 +0000 2018
>Closed-Date:    Sat Jul 28 14:07:29 +0000 2018
>Last-Modified:  Sat Jul 28 14:07:29 +0000 2018
>Originator:     rudolf
>Release:        HEAD
>Organization:
>Environment:
>Description:
There seems to be a typo/bug in "pthread_cond" manual page: the sentence ``The difference between pthread_cond_broadcast() and pthread_cond_signal() is that the former unblocks all threads waiting for the condition variable, whereas the latter blocks only one waiting thread.'' should in my opinion read ``The difference between pthread_cond_broadcast() and pthread_cond_signal() is that the former unblocks all threads waiting for the condition variable, whereas the latter unblocks only one waiting thread.'' ("blocks" vs. "unblocks").
>How-To-Repeat:
man 3 pthread_cond

read the 4th paragraph of description
>Fix:
diff --git a/lib/libpthread/pthread_cond.3 b/lib/libpthread/pthread_cond.3
index 741543a72..641ace03e 100644
--- a/lib/libpthread/pthread_cond.3
+++ b/lib/libpthread/pthread_cond.3
@@ -128,7 +128,7 @@ The difference between
 and
 .Fn pthread_cond_signal
 is that the former unblocks all threads waiting for the condition variable,
-whereas the latter blocks only one waiting thread.
+whereas the latter unblocks only one waiting thread.
 If no threads are waiting on
 .Fa cond ,
 neither function has any effect.

>Release-Note:

>Audit-Trail:
From: "Robert Elz" <kre@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/53477 CVS commit: src/lib/libpthread
Date: Sat, 28 Jul 2018 14:00:19 +0000

 Module Name:	src
 Committed By:	kre
 Date:		Sat Jul 28 14:00:19 UTC 2018

 Modified Files:
 	src/lib/libpthread: pthread_cond.3

 Log Message:
 PR lib/53477 (rudolf at eq.cz) - correct an obvious mistake.


 To generate a diff of this commit:
 cvs rdiff -u -r1.8 -r1.9 src/lib/libpthread/pthread_cond.3

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: kre@NetBSD.org
State-Changed-When: Sat, 28 Jul 2018 14:07:29 +0000
State-Changed-Why:
Thanks for the report, the error has been corrected in NetBSD HEAD.


>Unformatted:

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.43 2018/01/16 07:36:43 maya Exp $
$NetBSD: gnats_config.sh,v 1.9 2014/08/02 14:16:04 spz Exp $
Copyright © 1994-2017 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.