Attn gawk and man-db maintainers: 3am pages shadowing 3p

[Warren Young]

Several gawk module manual pages (fnmatch, fork, readdir, and time(3am)) currently shadow pages of the same name in section 3p, owned by man-pages-posix.  These are currently dumped into the generic man3 directory, which causes them to take precedence over 3p because of this line in /etc/man_db.conf:

  SECTION     1 1p 8 2 3 3p 4 5 6 7 9 0p n

This causes “man readdir” to return the gawk page, not the POSIX page, as the user almost certainly intended.

To fix this, the man_db maintainer should add a 3am after 3p here, and the gawk maintainer should install the pages into the man3am directory.

Alternately, 3p could move in front of 3, since it’s more specific.  (You could say that man3p subclasses man3.)