René's URL Explorer Experiment


Title: gh-86726: Document the full public API of tkinter by serhiy-storchaka · Pull Request #151579 · python/cpython · GitHub

Open Graph Title: gh-86726: Document the full public API of tkinter by serhiy-storchaka · Pull Request #151579 · python/cpython

X Title: gh-86726: Document the full public API of tkinter by serhiy-storchaka · Pull Request #151579 · python/cpython

Description: Replace the previously sparse reference documentation with full coverage of the public API of the tkinter package, written from the Tcl/Tk manual pages, the existing documentation and the module docstrings. Doc/library/tkinter.rst gains a "Reference" section documenting every public class, method, function and constant of the core module -- the widgets, the Misc, Wm, Pack, Place, Grid, XView and YView mix-ins, the Variable and image classes, the module-level functions and the symbolic constants. Doc/library/tkinter.ttk.rst, dialog.rst, tkinter.font.rst and the other module pages document their remaining classes, methods and functions. The descriptions are Python-oriented (correct return types -- tuples rather than Tcl lists, booleans, integers, None on cancellation, and so on) and were checked against the Tcl/Tk 9.1 manual pages and the implementation. versionadded, versionchanged and deprecated directives are added for the public API, determined from the git history relative to Python 3.0: the tkinter.ttk module (3.1); the Text, Wm, Menu and Misc methods exposing Tk 8.5 features (3.3); and the many later additions and behavior changes up to 3.15. The Tk version required by features added after Tk 8.6 is noted as well. The bundled Tcl/Tk version is updated to 9.0 and the manual-page links point at the tcl9.0 reference. Issue: gh-59551 Issue: gh-86726

Open Graph Description: Replace the previously sparse reference documentation with full coverage of the public API of the tkinter package, written from the Tcl/Tk manual pages, the existing documentation and the module do...

