[webreac]

If man pages were up to date, this should be the index of chapter 2. I have discover unix with sun in the 90s and I am very nostalgic of the quality of man pages. At that time, man pages were complete and up to date. My latest frustration was with the option -m of df command. Chapter 2 should be updated each time a new version of kernel is installed.

[mjw1007]

It's very strange that adding/updating documentation isn't treated as a basic requirement for a patch that adds to or modifies Linux's public interfaces.

[milcron]

For the BSDs, incorrect or missing man pages are considered a serious bug.

[dom0]

Man pages aren't even in the kernel tree.

[caf]

From Documentation/process/submit-checklist.rst:

  19) All new userspace interfaces are documented in ``Documentation/ABI/``.
      See ``Documentation/ABI/README`` for more information.
      Patches that change userspace interfaces should be CCed to
      [e-mail].

[valarauca1]

Michael Kerris keeps and up to date reference [1]. Even details _all_ system calls [2].

[1] https://www.kernel.org/doc/man-pages/

[2] http://man7.org/linux/man-pages/dir_section_2.html

[vog]

If you want that level of quality, don't use Linux, use instead FreeBSD or OpenBSD.