DOC: An assortment of docstring corrections (mostly restructured text layout corrections)

This pull request fixes some docstrings and gets rid of a few of the warnings that occur when you build the docs.