improve docstrings

Merged Martin Reinecke requested to merge randomstate2 into NIFTy_6

Merge request reports