From spidey@anarcat.dyndns.org  Sun Feb  6 17:54:21 2000
Return-Path: <spidey@anarcat.dyndns.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
Sender: spidey@anarcat.dyndns.org
Reply-To: beaupran@iro.umontreal.ca
To: FreeBSD-gnats-submit@freebsd.org
Subject: Adding "See also" to pthread(3), missing pthread man pages and symlinks
X-Send-Pr-Version: 3.2

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Feb  6 18:00:01 PST 2000
>Closed-Date:    Thu Feb 17 18:10:50 PST 2000
>Last-Modified:  Mon May  1 23:42:31 PDT 2000
>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:
State-Changed-From-To: open->closed 
State-Changed-By: unfurl 
State-Changed-When: Thu Feb 17 18:10:50 PST 2000 
State-Changed-Why:  
patch committed, danke! 

1 May 2000:
The missing man pages listed in this PR have also been added.
>Unformatted:
