added comments to exposed user functions