readme: update function defns