updated doc for update function