Re: 3p page wording

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1.1: Type: text/plain, Size: 1485 bytes --]

Hi enh,

On 2023-09-13 21:58, enh wrote:
> is it a requirement that the 3p pages only contain text that's
> explicitly in POSIX?

Yes, I guess.

> the siginfo_t::si_addr description on
> system_data_types.7 (which is what people see if they `man siginfo_t`)
> says "Address of faulting instruction", which isn't true for all
> signals, and caused enough confusion for the ART maintainers that they
> came to me as Android's libc maintainer for an adjudication. meanwhile
> the sigaction.2 page says "Memory location which caused fault" which
> seems much more helpful.

siginfo_t(3type), aka system_data_types(7), isn't a POSIX page, so
we can patch it if you want.

I'd also move the types to their own pages and have system_data_types(7)
be a link to intro(3) (until we have an intro(3type)).

> 
> i _was_ going to send you a patch, but then i checked
> https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/signal.h.html
> which has the same unfortunate "Address of faulting instruction"
> wording. at which point i assume you want me to file an Austin Group
> bug (which i'll do anyway:
> https://www.austingroupbugs.net/view.php?id=1775),

Thanks.

> and presumably wait
> for POSIX's wording to improve before changing system_data_types.7?

Nah, we can improve siginfo_t(3type) already.  Feel free to send a patch.

Cheers,
Alex

-- 
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]