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

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 only security fixes needs backport to 3.14 bugs and security fixes needs backport to 3.15 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 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 only 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>
serhiy-storchaka added a commit that referenced this pull request Jun 23, 2026
…151933)

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>
pyctrl pushed a commit to pyctrl/cpython that referenced this pull request Jul 5, 2026
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>
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