Documentation sucks

[jakobbossek]

Function documentation is very, say minimal, at the moment. We need to extend this considerably by adding much more information on the implementation details, pointers to the literature etc.