Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
cca5145
gh-59551: Document the full public API of tkinter
serhiy-storchaka Jun 17, 2026
9d7c91e
gh-59551: Do not document tkinter aliases separately
serhiy-storchaka Jun 17, 2026
77f3ae0
gh-59551: Document tkinter aliases as hidden :no-typesetting: anchors
serhiy-storchaka Jun 17, 2026
303589e
gh-59551: Replace the ['_noarg_'] sentinel with two tkinter signatures
serhiy-storchaka Jun 17, 2026
5b2a713
gh-59551: Reformat tkinter docs with one sentence per line
serhiy-storchaka Jun 17, 2026
19f6605
gh-59551: Describe wm_ aliases like other tkinter aliases
serhiy-storchaka Jun 17, 2026
2935f81
gh-59551: Remove docs for internal ttk helpers
serhiy-storchaka Jun 17, 2026
d126ff1
gh-59551: Fix broken cross-references in tkinter docs
serhiy-storchaka Jun 17, 2026
c784350
gh-59551: Fix cross-references in the tkinter documentation
serhiy-storchaka Jun 17, 2026
f3d9376
gh-59551: Fix the remaining cross-references in the ttk documentation
serhiy-storchaka Jun 17, 2026
f1cdcd4
gh-59551: Restore wrapping in two filedialog ok_command descriptions
serhiy-storchaka Jun 17, 2026
1a8e499
gh-86726: Correct the issue number of the tkinter docs NEWS entry
serhiy-storchaka Jun 17, 2026
ab6edbd
Apply suggestions from code review
serhiy-storchaka Jun 18, 2026
3074205
gh-59551: Spell out e.g. and i.e. in the tkinter documentation
serhiy-storchaka Jun 18, 2026
1bd252f
gh-59551: Document grid_anchor only as a Misc method
serhiy-storchaka Jun 18, 2026
774052b
gh-59551: Use sentence case for section headings in the tkinter docum…
serhiy-storchaka Jun 18, 2026
01fcf71
Apply suggestions from code review
serhiy-storchaka Jun 18, 2026
3417306
gh-59551: Document the supported options of tkinter widgets and their…
serhiy-storchaka Jun 18, 2026
414cadf
Merge branch 'tk-docs' of github.com:serhiy-storchaka/cpython into tk…
serhiy-storchaka Jun 18, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
gh-59551: Do not document tkinter aliases separately
Merge alias methods into a single directive with stacked signatures
instead of documenting each spelling separately: Font.config/configure,
Variable.set/initialize, Variable.trace_variable/trace, and
BooleanVar.set/initialize.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
  • Loading branch information
serhiy-storchaka and claude committed Jun 17, 2026
commit 9d7c91e10de085f1f10f689c01c13c634f0d6a3d
8 changes: 2 additions & 6 deletions Doc/library/tkinter.font.rst
Original file line number Diff line number Diff line change
Expand Up @@ -59,15 +59,11 @@ The different font weights and slants are:

Retrieve an attribute of the font.

.. method:: config(**options)

Modify attributes of the font.

.. method:: configure(**options)
config(**options)

Modify one or more attributes of the font. With no arguments, return a
dictionary of the current attributes. :meth:`config` is an alias of
:meth:`configure`.
dictionary of the current attributes.

.. method:: copy()

Expand Down
6 changes: 3 additions & 3 deletions Doc/library/tkinter.messagebox.rst
Original file line number Diff line number Diff line change
Expand Up @@ -79,19 +79,19 @@ include but are not limited to:
.. function:: showinfo(title=None, message=None, **options)

Creates and displays an information message box with the specified title
and message. Return the symbolic name :data:`OK` (the string ``'ok'``).
and message.

**Warning message boxes**

.. function:: showwarning(title=None, message=None, **options)

Creates and displays a warning message box with the specified title
and message. Return the symbolic name :data:`OK` (the string ``'ok'``).
and message.

.. function:: showerror(title=None, message=None, **options)

Creates and displays an error message box with the specified title
and message. Return the symbolic name :data:`OK` (the string ``'ok'``).
and message.

**Question message boxes**

Expand Down
22 changes: 6 additions & 16 deletions Doc/library/tkinter.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4626,15 +4626,12 @@ Variable classes
appropriate Python type.

.. method:: set(value)
initialize(value)

Set the variable to *value*.

.. method:: initialize(value)

Set the initial value of the variable. This is an alias for
:meth:`set`.

.. versionadded:: 3.3
The *initialize* spelling.

.. method:: trace_add(mode, callback)

Expand Down Expand Up @@ -4668,6 +4665,7 @@ Variable classes
.. versionadded:: 3.6

.. method:: trace_variable(mode, callback)
trace(mode, callback)

Register *callback* to be called when the variable is accessed according
to *mode*. *mode* is one of the strings ``'r'``, ``'w'`` or ``'u'``, for
Expand All @@ -4678,13 +4676,6 @@ Variable classes
Use :meth:`trace_add` instead. This method wraps a Tcl feature that
was removed in Tcl 9.0.

.. method:: trace(mode, callback)

An alias for :meth:`trace_variable`.

.. deprecated:: 3.6
Use :meth:`trace_add` instead.

.. method:: trace_vdelete(mode, cbname)

Remove the trace callback named *cbname* registered for *mode* with
Expand Down Expand Up @@ -4745,13 +4736,12 @@ Variable classes
:exc:`ValueError` if the value cannot be interpreted as a boolean.

.. method:: set(value)
initialize(value)

Set the variable to *value*, converting it to a boolean.

.. method:: initialize(value)

Set the initial value of the variable. This is an alias for
:meth:`set`.
.. versionadded:: 3.3
The *initialize* spelling.


Image classes
Expand Down