Complete documentation of current API

Completes the documentation of the API as it is today.