Possibly unnumbered list missing in Doc/c-api/function.rst

[rffontenelle]

Documentation

PyFunction_WatchEvent at c-api/function.rst has in the source file what seems to be a unnumbered list, but the built documentation has everything in a single line. Should it be formatted as a unnumbered list instead?

cpython/Doc/c-api/function.rst

Lines 146 to 155 in 798f8d3

	.. c:type:: PyFunction_WatchEvent
	Enumeration of possible function watcher events:
	- ``PyFunction_EVENT_CREATE``
	- ``PyFunction_EVENT_DESTROY``
	- ``PyFunction_EVENT_MODIFY_CODE``
	- ``PyFunction_EVENT_MODIFY_DEFAULTS``
	- ``PyFunction_EVENT_MODIFY_KWDEFAULTS``
	.. versionadded:: 3.12

Linked PRs

• gh-130169: Fix broken list in Doc/c-api/function.rst #130174
• [3.13] gh-130169: Fix broken list markup in Doc/c-api/function.rst (GH-130174) #130175
• [3.12] gh-130169: Fix broken list markup in Doc/c-api/function.rst (GH-130174) #130176

[terryjreedy]

The current presentation looks plausible to me since the meaning of each event is pretty clear from the name. The stat doc has several unnumbered lists. Most annotate each item, but the two lists for Windows do not and also give 1 item per line. I do not know what other docs do when annotation is not needed.

[sobolevn]

It should be:

    Enumeration of possible function watcher events:

    - ``PyFunction_EVENT_CREATE`` 
    - ``PyFunction_EVENT_DESTROY`` 
    - ``PyFunction_EVENT_MODIFY_CODE`` 
    - ``PyFunction_EVENT_MODIFY_DEFAULTS`` 
    - ``PyFunction_EVENT_MODIFY_KWDEFAULTS`` 
  

PR is welcome :)

[StanFromIreland]

@sobolevn You forgot to close the issue, also apologies for the PR, I should have waited.

[rffontenelle]

Thanks @StanFromIreland and @sobolevn !