Updated docs to fix formatting errors

Docstring changes for the formatting bug listed here:
https://github.com/scikit-learn/scikit-learn/issues/2162

No significant change to the code. I can't see any reason why the recent modifications (in the previous PR) would disrupt Sphinx from building a new image.