From ef563f925aae39e57a0e9b3f938861f781d061ba Mon Sep 17 00:00:00 2001 From: Carlos O'Donell Date: Fri, 28 Feb 2014 18:30:22 -0500 Subject: [PATCH] Add header and standard information to threads.texi. The glibc manual uses special annotations to include functions in the summary chapter. These annotations were missing from the functions in the threads chapter. This patch adds those special markers and in turn adds these functions to the summary chapter. --- ChangeLog | 3 +++ manual/threads.texi | 12 ++++++++++++ 2 files changed, 15 insertions(+) diff --git a/ChangeLog b/ChangeLog index 60d63db..959f12a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,8 @@ 2014-02-28 Carlos O'Donell + * manual/threads.texi: Add header and standard comments to all + functions. + * elf/dl-lookup.c (check_match): New function. (ELF_MACHINE_SYM_NO_MATCH): Adjust comment. (do_lookup_x): Remove nested function check_match. Use non-nested diff --git a/manual/threads.texi b/manual/threads.texi index e088b26..4d080d4 100644 --- a/manual/threads.texi +++ b/manual/threads.texi @@ -20,6 +20,8 @@ The @glibcadj{} implements functions to allow users to create and manage data specific to a thread. Such data may be destroyed at thread exit, if a destructor is provided. The following functions are defined: +@comment pthread.h +@comment POSIX @deftypefun int pthread_key_create (pthread_key_t *@var{key}, void (*@var{destructor})(void*)) @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} @c pthread_key_create ok @@ -34,6 +36,8 @@ data destructors or even as members of the thread-specific data, since the latter is passed as an argument to the destructor function. @end deftypefun +@comment pthread.h +@comment POSIX @deftypefun int pthread_key_delete (pthread_key_t @var{key}) @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} @c pthread_key_delete ok @@ -45,6 +49,8 @@ destructor for the thread-specific data is not called during destruction, nor is it called during thread exit. @end deftypefun +@comment pthread.h +@comment POSIX @deftypefun void *pthread_getspecific (pthread_key_t @var{key}) @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} @c pthread_getspecific ok @@ -52,6 +58,8 @@ Return the thread-specific data associated with @var{key} in the calling thread. @end deftypefun +@comment pthread.h +@comment POSIX @deftypefun int pthread_setspecific (pthread_key_t @var{key}, const void *@var{value}) @safety{@prelim{}@mtsafe{}@asunsafe{@asucorrupt{} @ascuheap{}}@acunsafe{@acucorrupt{} @acsmem{}}} @c pthread_setspecific @asucorrupt @ascuheap @acucorrupt @acsmem @@ -84,6 +92,8 @@ the standard. @Theglibc{} provides non-standard API functions to set and get the default attributes used in the creation of threads in a process. +@comment pthread.h +@comment GNU @deftypefun int pthread_getattr_default_np (pthread_attr_t *@var{attr}) @safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} @c Takes lock around read from default_pthread_attr. @@ -92,6 +102,8 @@ function returns @math{0} on success and a non-zero error code on failure. @end deftypefun +@comment pthread.h +@comment GNU @deftypefun int pthread_setattr_default_np (pthread_attr_t *@var{attr}) @safety{@prelim{}@mtsafe{}@asunsafe{@ascuheap{} @asulock{}}@acunsafe{@aculock{} @acsmem{}}} @c pthread_setattr_default_np @ascuheap @asulock @aculock @acsmem -- 2.7.4