Review doc for all methods and for the C API; provide example for each method.
Freeze the API for version 1.0.
