René's URL Explorer Experiment


Title: gh-141196: Fix threading.Semaphore documentation inconsistency by mohsinm-dev · Pull Request #141243 · python/cpython · GitHub

Open Graph Title: gh-141196: Fix threading.Semaphore documentation inconsistency by mohsinm-dev · Pull Request #141243 · python/cpython

X Title: gh-141196: Fix threading.Semaphore documentation inconsistency by mohsinm-dev · Pull Request #141243 · python/cpython

Description: Summary Fixes issue #141196 by correcting inconsistent documentation in threading.Semaphore. Problem The acquire() method documentation stated "Exactly one thread will be awoken by each call to release()" which became incorrect when the n parameter was added to release() in Python 3.9. Solution Updated acquire() docs to reflect that release(n) wakes min(j,n) threads where j = waiting threads Clarified release() docs to specify "up to n threads" are awakened Implementation The fix aligns documentation with actual behavior: Semaphore.release(n) calls Condition.notify(n), which wakes exactly min(n, waiting_threads) threads. Testing Verified with test cases: release() → 1 thread woken release(2) with 3 waiting → 2 threads woken release(5) with 2 waiting → 2 threads woken Documentation-only change, no code modifications required. Issue: gh-141196 📚 Documentation preview 📚: https://cpython-previews--141243.org.readthedocs.build/

Open Graph Description: Summary Fixes issue #141196 by correcting inconsistent documentation in threading.Semaphore. Problem The acquire() method documentation stated "Exactly one thread will be awoken by each call t...

X Description: Summary Fixes issue #141196 by correcting inconsistent documentation in threading.Semaphore. Problem The acquire() method documentation stated "Exactly one thread will be awoken by each ca...

