improved wording of some comments