distance.Rd largely documents the old R-based distance function

[gavinsimpson]

Update documentation in distance.Rd to reflect the current distance(). Probably time to kill off oldDistance() now and leave it only unexported to check if I ever break things - hence the tests.