cython: add comments for all API methods
java: add error modes, version() & support diet engine