From owner-freebsd-doc@FreeBSD.ORG Sun Dec 28 22:00:43 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0050816A4CE for ; Sun, 28 Dec 2003 22:00:43 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4CD5E43D4C for ; Sun, 28 Dec 2003 22:00:38 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) hBT60cFR014528 for ; Sun, 28 Dec 2003 22:00:38 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.10/8.12.10/Submit) id hBT60cEr014527; Sun, 28 Dec 2003 22:00:38 -0800 (PST) (envelope-from gnats) Resent-Date: Sun, 28 Dec 2003 22:00:38 -0800 (PST) Resent-Message-Id: <200312290600.hBT60cEr014527@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Alfred Perlstein Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2D83C16A4CE for ; Sun, 28 Dec 2003 21:54:22 -0800 (PST) Received: from elvis.mu.org (elvis.mu.org [192.203.228.196]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7C7B043D2D for ; Sun, 28 Dec 2003 21:54:21 -0800 (PST) (envelope-from bright@elvis.mu.org) Received: by elvis.mu.org (Postfix, from userid 1192) id 4BAB75C7D3; Sun, 28 Dec 2003 21:54:21 -0800 (PST) Message-Id: <20031229055421.4BAB75C7D3@elvis.mu.org> Date: Sun, 28 Dec 2003 21:54:21 -0800 (PST) From: Alfred Perlstein To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/60679: pthreads documentation does not describe "attr" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Alfred Perlstein List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Dec 2003 06:00:43 -0000 >Number: 60679 >Category: docs >Synopsis: pthreads documentation does not describe "attr" >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Dec 28 22:00:37 PST 2003 >Closed-Date: >Last-Modified: >Originator: Alfred Perlstein >Release: FreeBSD 4.9-MUORG-20031210 i386 >Organization: RED Inc. >Environment: System: FreeBSD elvis.mu.org 4.9-MUORG-20031210 FreeBSD 4.9-MUORG-20031210 #4: Fri Dec 12 14:16:14 PST 2003 root@:/usr/src/sys/compile/h0h0magic i386 >Description: The pthreads manpages do not describe the nor link properly to the pages describing attrs: example: PTHREAD_MUTEX_INIT(3) does not xref PTHREAD_MUTEXATTR(3) also: PTHREAD_MUTEXATTR(3) describes several functions: pthread_mutexattr_setprotocol, pthread_mutexattr_settype, etc but does not explain what the values used for these functions do or imply. The same deficiency exists for: PTHREAD_COND_INIT(3) no xref to PTHREAD_CONDATTR(3) PTHREAD_CONDATTR(3) lacks definitions PTHREAD_CREATE(3) has no xref to PTHREAD_ATTR(3) PTHREAD_ATTR(3) lacks definitions. >How-To-Repeat: man pthread... >Fix: add more docco? UTSL? I may get to this eventually, but I'm hoping some brave and helpful sole will get to it first. >Release-Note: >Audit-Trail: >Unformatted: