Doc: more words.

Added more text about the API, since the bare function documentation is rather raw.