Bug 211365

Summary: [patch] fix man page sigaction(2)
Product: Documentation Reporter: Konstantin Stroykovskiy <bonkor>
Component: Books & ArticlesAssignee: Sevan Janiyan <sevan>
Status: Closed Not Accepted    
Severity: Affects Only Me CC: sevan
Priority: --- Keywords: patch
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://reviews.freebsd.org/D12006
Attachments:
Description Flags
patch for /usr/src/lib/libc/sys/sigaction.2 none

Description Konstantin Stroykovskiy 2016-07-25 13:42:43 UTC
Created attachment 172970 [details]
patch for /usr/src/lib/libc/sys/sigaction.2

Man page for sigaction system call does not match the corresponding function definition in /usr/include/sys/signal.h
Comment 1 Sevan Janiyan freebsd_committer freebsd_triage 2017-08-18 16:31:39 UTC
Comment from the review:

"Note the paragraph below starting with "The above declaration of struct sigaction is not literal.". The man page is inconsistent now.

Also, I don't think applications are supposed to use the __sigaction_u, __sa_handler and __sa_sigaction identifiers.

The definition in the man page could be clarified using a C11 anonymous union, but this cannot be used in the implementation, since we do not want to require using recent compilers and standards to compile application code."

Thank you for the patch & apologies for the long time to respond but it's best if the manual stays as-is.