From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2178) id 8021D3858D35; Mon, 8 May 2023 12:11:39 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 8021D3858D35 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1683547899; bh=we32R6DDyekoRpMxr/ALvuFWfwpj8Qi598EG23ZGqtU=; h=From:To:Subject:Date:From; b=gG/ZT1ys/4ZAbrQn602pIvZhwlpD1sXsPJzOnJ4vA5yNZr3cZhqjAbPExOuwNQAhB lIl3qCUAKSwVqBY0kK+8YJuGS8Wo856cugacm87o7daKSQNPFBI1lfwFpdbzcfjRn9 MeuMTy4RhzaDQzbFj5NS9YFR7QOvrAwgV1LfY1+c= MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="utf-8" From: Florian Weimer To: glibc-cvs@sourceware.org Subject: [glibc] manual: Remove unsupported line breaks in waiting-with-clock section X-Act-Checkin: glibc X-Git-Author: Florian Weimer X-Git-Refname: refs/heads/master X-Git-Oldrev: a26238d3ca21fda6d7d41b4d56541fcf4546fbe7 X-Git-Newrev: 2f679937b35b7f9a8d448ab2ee03bc1fb3ace263 Message-Id: <20230508121139.8021D3858D35@sourceware.org> Date: Mon, 8 May 2023 12:11:39 +0000 (GMT) List-Id: https://sourceware.org/git/gitweb.cgi?p=glibc.git;h=2f679937b35b7f9a8d448ab2ee03bc1fb3ace263 commit 2f679937b35b7f9a8d448ab2ee03bc1fb3ace263 Author: Florian Weimer Date: Mon May 8 13:14:22 2023 +0200 manual: Remove unsupported line breaks in waiting-with-clock section The argument to @deftypefun must be on a single line. Also add the missing @safety for sem_clockwait. Reported-by: Nilgün Belma Bugüner Diff: --- manual/threads.texi | 29 ++++++++--------------------- 1 file changed, 8 insertions(+), 21 deletions(-) diff --git a/manual/threads.texi b/manual/threads.texi index 48fd562923..a721c7f464 100644 --- a/manual/threads.texi +++ b/manual/threads.texi @@ -754,8 +754,8 @@ freed. @comment semaphore.h @comment POSIX-proposed -@deftypefun int sem_clockwait (sem_t *@var{sem}, clockid_t @var{clockid}, - const struct timespec *@var{abstime}) +@deftypefun int sem_clockwait (sem_t *@var{sem}, clockid_t @var{clockid}, const struct timespec *@var{abstime}) +@safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} Behaves like @code{sem_timedwait} except the time @var{abstime} is measured against the clock specified by @var{clockid} rather than @code{CLOCK_REALTIME}. Currently, @var{clockid} must be either @@ -764,8 +764,7 @@ against the clock specified by @var{clockid} rather than @comment pthread.h @comment POSIX-proposed -@deftypefun int pthread_cond_clockwait (pthread_cond_t *@var{cond}, pthread_mutex_t *@var{mutex}, - clockid_t @var{clockid}, const struct timespec *@var{abstime}) +@deftypefun int pthread_cond_clockwait (pthread_cond_t *@var{cond}, pthread_mutex_t *@var{mutex}, clockid_t @var{clockid}, const struct timespec *@var{abstime}) @safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} @c If exactly the same function with arguments is called from a signal @c handler that interrupts between the mutex unlock and sleep then it @@ -784,10 +783,7 @@ specified or defaulted when @code{pthread_cond_init} was called. Currently, @comment pthread.h @comment POSIX-proposed -@deftypefun int pthread_rwlock_clockrdlock (pthread_rwlock_t *@var{rwlock}, - clockid_t @var{clockid}, - const struct timespec *@var{abstime}) - +@deftypefun int pthread_rwlock_clockrdlock (pthread_rwlock_t *@var{rwlock}, clockid_t @var{clockid}, const struct timespec *@var{abstime}) @safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} Behaves like @code{pthread_rwlock_timedrdlock} except the time @var{abstime} is measured against the clock specified by @var{clockid} @@ -798,10 +794,7 @@ returned. @comment pthread.h @comment POSIX-proposed -@deftypefun int pthread_rwlock_clockwrlock (pthread_rwlock_t *@var{rwlock}, - clockid_t @var{clockid}, - const struct timespec *@var{abstime}) - +@deftypefun int pthread_rwlock_clockwrlock (pthread_rwlock_t *@var{rwlock}, clockid_t @var{clockid}, const struct timespec *@var{abstime}) @safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} Behaves like @code{pthread_rwlock_timedwrlock} except the time @var{abstime} is measured against the clock specified by @var{clockid} @@ -812,8 +805,7 @@ returned. @comment pthread.h @comment GNU extension -@deftypefun int pthread_tryjoin_np (pthread_t *@var{thread}, - void **@var{thread_return}) +@deftypefun int pthread_tryjoin_np (pthread_t *@var{thread}, void **@var{thread_return}) @standards{GNU, pthread.h} @safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} Behaves like @code{pthread_join} except that it will return @code{EBUSY} @@ -822,9 +814,7 @@ immediately if the thread specified by @var{thread} has not yet terminated. @comment pthread.h @comment GNU extension -@deftypefun int pthread_timedjoin_np (pthread_t *@var{thread}, - void **@var{thread_return}, - const struct timespec *@var{abstime}) +@deftypefun int pthread_timedjoin_np (pthread_t *@var{thread}, void **@var{thread_return}, const struct timespec *@var{abstime}) @standards{GNU, pthread.h} @safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} Behaves like @code{pthread_tryjoin_np} except that it will block until the @@ -836,10 +826,7 @@ will wait forever in the same way as @code{pthread_join}. @comment pthread.h @comment GNU extension -@deftypefun int pthread_clockjoin_np (pthread_t *@var{thread}, - void **@var{thread_return}, - clockid_t @var{clockid}, - const struct timespec *@var{abstime}) +@deftypefun int pthread_clockjoin_np (pthread_t *@var{thread}, void **@var{thread_return}, clockid_t @var{clockid}, const struct timespec *@var{abstime}) @standards{GNU, pthread.h} @safety{@prelim{}@mtsafe{}@asunsafe{@asulock{}}@acunsafe{@aculock{}}} Behaves like @code{pthread_timedjoin_np} except that the absolute time in