MAINT/DOC: Whitespace tweaks in several docstrings.

The changes fix 12 "Unexpected indentation" warnings that
occur when building the HTML documentation with Sphinx 1.2.2.