update docs, add function