MAINT: minor cleanups to stats.theilslopes.

Add complete references, reST formatting, PEP8, etc.
DOC: add example for stats.theilslopes.
DOC: remove docstring of stats.mstats.theilslopes, use stats version.