update comments to match the described function