audit: update the function comments