Reconcile C API with docs

This fixes #5286 and results from discussion on that issue.
But it is just as easy to use `npy_intp`, so why not?