document new API methods.