-
-
Notifications
You must be signed in to change notification settings - Fork 33.3k
Closed
Labels
Description
Many of the C "constants" (actually macros without parameters) are declared in the documentation using the data directive and referred using :data: and :const: roles. It is incorrect, because these directive and roles are defined in the Python domain and purposed to use with Python module level variables. I think that it is better to document them as they are, the C macros.
One of the differences is that the HTML anchors contains the c. prefix, e.g. c.METH_VARARGS. There may also be the difference in visual representation.
Other issues in the current markup:
- In the index they are marked as "(built-in variable)".
- There are no index entries for
METH_KEYWORDSandMETH_METHODand they cannot be referred. - There are two definitions of
Py_TPFLAGS_HAVE_GC. They does not conflict only because they are in different namespaces.