From e768f0de5fd6b2336a97281a8ebf076e6bd49dd5 Mon Sep 17 00:00:00 2001 From: Serhiy Storchaka Date: Mon, 29 Jun 2026 15:48:28 +0300 Subject: [PATCH] gh-152587: Stop documenting bogus default values in tkinter variable methods 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 --- 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 cf342d74bc433e5..8c4678b4b23c778 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.