Line overflow in pydoc output due to long docstrings

[serhiy-storchaka]

Following PEP 8 automatically leads to pydoc generating outpurt that fits in 80 columns, except some long signatures, inherited standard docstrings and URIs. Exceptions happen here and there, and I usually fix them whem working on the module. Things are more complicated with the C code. Old docstrings mostly fit in 80 columns, but Argument Clinic provokes writing longer lines. There is a check for docstring line width, but it is incorrect. It's now a chicken and egg problem. We cannot simply fix the limits in Argument Clinic, because this will produce a large amount of warnings and errors (especially in recently added modules), but until it was fixed, the new code will add too long docstrings.

There are only few modules which need large number of corrections and many modules which require only 1-2 fixes. Most modules do not need any changes. I am going to fix large modules in separate PRs, then fix many simple cases at once and fix the limits in Argument Clinic.

Linked PRs

• gh-150285: Fix too long docstrings in the curses module #150286
• gh-150285: Fix too long docstrings in the io module #150287
• gh-150285: Fix too long docstrings in the decimal module #150288
• gh-150285: Fix too long docstrings in the _remote_debugging module #150289
• gh-150285: Fix too long docstrings in the sqlite3 module #150290
• gh-150285: Fix too long docstrings in the zstd module #150291
• gh-150285: Fix too long docstrings in builtins #150293
• gh-150285: Fix too long docstrings in the pyexpat module #150294
• gh-150285: Fix too long docstrings in the os module #150296