Skip site navigation (1)Skip section navigation (2)
Date:      Sun,  6 Feb 2000 20:55:58 -0500 (EST)
From:      The@anarcat.dyndns.org, AnarCat@anarcat.dyndns.org
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/16537: Adding "See also" to pthread(3), missing pthread man pages and symlinks
Message-ID:  <20000207015558.C4DB51AD2@anarcat.dyndns.org>

next in thread | raw e-mail | index | archive | help

>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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000207015558.C4DB51AD2>