The doc on the distance property below is excellent.  It would be helpful to have it here, too.