From 4be21db2dbe05899207299b10d03daf3d5700f9c Mon Sep 17 00:00:00 2001 From: Jakub Jelinek Date: Mon, 30 May 2005 09:15:07 +0000 Subject: * man/Makefile (SOURCES): Remove all man pages but pthread_cleanup_push.man, pthread_kill_other_threads_np.man and pthread_mutexattr_setkind_np.man. * man/pthread_cleanup_push.man: Replace (3) with (3p) where man page was not kept. * man/pthread_kill_other_threads_np.man: Likewise. * man/pthread_mutexattr_setkind_np.man: Likewise. --- linuxthreads/ChangeLog | 10 ++++++++++ linuxthreads/man/Makefile | 8 +------- linuxthreads/man/pthread_cleanup_push.man | 14 +++++++------- linuxthreads/man/pthread_kill_other_threads_np.man | 8 ++++---- linuxthreads/man/pthread_mutexattr_setkind_np.man | 8 ++++---- 5 files changed, 26 insertions(+), 22 deletions(-) diff --git a/linuxthreads/ChangeLog b/linuxthreads/ChangeLog index 2b024191ed..1ae8d3fd3a 100644 --- a/linuxthreads/ChangeLog +++ b/linuxthreads/ChangeLog @@ -1,3 +1,13 @@ +2005-05-30 Jakub Jelinek + + * man/Makefile (SOURCES): Remove all man pages but + pthread_cleanup_push.man, pthread_kill_other_threads_np.man + and pthread_mutexattr_setkind_np.man. + * man/pthread_cleanup_push.man: Replace (3) with (3p) where man page + was not kept. + * man/pthread_kill_other_threads_np.man: Likewise. + * man/pthread_mutexattr_setkind_np.man: Likewise. + 2005-05-23 Roland McGrath * sysdeps/arm, sysdeps/unix/sysv/linux/arm: Subdirectories moved to diff --git a/linuxthreads/man/Makefile b/linuxthreads/man/Makefile index 4afd2ee15d..d82e893566 100644 --- a/linuxthreads/man/Makefile +++ b/linuxthreads/man/Makefile @@ -1,10 +1,4 @@ -SOURCES=pthread_atfork.man pthread_attr_init.man pthread_cancel.man \ - pthread_cleanup_push.man pthread_cond_init.man \ - pthread_condattr_init.man pthread_create.man pthread_detach.man \ - pthread_equal.man pthread_exit.man pthread_join.man \ - pthread_key_create.man pthread_mutex_init.man \ - pthread_mutexattr_init.man pthread_once.man pthread_self.man \ - pthread_setschedparam.man pthread_sigmask.man sem_init.man \ +SOURCES= pthread_cleanup_push.man \ pthread_kill_other_threads_np.man pthread_mutexattr_setkind_np.man MANPAGES=$(SOURCES:.man=.3thr) diff --git a/linuxthreads/man/pthread_cleanup_push.man b/linuxthreads/man/pthread_cleanup_push.man index 1591431c9c..345d2635dc 100644 --- a/linuxthreads/man/pthread_cleanup_push.man +++ b/linuxthreads/man/pthread_cleanup_push.man @@ -21,7 +21,7 @@ void pthread_cleanup_pop_restore_np(int execute); .SH DESCRIPTION Cleanup handlers are functions that get called when a thread -terminates, either by calling !pthread_exit!(3) or because of +terminates, either by calling !pthread_exit!(3p) or because of cancellation. Cleanup handlers are installed and removed following a stack-like discipline. @@ -37,7 +37,7 @@ with !malloc!(3) or close file descriptors on thread termination. !pthread_cleanup_push! installs the |routine| function with argument |arg| as a cleanup handler. From this point on to the matching !pthread_cleanup_pop!, the function |routine| will be called with -arguments |arg| when the thread terminates, either through !pthread_exit!(3) +arguments |arg| when the thread terminates, either through !pthread_exit!(3p) or by cancellation. If several cleanup handlers are active at that point, they are called in LIFO order: the most recently installed handler is called first. @@ -56,7 +56,7 @@ with the matching closing brace !}! being introduced by the expansion of the matching !pthread_cleanup_pop!. !pthread_cleanup_push_defer_np! is a non-portable extension that -combines !pthread_cleanup_push! and !pthread_setcanceltype!(3). +combines !pthread_cleanup_push! and !pthread_setcanceltype!(3p). It pushes a cleanup handler just as !pthread_cleanup_push! does, but also saves the current cancellation type and sets it to deferred cancellation. This ensures that the cleanup mechanism is effective @@ -113,9 +113,9 @@ None. Xavier Leroy .SH "SEE ALSO" -!pthread_exit!(3), -!pthread_cancel!(3), -!pthread_setcanceltype!(3). +!pthread_exit!(3p), +!pthread_cancel!(3p), +!pthread_setcanceltype!(3p). .SH EXAMPLE @@ -149,7 +149,7 @@ pthread_cleanup_pop(1); .fi Notice that the code above is safe only in deferred cancellation mode -(see !pthread_setcanceltype!(3)). In asynchronous cancellation mode, +(see !pthread_setcanceltype!(3p)). In asynchronous cancellation mode, a cancellation can occur between !pthread_cleanup_push! and !pthread_mutex_lock!, or between !pthread_mutex_unlock! and !pthread_cleanup_pop!, resulting in both cases in the thread trying to diff --git a/linuxthreads/man/pthread_kill_other_threads_np.man b/linuxthreads/man/pthread_kill_other_threads_np.man index 0de42d52d5..63d8342a7c 100644 --- a/linuxthreads/man/pthread_kill_other_threads_np.man +++ b/linuxthreads/man/pthread_kill_other_threads_np.man @@ -16,7 +16,7 @@ called just before a thread calls one of the !exec! functions, e.g. !execve!(2). Termination of the other threads is not performed through -!pthread_cancel!(3) and completely bypasses the cancellation +!pthread_cancel!(3p) and completely bypasses the cancellation mechanism. Hence, the current settings for cancellation state and cancellation type are ignored, and the cleanup handlers are not executed in the terminated threads. @@ -26,9 +26,9 @@ Xavier Leroy .SH "SEE ALSO" !execve!(2), -!pthread_setcancelstate!(3), -!pthread_setcanceltype!(3), -!pthread_cancel!(3). +!pthread_setcancelstate!(3p), +!pthread_setcanceltype!(3p), +!pthread_cancel!(3p). .SH BUGS diff --git a/linuxthreads/man/pthread_mutexattr_setkind_np.man b/linuxthreads/man/pthread_mutexattr_setkind_np.man index e10f47d0e5..4e20b1e083 100644 --- a/linuxthreads/man/pthread_mutexattr_setkind_np.man +++ b/linuxthreads/man/pthread_mutexattr_setkind_np.man @@ -14,8 +14,8 @@ int pthread_mutexattr_getkind_np(const pthread_mutexattr_t *attr, int *kind); .SH DESCRIPTION -These functions are deprecated, use !pthread_mutexattr_settype!(3) -and !pthread_mutexattr_gettype!(3) instead. +These functions are deprecated, use !pthread_mutexattr_settype!(3p) +and !pthread_mutexattr_gettype!(3p) instead. .SH "RETURN VALUE" !pthread_mutexattr_getkind_np! always returns 0. @@ -35,5 +35,5 @@ nor !PTHREAD_MUTEX_ERRORCHECK_NP! Xavier Leroy .SH "SEE ALSO" -!pthread_mutexattr_settype!(3), -!pthread_mutexattr_gettype!(3). +!pthread_mutexattr_settype!(3p), +!pthread_mutexattr_gettype!(3p). -- cgit v1.2.3