Re: [PATCH 1/2] system_data_types.7: Document size_t

G. Branden Robinson
2020-09-28T13:55:14Z

[-- Attachment #1: Type: text/plain, Size: 934 bytes --]

Hi, Alex!

At 2020-09-28T15:48:14+0200, Alejandro Colomar wrote:
> > Where does this arbitrary-looking list of headers come from?
>
> There are two parts: left to the ';', and right to the ';'.
>
> Left: The canonical C standard header, and the canonical POSIX header,
> in alphabetical order.
>
> Right: All other headers that shall define the header, according to
> either the C or the POSIX standards, in alphabetical order.

That's not a bad scheme but it is not inferable from the current man
page text; I almost commented on the inconsistency in one of my earlier
messages but deemed it out of scope. Please document it, perhaps in an
introductory paragraph at the top of the Description section.

Or, you could spend a word to do the same work:

gid_t Include: <sys/types.h>. Alternatively, <grp.h>, <pwd.h>,
<signal.h>, <stropts.h>, <sys/ipc.h>, <sys/stat.h>, or <unistd.h>.

Regards,
Branden

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]