X Description: Replace the previously sparse reference documentation with full coverage of the public API of the tkinter package, written from the Tcl/Tk manual pages, the existing documentation and the module do...

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

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:eb7986a7-7111-4e97-7f88-b346be84ce5f
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idBD5E:43AB7:26CA96C:34F02D3:6A543839
html-safe-nonce1f696558cb8cc46c5597c92d00bd30ffd9107ce65512076ddca2a2cc65bd7243
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCRDVFOjQzQUI3OjI2Q0E5NkM6MzRGMDJEMzo2QTU0MzgzOSIsInZpc2l0b3JfaWQiOiI3MzE3ODU2MjgyNDc1NzcxOTYxIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmacd7ac33d7c855fb96368ee84191bf854a040fa087872a18d2732c230daf8c4046
hovercard-subject-tagpull_request:3881352831
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/151579/files
twitter:imagehttps://avatars.githubusercontent.com/u/3659035?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/3659035?s=400&v=4
og:image:altReplace the previously sparse reference documentation with full coverage of the public API of the tkinter package, written from the Tcl/Tk manual pages, the existing documentation and the module do...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
Noneb9a586c06a05a7a86fc7e3f4dbd03e42f6869085879aa184aa6369456dbd50fb
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
release07a982c1d40157c619b364352b704c3ce66bb332
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python/cpython/pull/151579/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fpull%2F151579%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%2F151579%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/151579/files
Reloadhttps://github.com/python/cpython/pull/151579/files
Reloadhttps://github.com/python/cpython/pull/151579/files
Please reload this pagehttps://github.com/python/cpython/pull/151579/files
python https://github.com/python
cpythonhttps://github.com/python/cpython
Please reload this pagehttps://github.com/python/cpython/pull/151579/files
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
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
serhiy-storchakahttps://github.com/serhiy-storchaka
python:mainhttps://github.com/python/cpython/tree/main
serhiy-storchaka:tk-docshttps://github.com/serhiy-storchaka/cpython/tree/tk-docs
Conversation 24 https://github.com/python/cpython/pull/151579
Commits 19 https://github.com/python/cpython/pull/151579/commits
Checks 32 https://github.com/python/cpython/pull/151579/checks
Files changed https://github.com/python/cpython/pull/151579/files
Please reload this pagehttps://github.com/python/cpython/pull/151579/files
gh-86726: Document the full public API of tkinter https://github.com/python/cpython/pull/151579/files#top
Show all changes 19 commits https://github.com/python/cpython/pull/151579/files
cca5145 gh-59551: Document the full public API of tkinter serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/cca51459524131915d2f67a56172b98f39a2eb51
9d7c91e gh-59551: Do not document tkinter aliases separately serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/9d7c91e10de085f1f10f689c01c13c634f0d6a3d
77f3ae0 gh-59551: Document tkinter aliases as hidden :no-typesetting: anchors serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/77f3ae0d883440453a16672444cd0521ee98e996
303589e gh-59551: Replace the ['_noarg_'] sentinel with two tkinter signatures serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/303589e6d5c059755676f1e8d6aaca3d68719f4e
5b2a713 gh-59551: Reformat tkinter docs with one sentence per line serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/5b2a713f87d9330b587c30f29e7cf31056819561
19f6605 gh-59551: Describe wm_ aliases like other tkinter aliases serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/19f6605f69dbad248ca4d7694a65ccc8fdf146d1
2935f81 gh-59551: Remove docs for internal ttk helpers serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/2935f8157b1033b4ba095568a2a3a57e288db729
d126ff1 gh-59551: Fix broken cross-references in tkinter docs serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/d126ff1b6415bbbac84b404bdc2df56872b39874
c784350 gh-59551: Fix cross-references in the tkinter documentation serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/c784350c63133b181c3b146e0bd5cabb98e3fad9
f3d9376 gh-59551: Fix the remaining cross-references in the ttk documentation serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/f3d9376018a52dcd00ef7de7355f10aa3ea71c70
f1cdcd4 gh-59551: Restore wrapping in two filedialog ok_command descriptions serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/f1cdcd406f1a733d371610099384ff3a88c42048
1a8e499 gh-86726: Correct the issue number of the tkinter docs NEWS entry serhiy-storchaka Jun 17, 2026 https://github.com/python/cpython/pull/151579/commits/1a8e499474e60d4fd4d7494c6012177fe69b0cd8
ab6edbd Apply suggestions from code review serhiy-storchaka Jun 18, 2026 https://github.com/python/cpython/pull/151579/commits/ab6edbd0fdf194fd30a971a3733bdede440b0968
3074205 gh-59551: Spell out e.g. and i.e. in the tkinter documentation serhiy-storchaka Jun 18, 2026 https://github.com/python/cpython/pull/151579/commits/307420561d18d086123e865c63309b87bbac9835
1bd252f gh-59551: Document grid_anchor only as a Misc method serhiy-storchaka Jun 18, 2026 https://github.com/python/cpython/pull/151579/commits/1bd252f299a56981a9f1f1a6a59fce88f4f2fe97
774052b gh-59551: Use sentence case for section headings in the tkinter docum… serhiy-storchaka Jun 18, 2026 https://github.com/python/cpython/pull/151579/commits/774052bdea1ed679544b0bd33a620dcf2364c41e
01fcf71 Apply suggestions from code review serhiy-storchaka Jun 18, 2026 https://github.com/python/cpython/pull/151579/commits/01fcf716cabfbe51ec58ee2bd0a80e03e52d59dc
3417306 gh-59551: Document the supported options of tkinter widgets and their… serhiy-storchaka Jun 18, 2026 https://github.com/python/cpython/pull/151579/commits/3417306f7b11aa7ae2cabb8f022c202fb0d4f67a
414cadf Merge branch 'tk-docs' of github.com:serhiy-storchaka/cpython into tk… serhiy-storchaka Jun 18, 2026 https://github.com/python/cpython/pull/151579/commits/414cadf2de06862f192f9255a2b4b31b658ee827
Clear filters https://github.com/python/cpython/pull/151579/files
Please reload this pagehttps://github.com/python/cpython/pull/151579/files
Please reload this pagehttps://github.com/python/cpython/pull/151579/files
dialog.rst https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
tkinter.colorchooser.rst https://github.com/python/cpython/pull/151579/files#diff-2481dc58d855e1851f12d005f1d949ca220884d51e51db22fc91374ae9076b79
tkinter.dnd.rst https://github.com/python/cpython/pull/151579/files#diff-1312e1c4d76941d036eefacdb566bfa9ef16b863091ca7dd80659fdbd06daa17
tkinter.font.rst https://github.com/python/cpython/pull/151579/files#diff-a33b7144095db546182665f595273280ea8f77fd8cfd99ac042bacd6d049fbae
tkinter.messagebox.rst https://github.com/python/cpython/pull/151579/files#diff-67fcf06882c7b5a06f2fa3c0f6b279105d5e3f0c3069a55fb5c51d9212e25287
tkinter.rst https://github.com/python/cpython/pull/151579/files#diff-1474691a0ba30ae7c19667e97827dad2b104dd34803e2a0cafdf845a49680a2e
tkinter.scrolledtext.rst https://github.com/python/cpython/pull/151579/files#diff-33be46bb808aa5876d5e48286be57a3f13301c4725c17d3c1713ef018f5f4ca3
tkinter.ttk.rst https://github.com/python/cpython/pull/151579/files#diff-acfe59a664ddbf76c9a3cd8a9d9df7a8c309fba9775f831372eb2beeac19b9d5
.nitignore https://github.com/python/cpython/pull/151579/files#diff-b7c84835b887ce2fbbbbdbfb8aaee3317c5b731ed4c6c4682e122de334984c9c
2026-06-17-12-00-00.gh-issue-86726.__bOgH.rst https://github.com/python/cpython/pull/151579/files#diff-f9e6814c27e34e140257810f8e4558ec5f3eb3b02ded442b4044e53539a8f881
Doc/library/dialog.rsthttps://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
View file https://github.com/serhiy-storchaka/cpython/blob/414cadf2de06862f192f9255a2b4b31b658ee827/Doc/library/dialog.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/151579/{{ revealButtonHref }}
https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
https://github.com/python/cpython/pull/151579/files#diff-35d7c69cbafb62edc14eb176f719235e3ad8d43330f189e4462126ad479b1e97
Doc/library/tkinter.colorchooser.rsthttps://github.com/python/cpython/pull/151579/files#diff-2481dc58d855e1851f12d005f1d949ca220884d51e51db22fc91374ae9076b79
View file https://github.com/serhiy-storchaka/cpython/blob/414cadf2de06862f192f9255a2b4b31b658ee827/Doc/library/tkinter.colorchooser.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/151579/{{ revealButtonHref }}
https://github.com/python/cpython/pull/151579/files#diff-2481dc58d855e1851f12d005f1d949ca220884d51e51db22fc91374ae9076b79
Doc/library/tkinter.dnd.rsthttps://github.com/python/cpython/pull/151579/files#diff-1312e1c4d76941d036eefacdb566bfa9ef16b863091ca7dd80659fdbd06daa17
View file https://github.com/serhiy-storchaka/cpython/blob/414cadf2de06862f192f9255a2b4b31b658ee827/Doc/library/tkinter.dnd.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/151579/{{ revealButtonHref }}
https://github.com/python/cpython/pull/151579/files#diff-1312e1c4d76941d036eefacdb566bfa9ef16b863091ca7dd80659fdbd06daa17
https://github.com/python/cpython/pull/151579/files#diff-1312e1c4d76941d036eefacdb566bfa9ef16b863091ca7dd80659fdbd06daa17
Doc/library/tkinter.font.rsthttps://github.com/python/cpython/pull/151579/files#diff-a33b7144095db546182665f595273280ea8f77fd8cfd99ac042bacd6d049fbae
View file https://github.com/serhiy-storchaka/cpython/blob/414cadf2de06862f192f9255a2b4b31b658ee827/Doc/library/tkinter.font.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/151579/{{ revealButtonHref }}
https://github.com/python/cpython/pull/151579/files#diff-a33b7144095db546182665f595273280ea8f77fd8cfd99ac042bacd6d049fbae
https://github.com/python/cpython/pull/151579/files#diff-a33b7144095db546182665f595273280ea8f77fd8cfd99ac042bacd6d049fbae
https://github.com/python/cpython/pull/151579/files#diff-a33b7144095db546182665f595273280ea8f77fd8cfd99ac042bacd6d049fbae
https://github.com/python/cpython/pull/151579/files#diff-a33b7144095db546182665f595273280ea8f77fd8cfd99ac042bacd6d049fbae
https://github.com/python/cpython/pull/151579/files#diff-a33b7144095db546182665f595273280ea8f77fd8cfd99ac042bacd6d049fbae
Doc/library/tkinter.messagebox.rsthttps://github.com/python/cpython/pull/151579/files#diff-67fcf06882c7b5a06f2fa3c0f6b279105d5e3f0c3069a55fb5c51d9212e25287
View file https://github.com/serhiy-storchaka/cpython/blob/414cadf2de06862f192f9255a2b4b31b658ee827/Doc/library/tkinter.messagebox.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/151579/{{ revealButtonHref }}
https://github.com/python/cpython/pull/151579/files#diff-67fcf06882c7b5a06f2fa3c0f6b279105d5e3f0c3069a55fb5c51d9212e25287
https://github.com/python/cpython/pull/151579/files#diff-67fcf06882c7b5a06f2fa3c0f6b279105d5e3f0c3069a55fb5c51d9212e25287
https://github.com/python/cpython/pull/151579/files#diff-67fcf06882c7b5a06f2fa3c0f6b279105d5e3f0c3069a55fb5c51d9212e25287
https://github.com/python/cpython/pull/151579/files#diff-67fcf06882c7b5a06f2fa3c0f6b279105d5e3f0c3069a55fb5c51d9212e25287
Please reload this pagehttps://github.com/python/cpython/pull/151579/files
Please reload this pagehttps://github.com/python/cpython/pull/151579/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.