I am currently in the process of revamping docs (doxygen) and documenting all the newer features on the wiki. The current API docs are quite lacking - it was OK in the first few versions as the API itself was fairly limited, but it has now expanded quite a bit. It shouldn't be too long now.