Docstrings, docstrings, docstrings

[Clownshift]

This is only something to be done before the release, but i have been very sloppy with docstrings in the python API, therefore, basically every docstring needs to be checked, I fear...

[jokr91]

This is also somewhat true for the C++ part, as I have to document the functions in the header file...