update documents for new function