[comparable distance] fix comments so that they make sense wrt to the code they refer to