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

Alejandro Colomar
2020-09-29T15:21:13Z

On 2020-09-29 17:13, Dave Martin wrote:
> 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
>

Hi Dave,

No problem, suggestions are welcome!
Actually, I want suggestions for that page.

Actually, I should apologize for the noise...
I don't know, but I may have sent a few hundred emails to this list in
the past 4 weeks :p

Cheers,

Alex