https://github.com/python/cpython/commit/e134a1aa36027fb3c8bd9493028072365b19479b
commit: e134a1aa36027fb3c8bd9493028072365b19479b
branch: main
author: Serhiy Storchaka <[email protected]>
committer: serhiy-storchaka <[email protected]>
date: 2026-06-29T16:48:10+03:00
summary:
gh-152587: Stop documenting bogus default values in tkinter variable methods
(GH-152594)
The name parameter of Misc.wait_variable(), setvar() and getvar() and the
value parameter of setvar() should not be optional. Their default values
('PY_VAR' and '1') are not meaningful and should not be advertised.
Co-authored-by: Claude Opus 4.8 <[email protected]>
files:
M Doc/library/tkinter.rst
diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst
index cf342d74bc433e..8c4678b4b23c77 100644
--- a/Doc/library/tkinter.rst
+++ b/Doc/library/tkinter.rst
@@ -1056,11 +1056,11 @@ Base and mixin classes
:class:`int`.
Raise :exc:`ValueError` if *s* is not a valid integer.
- .. method:: getvar(name='PY_VAR')
+ .. method:: getvar(name)
Return the value of the Tcl global variable named *name*.
- .. method:: setvar(name='PY_VAR', value='1')
+ .. method:: setvar(name, value)
Set the Tcl global variable named *name* to *value*.
@@ -1524,10 +1524,10 @@ Base and mixin classes
This updates the display of windows, for example after geometry changes,
but does not process events caused by the user.
- .. method:: waitvar(name='PY_VAR')
+ .. method:: waitvar(name)
:no-typesetting:
- .. method:: wait_variable(name='PY_VAR')
+ .. method:: wait_variable(name)
Wait until the Tcl variable *name* is modified, continuing to process
events in the meantime so that the application stays responsive.
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