Opengraph URL: https://github.com/python/cpython/pull/141243

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:9bfb80d2-a9a5-aab9-66e2-7a57d1a12970
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idB67C:C257A:837ABE:BA92E4:6A5105D4
html-safe-nonce349d9fd4bb6ac8d8082b6b4911fb1c7db156b46e8e30e2860924f327a5321cbb
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCNjdDOkMyNTdBOjgzN0FCRTpCQTkyRTQ6NkE1MTA1RDQiLCJ2aXNpdG9yX2lkIjoiNTkzMTIxMDIwODE3MjkwMTg0NSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac482e310a4f5872e3bf106c0ba7f1a1d0bca21f1abc6613ba9c9dd60320989c8a
hovercard-subject-tagpull_request:2991443080
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/python/cpython/pull/141243/files
twitter:imagehttps://avatars.githubusercontent.com/u/55545648?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/55545648?s=400&v=4
og:image:altSummary Fixes issue #141196 by correcting inconsistent documentation in threading.Semaphore. Problem The acquire() method documentation stated "Exactly one thread will be awoken by each call t...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None38906a4da4e3e9fd88dfeacee232f5932c0c5f7495de3b4efc53ddfac7173d12
turbo-cache-controlno-preview
diff-viewunified
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 full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release90441ea9b98e7491aa6ebcd135fccce4e2396f48
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python/cpython/pull/141243/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fpull%2F141243%2Ffiles
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%2Fpull%2F141243%2Ffiles
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%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=python%2Fcpython
Reloadhttps://github.com/python/cpython/pull/141243/files
Reloadhttps://github.com/python/cpython/pull/141243/files
Reloadhttps://github.com/python/cpython/pull/141243/files
Please reload this pagehttps://github.com/python/cpython/pull/141243/files
python https://github.com/python
cpythonhttps://github.com/python/cpython
Please reload this pagehttps://github.com/python/cpython/pull/141243/files
Notifications https://github.com/login?return_to=%2Fpython%2Fcpython
Fork 35k https://github.com/login?return_to=%2Fpython%2Fcpython
Star 73.7k 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
Sign up for GitHub https://github.com/signup?return_to=%2Fpython%2Fcpython%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fpython%2Fcpython%2Fissues%2Fnew%2Fchoose
mohsinm-devhttps://github.com/mohsinm-dev
python:mainhttps://github.com/python/cpython/tree/main
mohsinm-dev:fix-gh-141196-semaphore-docshttps://github.com/mohsinm-dev/cpython/tree/fix-gh-141196-semaphore-docs
Conversation 0 https://github.com/python/cpython/pull/141243
Commits 3 https://github.com/python/cpython/pull/141243/commits
Checks 62 https://github.com/python/cpython/pull/141243/checks
Files changed https://github.com/python/cpython/pull/141243/files
Please reload this pagehttps://github.com/python/cpython/pull/141243/files
gh-141196: Fix threading.Semaphore documentation inconsistency https://github.com/python/cpython/pull/141243/files#top
Show all changes 3 commits https://github.com/python/cpython/pull/141243/files
81931c7 gh-141218: Fix inaccurate object comparison documentation mohsinm-dev Nov 8, 2025 https://github.com/python/cpython/pull/141243/commits/81931c7c537eef3c4da53feacafecf7d54414e64
37bb282 Remove news entry for documentation-only change mohsinm-dev Nov 8, 2025 https://github.com/python/cpython/pull/141243/commits/37bb2829691d018e4e57ac19edd9bb479bd3f2ca
372b843 gh-141196: Fix threading.Semaphore documentation inconsistency mohsinm-dev Nov 8, 2025 https://github.com/python/cpython/pull/141243/commits/372b843ed650372bf6f93d1b9a23ba994b070788
Clear filters https://github.com/python/cpython/pull/141243/files
Please reload this pagehttps://github.com/python/cpython/pull/141243/files
Please reload this pagehttps://github.com/python/cpython/pull/141243/files
stdtypes.rst https://github.com/python/cpython/pull/141243/files#diff-08a31a70dd1f6d97aa8dacdce77db4de04c700d9949be1af611a595186aad5b3
threading.rst https://github.com/python/cpython/pull/141243/files#diff-6a424b7e58eb2394ee0335dd6e08ab8d67e7058852fae0f3aa1b40493fa14a64
Doc/library/stdtypes.rsthttps://github.com/python/cpython/pull/141243/files#diff-08a31a70dd1f6d97aa8dacdce77db4de04c700d9949be1af611a595186aad5b3
View file https://github.com/mohsinm-dev/cpython/blob/372b843ed650372bf6f93d1b9a23ba994b070788/Doc/library/stdtypes.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/141243/{{ revealButtonHref }}
https://github.com/python/cpython/pull/141243/files#diff-08a31a70dd1f6d97aa8dacdce77db4de04c700d9949be1af611a595186aad5b3
https://github.com/python/cpython/pull/141243/files#diff-08a31a70dd1f6d97aa8dacdce77db4de04c700d9949be1af611a595186aad5b3
Doc/library/threading.rsthttps://github.com/python/cpython/pull/141243/files#diff-6a424b7e58eb2394ee0335dd6e08ab8d67e7058852fae0f3aa1b40493fa14a64
View file https://github.com/mohsinm-dev/cpython/blob/372b843ed650372bf6f93d1b9a23ba994b070788/Doc/library/threading.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/141243/{{ revealButtonHref }}
https://github.com/python/cpython/pull/141243/files#diff-6a424b7e58eb2394ee0335dd6e08ab8d67e7058852fae0f3aa1b40493fa14a64
https://github.com/python/cpython/pull/141243/files#diff-6a424b7e58eb2394ee0335dd6e08ab8d67e7058852fae0f3aa1b40493fa14a64
https://github.com/python/cpython/pull/141243/files#diff-6a424b7e58eb2394ee0335dd6e08ab8d67e7058852fae0f3aa1b40493fa14a64
Please reload this pagehttps://github.com/python/cpython/pull/141243/files
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.