more fixing up of comments