minor updates to the comments