Date: Sun, 28 Dec 2003 21:54:21 -0800 (PST) From: Alfred Perlstein <bright@elvis.mu.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/60679: pthreads documentation does not describe "attr" Message-ID: <20031229055421.4BAB75C7D3@elvis.mu.org> Resent-Message-ID: <200312290600.hBT60cEr014527@freefall.freebsd.org>
index | next in thread | raw e-mail
>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:
help
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20031229055421.4BAB75C7D3>