Further clean up some comments wrt the peer socket handling API