update defun docs and readme