update docs for new function