Re: [PATCH] manual: Document the System V sigpause function

["Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>]

Hi Florian,

On Sat, 16 May 2020 at 11:25, Florian Weimer <fweimer@redhat.com> wrote:
>
> * Michael Kerrisk:
>
> >> +@deftypefun int sigpause (int @var{signal})
> >> +@standards{XOPEN, signal.h}
> >> +@safety{@prelim{}@mtunsafe{@mtasurace{:sigprocmask}}@asunsafe{@asulock{/hurd}}@acunsafe{@aculock{/hurd}}}
> >> +This deprecated function is a precursor to the @code{sigsuspend}
> >> +function (@pxref{Waiting for a Signal}): it removes @var{signal} from
> >> +the thread's signal mask, and waits for a signal to arrive.  On return
> >> +the previous set of blocked signals is restored.
> >
> > s/previous set of blocked signals is restored/thread's previous signal
> > mask is restored/ ?
>
> “Set of blocked signals” is the term preferred by the rest of the
> manual.

Maybe so, but:
* "set of blocked signals" is clunky and a bit imprecise (POSIX uses
the term mask)
* In the very preceding line, you yourself wrote "thread's signal mask"...

Maybe the rest of the manual should be fixed?

Thanks,

Michael