correct small typos used in the API

- Minors corrections to function docblocks