update comments to reflect changed code