Skip to content

gh-159308: Improve the documentation of the Tk option data types in Tkinter - #159309

Open
serhiy-storchaka wants to merge 2 commits into
python:mainfrom
serhiy-storchaka:tkinter-docs-option-data-types
Open

serhiy-storchaka wants to merge 2 commits into
python:mainfrom
serhiy-storchaka:tkinter-docs-option-data-types

Conversation

@serhiy-storchaka

@serhiy-storchaka serhiy-storchaka commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

Fix inaccurate descriptions of the color, wrap, boolean, bitmap, callback, font, region and anchor types, and remove the obsolete geometry type: there is no such widget option.

Add the compound, orient, padding and state types.

Fix also several minor errors in the reference: getboolean() raises ValueError, not TclError, the Text widget can also scroll by pixels, the position returned by winfo_geometry() is relative to the parent widget, and the underline option of canvas text items was added in Tk 8.5, not in Tk 9.0.

…s in Tkinter

Fix inaccurate descriptions of the color, wrap, boolean, bitmap,
callback, font, region and anchor types, and remove the obsolete
"geometry" type: there is no such widget option.

Add the compound, orient, padding and state types.

Fix also several minor errors in the reference.
@read-the-docs-community

read-the-docs-community Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #35125022 | 📁 Comparing baeed7b against main (50082b8)

  🔍 Preview build  

5 files changed · ± 5 modified

± Modified

@terryjreedy terryjreedy left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I reviewed the English for clarity, not the option list for accuracy.

Comment thread Doc/library/tkinter.rst Outdated
@bedevere-app

bedevere-app Bot commented Oct 13, 2026

Copy link
Copy Markdown

When you're done making the requested changes, leave the comment: I have made the requested changes; please review again.

Co-authored-by: Terry Jan Reedy <[email protected]>
@terryjreedy
terryjreedy dismissed their stale review October 13, 2026 21:33

Requested change done.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting review docs Documentation in the Doc dir needs backport to 3.14 bugs and security fixes needs backport to 3.15 bugs and security fixes skip news

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants