From 5ca6970832404b0ddc4763a27d4e798b5cdb1cfa Mon Sep 17 00:00:00 2001 From: Serhiy Storchaka Date: Mon, 29 Jun 2026 16:48:10 +0300 Subject: [PATCH] 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. (cherry picked from commit e134a1aa36027fb3c8bd9493028072365b19479b) Co-authored-by: Serhiy Storchaka Co-authored-by: Claude Opus 4.8 --- Doc/library/tkinter.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 8bac17f6938252..d23005ebd8af05 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -1058,11 +1058,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*. @@ -1494,10 +1494,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.