From: Paul Eggert Date: Sat, 11 Apr 2026 16:36:46 +0000 (-0700) Subject: sigprocmask: clarify GNULIB_SIGPROCMASK_SINGLE_THREAD doc X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fc2a05f786479d64ac90821bbb255b755ffb6258;p=thirdparty%2Fgnulib.git sigprocmask: clarify GNULIB_SIGPROCMASK_SINGLE_THREAD doc --- diff --git a/doc/multithread.texi b/doc/multithread.texi index f53f5d6a77..8771e4a674 100644 --- a/doc/multithread.texi +++ b/doc/multithread.texi @@ -324,9 +324,15 @@ You can get this macro defined by including the Gnulib module @code{wchar-single}. @item You may define the C macro @code{GNULIB_SIGPROCMASK_SINGLE_THREAD}, if all the -programs in your package invoke the functions of the @code{sigprocmask} module -(in particular, @code{sigprocmask}, @code{pthread_sigmask}, @code{signal}, and -@code{sigaction}) only from a single thread. +package's programs call the following functions only from a single thread: +@code{pthread_sigmask}, @code{sigaction}, @code{signal}, @code{sigpending}. +Regardless of whether this macro is defined, only single-threaded processes +should call the @code{sigprocmask} function itself (@pxref{sigprocmask}). +The macro is named after @code{sigprocmask} because it affects +Gnulib's implementation of @code{sigprocmask} on native Windows, +the only platform where the macro has any effect, +and the other functions' Gnulib implementations use Gnulib +@code{sigprocmask} on native Windows. @item You may define the C macro @code{GNULIB_EXCLUDE_SINGLE_THREAD}, if all the programs in your package invoke the functions of the @code{exclude} module