Skip to content

gh-86726: Document tkinter method-name conflicts#151917

Merged
serhiy-storchaka merged 2 commits into
python:mainfrom
serhiy-storchaka:tkinter-doc-method-conflicts
Jun 22, 2026
Merged

gh-86726: Document tkinter method-name conflicts#151917
serhiy-storchaka merged 2 commits into
python:mainfrom
serhiy-storchaka:tkinter-doc-method-conflicts

Conversation

@serhiy-storchaka

@serhiy-storchaka serhiy-storchaka commented Jun 22, 2026

Copy link
Copy Markdown
Member

Document where widget methods shadow inherited Misc, geometry-manager and Wm methods, correct the inaccurate "size/bbox is an alias of grid_size/grid_bbox" claims, and add # overrides X comments at the definitions.

Also document the geometry-manager ambiguity: the short names forget, info, slaves, content and propagate are defined by Pack, Place and Grid but resolve to the pack variant.

Cross-reference the window-manager methods grid, forget and state with the same-named grid geometry manager, Pack.forget and ttk.Widget.state.

🤖 Generated with Claude Code

Document where widget methods shadow inherited Misc, geometry-manager and
Wm methods, correct the inaccurate "size/bbox is an alias of
grid_size/grid_bbox" claims, and add "# overrides X" comments at the
definitions.

Also document the geometry-manager ambiguity: the short names forget, info,
slaves, content and propagate are defined by Pack, Place and Grid but
resolve to the pack variant.

Cross-reference the window-manager methods grid, forget and state with the
same-named grid geometry manager, Pack.forget and ttk.Widget.state.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XWevzas4XVpjzedzR9gKVo
@serhiy-storchaka serhiy-storchaka added skip news needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes labels Jun 22, 2026
@serhiy-storchaka serhiy-storchaka added the docs Documentation in the Doc dir label Jun 22, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Docs PRs Jun 22, 2026
@serhiy-storchaka serhiy-storchaka enabled auto-merge (squash) June 22, 2026 10:48
@serhiy-storchaka serhiy-storchaka enabled auto-merge (squash) June 22, 2026 10:49
@read-the-docs-community

read-the-docs-community Bot commented Jun 22, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33247445 | 📁 Comparing 75b694f against main (476b649)

  🔍 Preview build  

2 files changed
± library/tkinter.html
± library/tkinter.ttk.html

Note that Variable.initialize and trace are aliases of set and
trace_variable, and fix a typo in the clipboard_get equivalence.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XWevzas4XVpjzedzR9gKVo
@serhiy-storchaka serhiy-storchaka merged commit 4de5683 into python:main Jun 22, 2026
93 of 95 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Jun 22, 2026
@miss-islington-app

Copy link
Copy Markdown

Thanks @serhiy-storchaka for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15.
🐍🍒⛏🤖

@miss-islington-app

Copy link
Copy Markdown

Sorry, @serhiy-storchaka, I could not cleanly backport this to 3.14 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker 4de5683f213a862c23cf8d46e3d797986e663025 3.14

@bedevere-app

bedevere-app Bot commented Jun 22, 2026

Copy link
Copy Markdown

GH-151926 is a backport of this pull request to the 3.15 branch.

@miss-islington-app

Copy link
Copy Markdown

Sorry, @serhiy-storchaka, I could not cleanly backport this to 3.13 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker 4de5683f213a862c23cf8d46e3d797986e663025 3.13

@bedevere-app bedevere-app Bot removed the needs backport to 3.15 pre-release feature fixes, bugs and security fixes label Jun 22, 2026
serhiy-storchaka added a commit that referenced this pull request Jun 22, 2026
…H-151926)

Document where widget methods shadow inherited Misc, geometry-manager and
Wm methods, correct the inaccurate "size/bbox is an alias of
grid_size/grid_bbox" claims, and add "# overrides X" comments at the
definitions.

Also document the geometry-manager ambiguity: the short names forget, info,
slaves, content and propagate are defined by Pack, Place and Grid but
resolve to the pack variant.

Cross-reference the window-manager methods grid, forget and state with the
same-named grid geometry manager, Pack.forget and ttk.Widget.state.

(cherry picked from commit 4de5683)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@serhiy-storchaka serhiy-storchaka deleted the tkinter-doc-method-conflicts branch June 22, 2026 16:45
@bedevere-app

bedevere-app Bot commented Jun 22, 2026

Copy link
Copy Markdown

GH-151933 is a backport of this pull request to the 3.14 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Jun 22, 2026
@bedevere-app

bedevere-app Bot commented Jun 22, 2026

Copy link
Copy Markdown

GH-151934 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app Bot removed the needs backport to 3.13 bugs and security fixes label Jun 22, 2026
@serhiy-storchaka serhiy-storchaka removed their assignment Jun 22, 2026
serhiy-storchaka added a commit that referenced this pull request Jun 22, 2026
…H-151934)

Document where widget methods shadow inherited Misc, geometry-manager and
Wm methods, correct the inaccurate "size/bbox is an alias of
grid_size/grid_bbox" claims, and add "# overrides X" comments at the
definitions.

Also document the geometry-manager ambiguity: the short names forget, info,
slaves and propagate are defined by Pack, Place and Grid but
resolve to the pack variant.

Cross-reference the window-manager methods grid, forget and state with the
same-named grid geometry manager, Pack.forget and ttk.Widget.state.

(cherry picked from commit 4de5683)

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir skip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant