added comments to new functions