On May 2, 2014, at 3:32 AM, Stephane Bortzmeyer <bortzmeyer@xxxxxx> wrote: > In my experience, so called "high-level" API are not high-level at > all, they always assume a specific programming style, typically the > one of the language the author prefers. The point is not to describe in detail the entry points to an API, but rather to describe the minimum functionality that an API should provide in order to allow the language and programs written in it to fully exploit the protocol. In MIF we talk about the low-level API and the high-level API; the low-level API is just a list of functions the API has to provide; the high-level API is built on that, and is likely language-specific. You can't build the language-specific API from just the abstract low-level API—you need to understand the locking/threading behavior of your language, and the memory allocation strategy, and so on.