Post Syndicated from original https://lwn.net/Articles/906496/

The kernel’s manual
pages are in a bit of an interesting position. They
are managed as a separate project, distinct from the kernel’s
documentation, and have the task of documenting both the kernel’s
system-call interface and the wrappers for that interface provided by the C
library. Sometimes the two objectives come into conflict, as can be seen
in a discussion that has been playing out over the course of the last year
on whether to use C standard type names to describe kernel-defined
structures.