Hi Michael,
We have some structures defined in system_data_types(7) for which we
don't have a link page, because it would have shadowed other more
important pages.
I've been documenting 'struct stat', and it happens the same: I'd shadow
stat(2) with stat(3).
But I need to refer to stat(3) (or whatever link page we decide to have)
from stat(2). So I need one (referring to system_data_types(7) isn't
very informative).
How about adding struct-stat(2)?
However, that means that we should also add struct-xxx(3) / union-xxx(3)
for all of the structs/unions we have documented there (one might
reasonably expect to be able to find struct-aiocb(3) or union-sigval(3)
if there's a struct-stat(3)).
What do you think about it?
Thanks,
Alex
--
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/