From owner-freebsd-doc  Sun Feb  6 17:59:25 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by builder.freebsd.org (Postfix) with ESMTP id 3D9513F18
	for <freebsd-doc@freebsd.org>; Sun,  6 Feb 2000 17:59:22 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id SAA84848;
	Sun, 6 Feb 2000 18:00:01 -0800 (PST)
	(envelope-from gnats@FreeBSD.org)
Received: from anarcat.dyndns.org (phobos.IRO.UMontreal.CA [132.204.20.20])
	by builder.freebsd.org (Postfix) with ESMTP id 2A23E3F53
	for <FreeBSD-gnats-submit@freebsd.org>; Sun,  6 Feb 2000 17:54:19 -0800 (PST)
Received: by anarcat.dyndns.org (Postfix, from userid 1000)
	id C4DB51AD2; Sun,  6 Feb 2000 20:55:58 -0500 (EST)
Message-Id: <20000207015558.C4DB51AD2@anarcat.dyndns.org>
Date: Sun,  6 Feb 2000 20:55:58 -0500 (EST)
From: The@anarcat.dyndns.org, AnarCat@anarcat.dyndns.org
Reply-To: beaupran@iro.umontreal.ca
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/16537: Adding "See also" to pthread(3), missing pthread man pages and symlinks
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         16537
>Category:       docs
>Synopsis:       Adding "See also" to pthread(3), missing pthread man pages and symlinks
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Feb  6 18:00:01 PST 2000
>Closed-Date:
>Last-Modified:
>Originator:     AnarCat
>Release:        FreeBSD 3.4-STABLE i386
>Organization:
>Environment:

-stable updated on 1999.12.28

>Description:

The pthread functions should be available in the 'see also' section of
the pthread(3) man page.

Also, there are some functions described in pthread(3) that do not
have man pages associated with them.

>How-To-Repeat:

man pthread

Missing man pages:

pthread_attr_destroy,
pthread_attr_getinheritsched,
pthread_attr_getschedparam,
pthread_attr_getschedpolicy,
pthread_attr_getscope,
pthread_attr_getstacksize,
pthread_attr_getstackaddr,
pthread_attr_getdetachstate,
pthread_attr_init,
pthread_attr_setinheritsched,
pthread_attr_setschedparam,
pthread_attr_setschedpolicy,
pthread_attr_setscope,
pthread_attr_setstacksize,
pthread_attr_setstackaddr,
pthread_attr_setdetachstate,
pthread_mutexattr_destroy,
pthread_mutexattr_init,
pthread_condattr_init,
pthread_condattr_destroy,

Missing symlinks:

pthread_rwlock_tryrdlock -> pthread_rwlock_rdlock
pthread_rwlock_trywrlock -> pthread_rwlock_wrlock

>Fix:

For the missing man pages, I'm no pthread wizard (yet!) so I guess
I'll just leave the job to someone else.

For the see also section:
	
--- pthread.3.orig      Sun Feb  6 20:40:28 2000
+++ pthread.3   Sun Feb  6 20:41:06 2000
@@ -222,6 +222,39 @@
 .Fa libc_r
 instead of
 .Fa libc.
+.Sh SEE ALSO
+.Xr pthread_create 3 ,
+.Xr pthread_detach 3 ,
+.Xr pthread_equal 3 ,
+.Xr pthread_exit 3 ,
+.Xr pthread_join 3 ,
+.Xr pthread_once 3 ,
+.Xr pthread_self 3 ,
+.Xr pthread_mutex_destroy 3 ,
+.Xr pthread_mutex_init 3 ,
+.Xr pthread_mutex_lock 3 ,
+.Xr pthread_mutex_trylock 3 ,
+.Xr pthread_mutex_unlock 3 ,
+.Xr pthread_cond_broadcast 3 ,
+.Xr pthread_cond_destroy 3 ,
+.Xr pthread_cond_init 3 ,
+.Xr pthread_cond_signal 3 ,
+.Xr pthread_cond_timedwait 3 ,
+.Xr pthread_cond_wait 3 ,
+.Xr pthread_rwlock_destroy 3 ,
+.Xr pthread_rwlock_init 3 ,
+.Xr pthread_rwlock_rdlock 3 ,
+.Xr pthread_rwlock_unlock 3 ,
+.Xr pthread_rwlock_wrlock 3 ,
+.Xr pthread_rwlockattr_destroy 3 ,
+.Xr pthread_rwlockattr_getpshared 3 ,
+.Xr pthread_rwlockattr_init 3 ,
+.Xr pthread_rwlockattr_setpshared 3 ,
+.Xr pthread_key_delete 3 ,
+.Xr pthread_getspecific 3 ,
+.Xr pthread_setspecific 3 ,
+.Xr pthread_cleanup_pop 3 ,
+.Xr pthread_cleanup_push 3
 .Sh STANDARDS
 The functions in
 .Fa libc_r

For the missing symlinks, I'm not sure exactly of what is a
Makefile.inc file, but I'll guess it's a plain makefile:

--- Makefile.inc.orig   Sun Feb  6 20:51:28 2000
+++ Makefile.inc        Sun Feb  6 20:52:24 2000
@@ -37,3 +37,6 @@
        pthread_rwlockattr_setpshared.3 \
        pthread_self.3 \
        pthread_setspecific.3
+
+MLINKS+=pthread_rwlock_wrlock.3 pthread_rwlock_trywrlock.3
+MLINKS+=pthread_rwlock_rdlock.3 pthread_rwlock_tryrdlock.3

>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message