DOC: clean up scipy.special docs

Reformat scipy.special docstrings according to the standard + minor cleanups.

Cleaning up the definitions etc would need quite a bit of work still, but that's for a separate PRs.