shortest_distance(): fix docstring

This fixes issue #731.
3 jobs for master