Re: 3p page wording

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



(sorry, didn't get chance to get back to this until now. as penance,
i've caught up with a couple of other outstanding man7 patches too!)

thanks for doing the major cleanup. attached is my trivial change on
top of that.


On Wed, Sep 13, 2023 at 4:33 PM Alejandro Colomar <alx@xxxxxxxxxx> wrote:
>
> 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: 0001-system_data_types.7-clarify-si_addr-field.patch
Description: Binary data


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux