Re: 3p page wording

[Alejandro Colomar <alx@kernel.org>]

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

On 2023-09-13 23:50, Alejandro Colomar wrote:
> 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've done this.  Please check if you approve these patches:

<https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/log/?h=contrib>

Cheers,
Alex

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


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