All these functions that return things through argument pointers need docs. It would be impossible to use this library without reading the code to see what fiddles with caller-owned structures.