add comments to some function