The overarching value proposition is to make links DWIM, untested, to the maximum extent possible. That means, in general, linking to the largest vocabulary available, at least by default.

The only potential problem comes in when functions have conflicting semantics. In that case, the user should specify which vocabulary she intends, explicitly.

++

Never felt otherwise. Even tho it likely appeared so.

I only make one exception; given that BSD follows POSIX, and is often considered POSIX. Linux, only has some POSIX.

Summary:
They are called "UNIX man pages"
UNIX, and BSD are both POSIX systems.
In the end, the user should be aware of the differences between them.
In all cases, the "linker" should verify that the man page choice they made, actually returns a man page. -- which I think, speaks to your point.

Note also; this is not an attempt to argue against your position, in any way. Only a justification to my related assertions. :)

--Chris

EDIT: I'd like to add; That I'm in complete agreement with tye's assertion earlier. My posted objection was intended to be "tongue-in-cheek".


Hey. I'm not completely useless. I can be used as a bad example.

Whatever. I think you get hung up on the "UNIX" in the name. I have edited the documentation to read "UNIX/Linux".