updated comments for functions