PEP7 may need to add a info
Hi! When I read PEP7 and check Cpython source code, I found a deficiency that in https://www.python.org/dev/peps/pep-0007/#code-lay-out. In this section, document said that ''' For external functions and variables, we always have a declaration in an appropriate header file in the "Include" directory, which uses the PyAPI_FUNC() macro, like this: PyAPI_FUNC(PyObject *) PyObject_Repr(PyObject *); ''' but when i check python 3.7.12+ and python 2.7.13, external variables actually uses the PyAPI_DATA() macro, like this: ''' PyAPI_DATA(PyTypeObject) PySuper_Type; /* built-in 'super' */ ''' I wondered whether my error or the document error. bobozi.
Good catch! You can submit a PR or issue to the peps project in the Python organization on GitHub. On Fri, Dec 3, 2021 at 00:24 <zhouwenbonwpu@mail.nwpu.edu.cn> wrote:
Hi! When I read PEP7 and check Cpython source code, I found a deficiency that in https://www.python.org/dev/peps/pep-0007/#code-lay-out. In this section, document said that ''' For external functions and variables, we always have a declaration in an appropriate header file in the "Include" directory, which uses the PyAPI_FUNC() macro, like this: PyAPI_FUNC(PyObject *) PyObject_Repr(PyObject *); ''' but when i check python 3.7.12+ and python 2.7.13, external variables actually uses the PyAPI_DATA() macro, like this: ''' PyAPI_DATA(PyTypeObject) PySuper_Type; /* built-in 'super' */ ''' I wondered whether my error or the document error. bobozi. _______________________________________________ Python-ideas mailing list -- python-ideas@python.org To unsubscribe send an email to python-ideas-leave@python.org https://mail.python.org/mailman3/lists/python-ideas.python.org/ Message archived at https://mail.python.org/archives/list/python-ideas@python.org/message/B6YJ6D... Code of Conduct: http://python.org/psf/codeofconduct/
-- --Guido (mobile)
participants (2)
-
Guido van Rossum -
zhouwenbonwpu＠mail.nwpu.edu.cn