Updated a number of docstrings.

Made some of the docstrings a bit more accurate and removed some
superfluous comments.