Re: [PATCH v2 1/2] system_data_types.7: Add 'void *'

From: Jonathan Wakely
Date: Fri Oct 02 2020 - 09:06:34 EST


On Fri, 2 Oct 2020 at 12:31, Michael Kerrisk (man-pages)
<mtk.manpages@xxxxxxxxx> wrote:
>
> On Fri, 2 Oct 2020 at 12:49, Jonathan Wakely <jwakely.gcc@xxxxxxxxx> wrote:
> >
> > On Fri, 2 Oct 2020 at 09:28, Alejandro Colomar via Gcc <gcc@xxxxxxxxxxx> wrote:
> > > However, it might be good that someone starts a page called
> > > 'type_qualifiers(7)' or something like that.
> >
> > Who is this for? Who is trying to learn C from man pages? Should
> > somebody stop them?
>
> Yes, I think so. To add context, Alex has been doing a lot of work to
> build up the new system_data_types(7) page [1], which I think is
> especially useful for the POSIX system data types that are used with
> various APIs.

It's definitely useful for types like struct siginfo_t and struct
timeval, which aren't in C.

Trying to document C seems like a huge task, ill-suited for man-pages,
and not worth the effort.

Maybe some people prefer man pages, but for everybody else
https://en.cppreference.com/w/c already exists and seems like a better
use of time.