re: kern/37427 document _ksem_* syscalls

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

The following reply was made to PR kern/37427; it has been noted by GNATS.

From: matthew green <mrg%eterna.com.au@localhost>
To: gnats-bugs%NetBSD.org@localhost
Cc: pgoyette%NetBSD.org@localhost, gnats-admin%netbsd.org@localhost, netbsd-bugs%netbsd.org@localhost,
    mmondor%pulsar-zone.net@localhost
Subject: re: kern/37427 document _ksem_* syscalls
Date: Sun, 29 Nov 2015 08:02:01 +1100

 >  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.