MAINT/DOC: Whitespace tweaks in several docstring.

The changes fix 12 "Unexpected indentation" warnings that
occur when building the HTML documentation with Sphinx 1.2.2.
Merge pull request #3906 from WarrenWeckesser/fix-doc-warnings

MAINT/DOC: Whitespace tweaks in several docstrings.