Fix for change default of neighbors distance warning issue

See issue #1599

Removes the warning, adds warnings to the regressor/classifier docstrings, as well as to the narative docs