updated API documentation

this concludes the most dreadful task in the history of dreadful tasks, namely going through all modules and classes call by call, adding signatures, paramters,
types etc to the docstrings... :/