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:
(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.