Update the documentation to represent the new API.
The API is now clean enough for me.