update doc & comments