re: kern/37427 document _ksem_* syscalls

[Paul Goyette <paul%vps1.whooppee.com@localhost>]

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

From: Paul Goyette <paul%vps1.whooppee.com@localhost>
To: matthew green <mrg%eterna.com.au@localhost>
Cc: gnats-bugs%NetBSD.org@localhost, 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 06:29:10 +0800 (PHT)

 On Sun, 29 Nov 2015, matthew green wrote:
 
 >>  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.
 
 Ah, so in addition to wanting the syscalls themselves documented
 (which we have already), you want to see a ksem(9) man page 
 describing the internal workings?
 
 Let me see if I can do something here...  Step 1 - study code ...
 
 
 +------------------+--------------------------+-------------------------+
 | Paul Goyette     | PGP Key fingerprint:     | E-mail addresses:       |
 | (Retired)        | FA29 0E3B 35AF E8AE 6651 | paul at whooppee.com    |
 | Kernel Developer | 0786 F758 55DE 53BA 7731 | pgoyette at netbsd.org  |
 +------------------+--------------------------+-------------------------+