Converting docstrings to numpydoc

Some work done on issue #466.

There are some cases I am not sure of.

I'll squash more commits to this pull request later.
This type splits into two lines. What should I do?