Bug report

pydoc incorrectly shows some comments for argparse:

     |  format_help(self)
     |      # =======================
     |      # Help-formatting methods
     |      # =======================
     |
     |  start_section(self, heading)
     |      # ========================
     |      # Message building methods
     |      # ========================
     |

Comments immediately preceding the object's source code are used if the object has no docstring. But these comments do not describe the following methods. They are just section headers, separating groups of methods. They should be separated by an empty line from the following code.

Linked PRs

• gh-134109: Fix showing comments in pydoc output for argparse #134110
• [3.14] gh-134109: Fix showing comments in pydoc output for argparse (GH-134110) #134112
• [3.13] gh-134109: Fix showing comments in pydoc output for argparse (GH-134110) #134113