fix #34: update documentation wrt changes in API