Title: Line overflow in pydoc output due to long docstrings · Issue #150285 · python/cpython · GitHub
Open Graph Title: Line overflow in pydoc output due to long docstrings · Issue #150285 · python/cpython
X Title: Line overflow in pydoc output due to long docstrings · Issue #150285 · python/cpython
Description: 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 mo...
Open Graph Description: 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...
X Description: 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...
Opengraph URL: https://github.com/python/cpython/issues/150285
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Line overflow in pydoc output due to long docstrings","articleBody":"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.\n\nThere 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.\n\n\u003c!-- gh-linked-prs --\u003e\n### Linked PRs\n* gh-150286\n* gh-150287\n* gh-150288\n* gh-150289\n* gh-150290\n* gh-150291\n* gh-150293\n* gh-150294\n* gh-150296\n* gh-150331\n* gh-150332\n* gh-150333\n* gh-150334\n* gh-150335\n* gh-150336\n* gh-150337\n* gh-150338\n* gh-150340\n* gh-150341\n* gh-150350\n* gh-150366\n* gh-150373\n* gh-150375\n* gh-150377\n* gh-150421\n* gh-150457\n* gh-150458\n* gh-150460\n* gh-150461\n* gh-150463\n* gh-150464\n* gh-150465\n* gh-150466\n* gh-150468\n* gh-150469\n* gh-150470\n* gh-150471\n* gh-150472\n* gh-150473\n* gh-150519\n* gh-150520\n* gh-150526\n* gh-150530\n* gh-150531\n* gh-151074\n* gh-151076\n* gh-151081\n* gh-151172\n* gh-151173\n* gh-151174\n* gh-151175\n* gh-151178\n* gh-151185\n* gh-151320\n* gh-151328\n* gh-151331\n* gh-151332\n* gh-151333\n* gh-151354\n* gh-151366\n* gh-151367\n* gh-151368\n* gh-151369\n\u003c!-- /gh-linked-prs --\u003e\n","author":{"url":"https://github.com/serhiy-storchaka","@type":"Person","name":"serhiy-storchaka"},"datePublished":"2026-05-23T04:33:57.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":10},"url":"https://github.com/150285/cpython/issues/150285"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:eea812f9-393e-cdb9-0dd5-ac1a6ae974cb |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C0F8:3DC42C:923F86:C4807C:6A530C4B |
| html-safe-nonce | 0264e06addf21ad4339108f3cc132807e37d55072e2b03de5902ca8191fba80e |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDMEY4OjNEQzQyQzo5MjNGODY6QzQ4MDdDOjZBNTMwQzRCIiwidmlzaXRvcl9pZCI6IjYzMDYzNzM3NTg5Mzc2NjQ1ODciLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 80b8372ba7c8b0f32d0e753c35249a7f6e94f3571549d26978872355588471ce |
| hovercard-subject-tag | issue:4506834476 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/150285/issue_layout |
| twitter:image | https://opengraph.githubassets.com/a4fd43e9e1027f8fec8ddbdf33463b6ffadcb199c4f67ed334918c8f472592ad/python/cpython/issues/150285 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/a4fd43e9e1027f8fec8ddbdf33463b6ffadcb199c4f67ed334918c8f472592ad/python/cpython/issues/150285 |
| og:image:alt | 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... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | serhiy-storchaka |
| hostname | github.com |
| expected-hostname | github.com |
| None | b9a586c06a05a7a86fc7e3f4dbd03e42f6869085879aa184aa6369456dbd50fb |
| turbo-cache-control | no-preview |
| go-import | github.com/python/cpython git https://github.com/python/cpython.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 81598961 |
| octolytics-dimension-repository_nwo | python/cpython |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 81598961 |
| octolytics-dimension-repository_network_root_nwo | python/cpython |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 07a982c1d40157c619b364352b704c3ce66bb332 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width