update functions' documentations