DOC: Fix formatting for Raises section
DOC: Add simple examples, link function names, mention that input arrays are converted to float (no integer or complex or object)
DOC: minor edits to spatial.distance.cdist docstring.
Merge branch 'pr/3746' into master.

Reviewed at https://github.com/scipy/scipy/pull/3746