one of the best ways to find shortcomings in an API is to attempt to document it comprehensively.
Hmmm. Another way would be to require someone to write a non-trivial program which uses the API to do something useful.
Copyright © 2018, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds