fix ReST conversion error
converted docstrings to numpy style ReST format

- all parameters are documented
- all return values are documented
- every function and method has an example