re: kern/37427 document _ksem_* syscalls

[matthew green <mrg%eterna.com.au@localhost>]

>  We currently have man pages for sem(4) with cross-refs to several other 
>  pages for the specific functions.
>  
>  Is there any reason why this is insufficient?  If this is OK, I will 
>  close the PR.

is there documentation on the backend that is sufficient?  how is
someone supposed to look at the sem(4) code without understanding
the system calls that back it?

i don't agree that "hidden" functionality should not be documented,
and for actual system calls i don't believe that "in the sources"
suffices.


.mrg.