update functions comments