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

Michael Kerrisk (man-pages)
2020-09-29T15:06:34Z

> > 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.

Thanks,

Michael

--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/