Re: [PATCH v2] system_data_types.7: Improve "Include" wording and format, and explain it in NOTES

Dave Martin
2020-09-29T15:13:44Z

On Tue, Sep 29, 2020 at 05:06:27PM +0200, Michael Kerrisk (man-pages) wrote:
>
> > > Can we not just annotate each header listed with the originating
> > > standard, say:
> > >
> > > <stddef.h> (C)
> > >
> > > <sys/types.h> (POSIX)
> > > ... (POSIX)
> > > ...
> >
> > That may be a good idea; I've thought about doing that in the past;
> > but also thought that it's still too much noise.
> > Let's see what others think about it.
>
> My thought is that maybe we can add this kind of info later,
> providing we find a concise way to do it. But, for now, already
> the info in the page is useful as is, and I don't want to stop
> the momentum of Alex's work. So, for now, I think let's carry
> on the current style.
>
> > The downside is that it adds a lot of lines,
> > being harder to read for types with too many headers (e.g., size_t).
>
> That is also my concern.

OK, that's fair -- I agree that the page makes a valuable contribution
already, so it makes sense to merge it in its current form and think
about improvements (if any are warranted) afterward.

Apologies for the noise!

Cheers
---Dave