Re: [Python-Dev] Is there any docstring format used inside CPython core?

2017-04-13 Thread Guido van Rossum
There are extensive docs for CPython's public API at https://docs.python.org/3/c-api/index.html. For functions that are exposed to Python via an extension module there's the Argument Clinic, incompletely implemented, see PEP 436 (accepted). For functions that are neither (like the ones you mentio

Re: [Python-Dev] Is there any docstring format used inside CPython core?

2017-04-13 Thread Ivan Levkivskyi
On 13 April 2017 at 13:26, Louie Lu wrote: > Hi everyone, > Is there any docstring format used inside CPython core? e.g. Doxygen. > I don't think there is anything beyond https://www.python.org/dev/peps/pep-0257/ -- Ivan ___ Python-Dev mailing list Py

[Python-Dev] Is there any docstring format used inside CPython core?

2017-04-13 Thread Louie Lu
Hi everyone, Is there any docstring format used inside CPython core? e.g. Doxygen. During the tour to know more about CPython, I found that some part of the internal function didn't comment that intuitive, for example, `tok_get` return value, `tok_decimal_tail` description, ...etc. If there is a