BF+RF: fix, cleanup distances docstrings

I've changed the docstring test output in some cases.  Can y'all please
check carefully that I haven't certified any wrong results?

I ran the doctest tests with::

    python setup.py build_ext -i && ./tools/doctest_extmods.py dipy