document `wait` a little better