updated comments to describe function parameters.