more documentation; changing a return type on a C api function