René's URL Explorer Experiment


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

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@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-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:eea812f9-393e-cdb9-0dd5-ac1a6ae974cb
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idC0F8:3DC42C:923F86:C4807C:6A530C4B
html-safe-nonce0264e06addf21ad4339108f3cc132807e37d55072e2b03de5902ca8191fba80e
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDMEY4OjNEQzQyQzo5MjNGODY6QzQ4MDdDOjZBNTMwQzRCIiwidmlzaXRvcl9pZCI6IjYzMDYzNzM3NTg5Mzc2NjQ1ODciLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac80b8372ba7c8b0f32d0e753c35249a7f6e94f3571549d26978872355588471ce
hovercard-subject-tagissue:4506834476
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/cpython/150285/issue_layout
twitter:imagehttps://opengraph.githubassets.com/a4fd43e9e1027f8fec8ddbdf33463b6ffadcb199c4f67ed334918c8f472592ad/python/cpython/issues/150285
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/a4fd43e9e1027f8fec8ddbdf33463b6ffadcb199c4f67ed334918c8f472592ad/python/cpython/issues/150285
og:image:altFollowing 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:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameserhiy-storchaka
hostnamegithub.com
expected-hostnamegithub.com
Noneb9a586c06a05a7a86fc7e3f4dbd03e42f6869085879aa184aa6369456dbd50fb
turbo-cache-controlno-preview
go-importgithub.com/python/cpython git https://github.com/python/cpython.git
octolytics-dimension-user_id1525981
octolytics-dimension-user_loginpython
octolytics-dimension-repository_id81598961
octolytics-dimension-repository_nwopython/cpython
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id81598961
octolytics-dimension-repository_network_root_nwopython/cpython
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release07a982c1d40157c619b364352b704c3ce66bb332
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python/cpython/issues/150285#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fissues%2F150285
GitHub CopilotWrite better code with AIhttps://github.com/features/copilot
GitHub Copilot appDirect agents from issue to mergehttps://github.com/features/ai/github-app
MCP RegistryNewIntegrate external toolshttps://github.com/mcp
ActionsAutomate any workflowhttps://github.com/features/actions
CodespacesInstant dev environmentshttps://github.com/features/codespaces
IssuesPlan and track workhttps://github.com/features/issues
Code ReviewManage code changeshttps://github.com/features/code-review
GitHub Advanced SecurityFind and fix vulnerabilitieshttps://github.com/security/advanced-security
Code securitySecure your code as you buildhttps://github.com/security/advanced-security/code-security
Secret protectionStop leaks before they starthttps://github.com/security/advanced-security/secret-protection
Why GitHubhttps://github.com/why-github
Documentationhttps://docs.github.com
Bloghttps://github.blog
Changeloghttps://github.blog/changelog
Marketplacehttps://github.com/marketplace
View all featureshttps://github.com/features
Enterpriseshttps://github.com/enterprise
Small and medium teamshttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
App Modernizationhttps://github.com/solutions/use-case/app-modernization
DevSecOpshttps://github.com/solutions/use-case/devsecops
DevOpshttps://github.com/solutions/use-case/devops
CI/CDhttps://github.com/solutions/use-case/ci-cd
View all use caseshttps://github.com/solutions/use-case
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
View all industrieshttps://github.com/solutions/industry
View all solutionshttps://github.com/solutions
AIhttps://github.com/resources/articles?topic=ai
Software Developmenthttps://github.com/resources/articles?topic=software-development
DevOpshttps://github.com/resources/articles?topic=devops
Securityhttps://github.com/resources/articles?topic=security
View all topicshttps://github.com/resources/articles
Customer storieshttps://github.com/customer-stories
Events & webinarshttps://github.com/resources/events
Ebooks & reportshttps://github.com/resources/whitepapers
Business insightshttps://github.com/solutions/executive-insights
GitHub Skillshttps://skills.github.com
Documentationhttps://docs.github.com
Customer supporthttps://support.github.com
Community forumhttps://github.com/orgs/community/discussions
Trust centerhttps://github.com/trust-center
Partnershttps://github.com/partners
View all resourceshttps://github.com/resources
GitHub SponsorsFund open source developershttps://github.com/open-source/sponsors
Security Labhttps://securitylab.github.com
Maintainer Communityhttps://maintainers.github.com
Acceleratorhttps://github.com/open-source/accelerator
GitHub Starshttps://stars.github.com
Archive Programhttps://archiveprogram.github.com
Topicshttps://github.com/topics
Trendinghttps://github.com/trending
Collectionshttps://github.com/collections
Enterprise platformAI-powered developer platformhttps://github.com/enterprise
GitHub Advanced SecurityEnterprise-grade security featureshttps://github.com/security/advanced-security
Copilot for BusinessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Pricinghttps://github.com/pricing
Search syntax tipshttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
documentationhttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fissues%2F150285
Sign up https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=python%2Fcpython
Reloadhttps://github.com/python/cpython/issues/150285
Reloadhttps://github.com/python/cpython/issues/150285
Reloadhttps://github.com/python/cpython/issues/150285
Please reload this pagehttps://github.com/python/cpython/issues/150285
python https://github.com/python
cpythonhttps://github.com/python/cpython
Please reload this pagehttps://github.com/python/cpython/issues/150285
Notifications https://github.com/login?return_to=%2Fpython%2Fcpython
Fork 35k https://github.com/login?return_to=%2Fpython%2Fcpython
Star 73.8k https://github.com/login?return_to=%2Fpython%2Fcpython
Code https://github.com/python/cpython
Issues 5k+ https://github.com/python/cpython/issues
Pull requests 2.3k https://github.com/python/cpython/pulls
Actions https://github.com/python/cpython/actions
Projects https://github.com/python/cpython/projects
Security and quality 0 https://github.com/python/cpython/security
Insights https://github.com/python/cpython/pulse
Code https://github.com/python/cpython
Issues https://github.com/python/cpython/issues
Pull requests https://github.com/python/cpython/pulls
Actions https://github.com/python/cpython/actions
Projects https://github.com/python/cpython/projects
Security and quality https://github.com/python/cpython/security
Insights https://github.com/python/cpython/pulse
Line overflow in pydoc output due to long docstringshttps://github.com/python/cpython/issues/150285#top
https://github.com/serhiy-storchaka
3.15pre-release feature fixes, bugs and security fixeshttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%223.15%22
3.16new features, bugs and security fixeshttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%223.16%22
docsDocumentation in the Doc dirhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22docs%22
topic-argument-clinichttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22topic-argument-clinic%22
https://github.com/serhiy-storchaka
serhiy-storchakahttps://github.com/serhiy-storchaka
on May 23, 2026https://github.com/python/cpython/issues/150285#issue-4506834476
gh-150285: Fix too long docstrings in the curses module #150286https://github.com/python/cpython/pull/150286
gh-150285: Fix too long docstrings in the io module #150287https://github.com/python/cpython/pull/150287
gh-150285: Fix too long docstrings in the decimal module #150288https://github.com/python/cpython/pull/150288
gh-150285: Fix too long docstrings in the _remote_debugging module #150289https://github.com/python/cpython/pull/150289
gh-150285: Fix too long docstrings in the sqlite3 module #150290https://github.com/python/cpython/pull/150290
gh-150285: Fix too long docstrings in the zstd module #150291https://github.com/python/cpython/pull/150291
gh-150285: Fix too long docstrings in builtins #150293https://github.com/python/cpython/pull/150293
gh-150285: Fix too long docstrings in the pyexpat module #150294https://github.com/python/cpython/pull/150294
gh-150285: Fix too long docstrings in the os module #150296https://github.com/python/cpython/pull/150296
[3.15] gh-150285: Fix too long docstrings in the curses module (GH-150286) #150331https://github.com/python/cpython/pull/150331
[3.15] gh-150285: Fix too long docstrings in the io module (GH-150287) #150332https://github.com/python/cpython/pull/150332
[3.15] gh-150285: Fix too long docstrings in the decimal module (GH-150288) #150333https://github.com/python/cpython/pull/150333
[3.15] gh-150285: Fix too long docstrings in the _remote_debugging module (GH-150289) #150334https://github.com/python/cpython/pull/150334
[3.15] gh-150285: Fix too long docstrings in the zstd module (GH-150291) #150335https://github.com/python/cpython/pull/150335
[3.15] gh-150285: Fix too long docstrings in builtins (GH-150293) #150336https://github.com/python/cpython/pull/150336
[3.15] gh-150285: Fix too long docstrings in the pyexpat module (GH-150294) #150337https://github.com/python/cpython/pull/150337
gh-150285: Fix too long docstrings in Argument Clinic code #150338https://github.com/python/cpython/pull/150338
[3.15] gh-150285: Fix too long docstrings in the sqlite3 module (GH-150290) #150340https://github.com/python/cpython/pull/150340
[3.15] gh-150285: Fix too long docstrings in the os module (GH-150296) #150341https://github.com/python/cpython/pull/150341
[3.15] gh-150285: Fix too long docstrings in Argument Clinic code (GH-150338) #150350https://github.com/python/cpython/pull/150350
gh-150285: Fix too long docstrings in some Python modules #150366https://github.com/python/cpython/pull/150366
gh-150285: Fix too long docstrings in _wmi.exec_query #150373https://github.com/python/cpython/pull/150373
[3.15] gh-150285: Fix too long docstrings in some Python modules (GH-150366) #150375https://github.com/python/cpython/pull/150375
[3.15] gh-150285: Fix too long docstrings in _wmi.exec_query (GH-150373) #150377https://github.com/python/cpython/pull/150377
[3.14] gh-150285: Fix too long docstrings in the zstd module (GH-150291) (GH-150335) #150421https://github.com/python/cpython/pull/150421
[3.14] gh-150285: Fix too long docstrings in the curses module (GH-150286) #150457https://github.com/python/cpython/pull/150457
[3.14] gh-150285: Fix too long docstrings in the io module (GH-150287) #150458https://github.com/python/cpython/pull/150458
[3.14] gh-150285: Fix too long docstrings in the decimal module (GH-150288) #150460https://github.com/python/cpython/pull/150460
[3.14] gh-150285: Fix too long docstrings in the sqlite3 module (GH-150290) #150461https://github.com/python/cpython/pull/150461
[3.14] gh-150285: Fix too long docstrings in the pyexpat module (GH-150294) #150463https://github.com/python/cpython/pull/150463
[3.14] gh-150285: Fix too long docstrings in the os module (GH-150296) (GH-150341) #150464https://github.com/python/cpython/pull/150464
[3.13] gh-150285: Fix too long docstrings in the decimal module (GH-150288) (GH-150460) #150465https://github.com/python/cpython/pull/150465
[3.14] gh-150285: Fix too long docstrings in builtins (GH-150293) #150466https://github.com/python/cpython/pull/150466
[3.13] gh-150285: Fix too long docstrings in the pyexpat module (GH-150294) (GH-150463) #150468https://github.com/python/cpython/pull/150468
[3.13] gh-150285: Fix too long docstrings in the curses module (GH-150286) (GH-150457) #150469https://github.com/python/cpython/pull/150469
[3.13] gh-150285: Fix too long docstrings in the io module (GH-150287) (GH-150458) #150470https://github.com/python/cpython/pull/150470
[3.13] gh-150285: Fix too long docstrings in the sqlite3 module (GH-150290) (GH-150461) #150471https://github.com/python/cpython/pull/150471
[3.13] gh-150285: Fix too long docstrings in builtins (GH-150293) (GH-150466) #150472https://github.com/python/cpython/pull/150472
[3.14] gh-150285: Fix too long docstrings in Argument Clinic code (GH-150338) (GH-150350) #150473https://github.com/python/cpython/pull/150473
[3.14] gh-150285: Fix too long docstrings in some Python modules (GH-150366) (GH-150375) #150519https://github.com/python/cpython/pull/150519
[3.14] gh-150285: Fix too long docstrings in _wmi.exec_query (GH-150373) #150520https://github.com/python/cpython/pull/150520
[3.13] gh-150285: Fix too long docstrings in Argument Clinic code (GH-150338) (GH-150350) (GH-150473) #150526https://github.com/python/cpython/pull/150526
[3.13] gh-150285: Fix too long docstrings in some Python modules (GH-150366) (GH-150375) (GH-150519) #150530https://github.com/python/cpython/pull/150530
[3.13] gh-150285: Fix too long docstrings in _wmi.exec_query (GH-150373) (GH-150520) #150531https://github.com/python/cpython/pull/150531
gh-150285: Fix too long docstrings in the asyncio package #151074https://github.com/python/cpython/pull/151074
gh-150285: Fix too long docstrings in the concurrent package #151076https://github.com/python/cpython/pull/151076
gh-150285: Wrap long single-line summary in text output in pydoc #151081https://github.com/python/cpython/pull/151081
[3.15] gh-150285: Fix too long docstrings in the asyncio package (GH-151074) #151172https://github.com/python/cpython/pull/151172
[3.15] gh-150285: Fix too long docstrings in the concurrent package (GH-151076) #151173https://github.com/python/cpython/pull/151173
[3.14] gh-150285: Fix too long docstrings in the concurrent package (GH-151076) #151174https://github.com/python/cpython/pull/151174
[3.14] gh-150285: Fix too long docstrings in the asyncio package (GH-151074) #151175https://github.com/python/cpython/pull/151175
[3.13] gh-150285: Fix too long docstrings in the concurrent package (GH-151076) #151178https://github.com/python/cpython/pull/151178
[3.13] gh-150285: Fix too long docstrings in the asyncio package (GH-151074) (GH-151175) #151185https://github.com/python/cpython/pull/151185
[3.13] gh-150285: Fix merging error in GH-150458 #151320https://github.com/python/cpython/pull/151320
gh-150285: Suppress showing the __getstate__() comment in the help for dataclasses #151328https://github.com/python/cpython/pull/151328
[3.15] gh-150285: Suppress showing the __getstate__() comment in the help for dataclasses (GH-151328) #151331https://github.com/python/cpython/pull/151331
[3.14] gh-150285: Suppress showing the __getstate__() comment in the help for dataclasses (GH-151328) #151332https://github.com/python/cpython/pull/151332
[3.13] gh-150285: Suppress showing the __getstate__() comment in the help for dataclasses (GH-151328) #151333https://github.com/python/cpython/pull/151333
gh-150285: Fix too long docstrings in GenericAlias and __class_getitem__ #151354https://github.com/python/cpython/pull/151354
gh-150285: Fix overflow in too long lines for class data in pydoc #151366https://github.com/python/cpython/pull/151366
[3.15] gh-150285: Fix too long docstrings in GenericAlias and __class_getitem__ (GH-151354) #151367https://github.com/python/cpython/pull/151367
[3.14] gh-150285: Fix too long docstrings in GenericAlias and __class_getitem__ (GH-151354) #151368https://github.com/python/cpython/pull/151368
[3.13] gh-150285: Fix too long docstrings in GenericAlias and __class_getitem__ (GH-151354) #151369https://github.com/python/cpython/pull/151369
serhiy-storchakahttps://github.com/serhiy-storchaka
3.15pre-release feature fixes, bugs and security fixeshttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%223.15%22
3.16new features, bugs and security fixeshttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%223.16%22
docsDocumentation in the Doc dirhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22docs%22
topic-argument-clinichttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22topic-argument-clinic%22
docs issueshttps://github.com/orgs/python/projects/52
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.