implemented philoyore.distance; added some documentation