update to the comments for private functions