further improvements to comments