Repository navigation
gh-86726: Improve the structure of the tkinter reference - #152109
serhiy-storchaka merged 1 commit into
Conversation
Sorry, something went wrong.
Add short group intros before each cluster of Misc methods. Group the Tk and Toplevel classes in a new "Toplevel widgets" section, move the Tcl() function to the module-level functions, and move the "File handlers" section into the reference. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Documentation build overview2 files changed ± library/tk.html ± library/tkinter.html |
Sorry, something went wrong.
|
Thanks @serhiy-storchaka for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15. |
Sorry, something went wrong.
|
Sorry, @serhiy-storchaka, I could not cleanly backport this to 3.15 due to a conflict. cherry_picker c7faa6936e17630ec26d4e0438ae9b95561b7151 3.15 |
Sorry, something went wrong.
|
Sorry, @serhiy-storchaka, I could not cleanly backport this to 3.14 due to a conflict. cherry_picker c7faa6936e17630ec26d4e0438ae9b95561b7151 3.14 |
Sorry, something went wrong.
|
Sorry, @serhiy-storchaka, I could not cleanly backport this to 3.13 due to a conflict. cherry_picker c7faa6936e17630ec26d4e0438ae9b95561b7151 3.13 |
Sorry, something went wrong.
…52109 (GH-152111) Add short group intros before each cluster of Misc methods. Group the Tk and Toplevel classes in a new "Toplevel widgets" section, move the Tcl() function to the module-level functions, and move the "File handlers" section into the reference. (cherry picked from commit c7faa69) Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
…52109 (GH-152111) (GH-152116) Add short group intros before each cluster of Misc methods. Group the Tk and Toplevel classes in a new "Toplevel widgets" section, move the Tcl() function to the module-level functions, and move the "File handlers" section into the reference. (cherry picked from commit c7faa69) (cherry picked from commit 2d51871) Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
…52109 (GH-152111) (GH-152119) Add short group intros before each cluster of Misc methods. Group the Tk and Toplevel classes in a new "Toplevel widgets" section, move the Tcl() function to the module-level functions, and move the "File handlers" section into the reference. (cherry picked from commit c7faa69) (cherry picked from commit 2d51871) Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Several structural improvements to the tkinter module reference, all documentation-only.
Add short group intros before each cluster of Misc methods (the bind, event_, after, focus_, grab_, selection_, clipboard_, option_, busy_ and winfo_ prefixes), so each run of related methods is introduced by a sentence explaining what the prefix means.
Group the Tk and Toplevel classes in a new "Toplevel widgets" section, instead of documenting Tk in the middle of the "Tkinter modules" overview and leaving Toplevel dangling at the end of the base and mixin classes. Move the Tcl() factory function to the module-level functions section, add a reference to it from Tk, and document that Tk inherits from Misc and Wm.
Move the "File handlers" section into the reference, where its createfilehandler/deletefilehandler methods and READABLE/WRITABLE/EXCEPTION constants belong, instead of leaving it as a standalone section just before the reference. The cross-reference target is preserved.