[PATCH 1/2] manual: Consolidate POSIX Semaphores docs in Threads chapter

Florian Weimer fweimer@redhat.com
Wed Jan 8 13:27:21 GMT 2025


* Arjun Shankar:

> This commit moves the `sem_*' family of functions from the IPC chapter,
> replacing them with a reference to their new location in the Threads
> chapter.  `sem_clockwait' is also moved out of the Non-POSIX Extensions
> subsection since it is now included in the standard since Issue 8:
> https://pubs.opengroup.org/onlinepubs/9799919799/functions/sem_clockwait.html
> ---
>  manual/ipc.texi     | 69 +-------------------------------
>  manual/threads.texi | 95 ++++++++++++++++++++++++++++++++++++++++-----
>  2 files changed, 86 insertions(+), 78 deletions(-)
>
> diff --git a/manual/ipc.texi b/manual/ipc.texi
> index 32c5ac066f..6c9cb38264 100644
> --- a/manual/ipc.texi
> +++ b/manual/ipc.texi
> @@ -46,71 +46,4 @@ by @theglibc{}.
>  @end deftypefun
>  
>  @subsection POSIX Semaphores

> +@xref {POSIX Semaphores}

Missing . after @xref{…}, extra space before {.

Please add a sentence.  To make this read more nicely.  Something like,
“@Theglibc{} provides POSIX semaphores, too.”  Maybe mention the header
file or sem_* as the function naming pattern?

Thanks,
Florian



More information about the Libc-alpha mailing list