clean up docstrings: fix reST formatting issues.
  cherry-picked f03e0a7092 + some more.
Merge pull request #29 from kngenie/just-a-cleanup

clean up docstrings: fix reST formatting issues.