Issue with current documentation:

In #24888 the npy_intp type was updated to alias Py_ssize_t (instead of intptr_t as previously). Its documentation was updated accordingly:

However, in the same file, the NPY_INTP enumerated type still refers to the equivalence with intptr_t (size of void*):

followed by:

Furthermore, the documentation for the Python-level dtype with matching name np.intp also refers to equivalence with intptr_t:

Idea or request for content:

So I am confused:

• are the documentation sections paragraph for the enumeration value and Python-level dtype object up to date?
• if so, I think it would be important to add a note to make the type discrepancy explicit (while explaining that this should not be a problem to confused Py_ssize_t with intptr_t on most platforms).
• if this not intended (that is, if the Python dtype and the enumeration value are now all aligned on Py_ssize_t/npy_intp), then those paragraphs should be updated.

Note: the documentation of npy_uintp np.uintp would deserve a similar clarification.