[Numpy-discussion] C api doc shortcomings
Mon Aug 1 04:37:09 CDT 2011
I noticed that the c-api docs (2.0.dev-72ab385) lack a clear statement
what the preferred entry point into the c-api is (from a users point of
view). Normally I would expect a sentence or two stating that the api
entry point is arrayobject.h (or whatever).
Instead the docs ponder about reading the c sources but do not give any
hints where to start. I suggest something akin to the official Python
docs in a prominent place:
All function, type and macro definitions needed to use the Python/C API
are included in your code by the following line:
This implies inclusion of the following standard headers: <stdio.h>,
<string.h>, <errno.h>, <limits.h>, <assert.h> and <stdlib.h> (if available).
modified for Numpy.
More information about the NumPy-Discussion