diff --git a/Lib/tkinter/__init__.py b/Lib/tkinter/__init__.py index 124882420c255c..e0d6c77ba7bde8 100644 --- a/Lib/tkinter/__init__.py +++ b/Lib/tkinter/__init__.py @@ -2753,8 +2753,8 @@ def __init__(self, master=None, cnf={}, **kw): Valid resource names: background, bd, bg, borderwidth, class, colormap, container, cursor, height, highlightbackground, - highlightcolor, highlightthickness, menu, relief, screen, takefocus, - use, visual, width.""" + highlightcolor, highlightthickness, menu, padx, pady, relief, + screen, takefocus, use, visual, width.""" if kw: cnf = _cnfmerge((cnf, kw)) extra = () @@ -3141,12 +3141,13 @@ def __init__(self, master=None, cnf={}, **kw): """Construct a checkbutton widget with the parent MASTER. Valid resource names: activebackground, activeforeground, anchor, - background, bd, bg, bitmap, borderwidth, command, cursor, + background, bd, bg, bitmap, borderwidth, command, compound, cursor, disabledforeground, fg, font, foreground, height, highlightbackground, highlightcolor, highlightthickness, image, - indicatoron, justify, offvalue, onvalue, padx, pady, relief, - selectcolor, selectimage, state, takefocus, text, textvariable, - underline, variable, width, wraplength.""" + indicatoron, justify, offrelief, offvalue, onvalue, overrelief, + padx, pady, relief, selectcolor, selectimage, state, takefocus, + text, textvariable, tristateimage, tristatevalue, underline, + variable, width, wraplength.""" Widget.__init__(self, master, 'checkbutton', cnf, kw) def _setup(self, master, cnf): @@ -3185,10 +3186,11 @@ def __init__(self, master=None, cnf={}, **kw): """Construct an entry widget with the parent MASTER. Valid resource names: background, bd, bg, borderwidth, cursor, - exportselection, fg, font, foreground, highlightbackground, - highlightcolor, highlightthickness, insertbackground, - insertborderwidth, insertofftime, insertontime, insertwidth, - invalidcommand, invcmd, justify, relief, selectbackground, + disabledbackground, disabledforeground, exportselection, + fg, font, foreground, highlightbackground, highlightcolor, + highlightthickness, insertbackground, insertborderwidth, + insertofftime, insertontime, insertwidth, invalidcommand, + invcmd, justify, readonlybackground, relief, selectbackground, selectborderwidth, selectforeground, show, state, takefocus, textvariable, validate, validatecommand, vcmd, width, xscrollcommand.""" @@ -3272,7 +3274,8 @@ def __init__(self, master=None, cnf={}, **kw): Valid resource names: background, bd, bg, borderwidth, class, colormap, container, cursor, height, highlightbackground, - highlightcolor, highlightthickness, relief, takefocus, visual, width.""" + highlightcolor, highlightthickness, padx, pady, relief, takefocus, + visual, width.""" cnf = _cnfmerge((cnf, kw)) extra = () if 'class_' in cnf: @@ -3293,8 +3296,8 @@ def __init__(self, master=None, cnf={}, **kw): STANDARD OPTIONS activebackground, activeforeground, anchor, - background, bitmap, borderwidth, cursor, - disabledforeground, font, foreground, + background, bitmap, borderwidth, compound, + cursor, disabledforeground, font, foreground, highlightbackground, highlightcolor, highlightthickness, image, justify, padx, pady, relief, takefocus, text, @@ -3314,11 +3317,12 @@ class Listbox(Widget, XView, YView): def __init__(self, master=None, cnf={}, **kw): """Construct a listbox widget with the parent MASTER. - Valid resource names: background, bd, bg, borderwidth, cursor, - exportselection, fg, font, foreground, height, highlightbackground, - highlightcolor, highlightthickness, relief, selectbackground, - selectborderwidth, selectforeground, selectmode, setgrid, takefocus, - width, xscrollcommand, yscrollcommand, listvariable.""" + Valid resource names: activestyle, background, bd, bg, borderwidth, + cursor, disabledforeground, exportselection, fg, font, foreground, + height, highlightbackground, highlightcolor, highlightthickness, + justify, listvariable, relief, selectbackground, selectborderwidth, + selectforeground, selectmode, setgrid, state, takefocus, width, + xscrollcommand, yscrollcommand.""" Widget.__init__(self, master, 'listbox', cnf, kw) def activate(self, index): @@ -3574,12 +3578,12 @@ def __init__(self, master=None, cnf={}, **kw): """Construct a radiobutton widget with the parent MASTER. Valid resource names: activebackground, activeforeground, anchor, - background, bd, bg, bitmap, borderwidth, command, cursor, - disabledforeground, fg, font, foreground, height, - highlightbackground, highlightcolor, highlightthickness, image, - indicatoron, justify, padx, pady, relief, selectcolor, selectimage, - state, takefocus, text, textvariable, underline, value, variable, - width, wraplength.""" + background, bd, bg, bitmap, borderwidth, command, compound, cursor, + disabledforeground, fg, font, foreground, height, highlightbackground, + highlightcolor, highlightthickness, image, indicatoron, justify, + offrelief, overrelief, padx, pady, relief, selectcolor, selectimage, + state, takefocus, text, textvariable, tristateimage, tristatevalue, + underline, value, variable, width, wraplength.""" Widget.__init__(self, master, 'radiobutton', cnf, kw) def deselect(self): @@ -3697,22 +3701,22 @@ def __init__(self, master=None, cnf={}, **kw): STANDARD OPTIONS - background, borderwidth, cursor, - exportselection, font, foreground, - highlightbackground, highlightcolor, - highlightthickness, insertbackground, - insertborderwidth, insertofftime, - insertontime, insertwidth, padx, pady, - relief, selectbackground, + background, blockcursor, borderwidth, + cursor, endine, exportselection, font, + foreground, highlightbackground, highlightcolor, + highlightthickness, inactiveselectbackground, + insertbackground, insertborderwidth, + insertofftime, insertontime, insertunfocused, + insertwidth, padx, pady, relief, selectbackground, selectborderwidth, selectforeground, - setgrid, takefocus, - xscrollcommand, yscrollcommand, + setgrid, startline, tabstyle, takefocus, + xscrollcommand, yscrollcommand. WIDGET-SPECIFIC OPTIONS autoseparators, height, maxundo, spacing1, spacing2, spacing3, - state, tabs, undo, width, wrap, + state, tabs, undo, width, wrap. """ Widget.__init__(self, master, 'text', cnf, kw) @@ -4330,8 +4334,8 @@ def __init__(self, master=None, cnf={}, **kw): insertborderwidth, insertofftime, insertontime, insertwidth, justify, relief, repeatdelay, repeatinterval, - selectbackground, selectborderwidth - selectforeground, takefocus, textvariable + selectbackground, selectborderwidth, + selectforeground, takefocus, textvariable, xscrollcommand. WIDGET-SPECIFIC OPTIONS @@ -4342,8 +4346,8 @@ def __init__(self, master=None, cnf={}, **kw): disabledforeground, format, from, invalidcommand, increment, readonlybackground, state, to, - validate, validatecommand values, - width, wrap, + validate, validatecommand, values, + width, wrap. """ Widget.__init__(self, master, 'spinbox', cnf, kw) @@ -4526,13 +4530,14 @@ def __init__(self, master=None, cnf={}, **kw): STANDARD OPTIONS background, borderwidth, cursor, height, - orient, relief, width + orient, proxybackground, proxyborderwidth, + proxyrelief, relief, width. WIDGET-SPECIFIC OPTIONS handlepad, handlesize, opaqueresize, sashcursor, sashpad, sashrelief, - sashwidth, showhandle, + sashwidth, showhandle. """ Widget.__init__(self, master, 'panedwindow', cnf, kw) diff --git a/Misc/NEWS.d/next/Library/2020-06-24-08-44-06.bpo-34154.coStMk.rst b/Misc/NEWS.d/next/Library/2020-06-24-08-44-06.bpo-34154.coStMk.rst new file mode 100644 index 00000000000000..1c44a1e0a05797 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2020-06-24-08-44-06.bpo-34154.coStMk.rst @@ -0,0 +1 @@ +Improve the docstrings in the :mod:`tkinter` module.