From owner-freebsd-threads@FreeBSD.ORG  Wed Oct  1 10:18:09 2003
Return-Path: <owner-freebsd-threads@FreeBSD.ORG>
Delivered-To: freebsd-threads@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 0FBDC16A4B3
	for <freebsd-threads@freebsd.org>;
	Wed,  1 Oct 2003 10:18:09 -0700 (PDT)
Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU
	[128.205.32.2])	by mx1.FreeBSD.org (Postfix) with ESMTP id D207143FCB
	for <freebsd-threads@freebsd.org>;
	Wed,  1 Oct 2003 10:18:07 -0700 (PDT)
	(envelope-from kensmith@cse.Buffalo.EDU)
Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1])
	h91HI7us015966	for <freebsd-threads@freebsd.org>;
	Wed, 1 Oct 2003 13:18:07 -0400 (EDT)
Received: (from kensmith@localhost)
	by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id h91HI7Wl015965
	for freebsd-threads@freebsd.org; Wed, 1 Oct 2003 13:18:07 -0400 (EDT)
Date: Wed, 1 Oct 2003 13:18:07 -0400
From: Ken Smith <kensmith@cse.Buffalo.EDU>
To: freebsd-threads@freebsd.org
Message-ID: <20031001171807.GI12227@electra.cse.Buffalo.EDU>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.4.1i
Subject: pthread_mutex_init manual page
X-BeenThere: freebsd-threads@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Threading on FreeBSD <freebsd-threads.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-threads>,
	<mailto:freebsd-threads-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-threads>
List-Post: <mailto:freebsd-threads@freebsd.org>
List-Help: <mailto:freebsd-threads-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-threads>,
	<mailto:freebsd-threads-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 01 Oct 2003 17:18:09 -0000


We received a PR that pointed out this section of the pthread_mutex_init(3)
manual page is not proper English:

 
     [EAGAIN]           The temporarily lacks the resources to create another
                        mutex.
 
I looked at the source code for it in:

	-current /usr/src/lib/libpthread/thread/thr_mutex.c
 	-stable /usr/src/lib/libc_r/uthread/uthread_mutex.c

In both cases unless I'm missing something that error code will never
be returned.

Should I fix it to say "The system temporarily lacks a non-memory
resource to create another mutex" (which I got from a programming
book I had on hand) or should I remove the reference to that error
code?

Thanks.

-- 
						Ken Smith
- From there to here, from here to      |       kensmith@cse.buffalo.edu
  there, funny things are everywhere.   |
                      - Theodore Geisel |