[patch v1] manual: Document more sigaction flags

Florian Weimer fweimer@redhat.com
Tue Dec 10 20:47:17 GMT 2024


* DJ Delorie:

> Adds documentation for three-argument handler
>
> Adds remainder of the SA_* flags
>
> diff --git a/manual/macros.texi b/manual/macros.texi
> index f48dd4ec22..a74b497582 100644
> --- a/manual/macros.texi
> +++ b/manual/macros.texi
> @@ -282,9 +282,16 @@ cwd\comments\
>  @macro standardsx {element, standard, header}
>  @end macro
>  
> +@ifnotinfo
>  @macro manpageurl {func, sec}
> -@url{https://man7.org/linux/man-pages/man\sec\/\func\.\sec\.html}
> +``\func\(\sec\)'' (@url{https://man7.org/linux/man-pages/man\sec\/\func\.\sec\.html,,Latest: \func\(\sec\)})
>  @end macro
> +@end ifnotinfo
> +@ifinfo
> +@macro manpageurl {func, sec}
> +``\func\(\sec\)'' (Latest: @url{https://man7.org/linux/man-pages/man\sec\/\func\.\sec\.html})
> +@end macro
> +@end ifinfo
>  
>  @macro manpagefunctionstub {func,sec}
>  This documentation is a stub.  For additional information on this

This should go into a separate patch?

> diff --git a/manual/signal.texi b/manual/signal.texi
> index 5c2ba7dae6..656959c2f5 100644
> --- a/manual/signal.texi
> +++ b/manual/signal.texi
> @@ -1141,6 +1141,15 @@ This is used in the same way as the @var{action} argument to the
>  @code{signal} function.  The value can be @code{SIG_DFL},
>  @code{SIG_IGN}, or a function pointer.  @xref{Basic Signal Handling}.
>  
> +@item void (*sa_sigaction) (int @var{signum}, siginfo_t *@var{info}, void *@var{ucontext})
> +This is an alternate to @code{sa_handler} that is used when the
> +@var{sa_flags} includes the @code{flag SA_SIGINFO}.  Note that this

@code{sa_flags}, it's not a placeholder.

Rest looks okay, thanks.

Florian



More information about the Libc-alpha mailing list