new comments to several functions added