cpython/Doc/tools
Serhiy Storchaka 8b270b72a2
gh-86726: Document the full public API of tkinter (GH-151579)
Replace the previously sparse reference documentation with full coverage of
the public API of the tkinter package, written from the Tcl/Tk manual pages,
the existing documentation and the module docstrings.

* Doc/library/tkinter.rst gains a "Reference" section documenting every public
  class, method, function and constant of the core module -- the widgets, the
  Misc, Wm, Pack, Place, Grid, XView and YView mix-ins, the Variable and image
  classes, the module-level functions and the symbolic constants.
* Doc/library/tkinter.ttk.rst, dialog.rst, tkinter.font.rst and the other
  module pages document their remaining classes, methods and functions.

The descriptions are Python-oriented (correct return types -- tuples rather
than Tcl lists, booleans, integers, None on cancellation, and so on) and were
checked against the Tcl/Tk 9.1 manual pages and the implementation.

versionadded, versionchanged and deprecated directives are added for the
public API, determined from the git history relative to Python 3.0: the
tkinter.ttk module (3.1); the Text, Wm, Menu and Misc methods exposing Tk 8.5
features (3.3); and the many later additions and behavior changes up to 3.15.
The Tk version required by features added after Tk 8.6 is noted as well.  The
bundled Tcl/Tk version is updated to 9.0 and the manual-page links point at
the tcl9.0 reference.

--------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2026-06-18 15:39:06 +03:00
..
extensions Docs: Only add profiling-sampling-visualization.{css,js} to files when necessary (#151150) 2026-06-09 14:16:03 +01:00
static Revert "Doc: Show object descriptions in the table of contents (#125757)" (#128406) 2025-01-02 14:35:00 +00:00
templates gh-149902: Remove dead packaging docs link and add a new section for external resources (#150030) 2026-05-22 14:32:14 +03:00
.nitignore gh-86726: Document the full public API of tkinter (GH-151579) 2026-06-18 15:39:06 +03:00
check-epub.py GH-136155: Fail the EPUB check on fatal errors (#137351) 2025-08-08 02:32:20 +01:00
check-html-ids.py gh-145000: Run check-html-ids.py in CI (#145632) 2026-04-01 15:10:27 +02:00
check-warnings.py Update pre-commit with zizmor and Ruff fixes (#143095) 2025-12-23 17:51:02 +02:00
removed-ids.txt gh-149044: Improve Py_tp_base[s] docs & error message for non-type bases (GH-151252) 2026-06-17 15:27:02 +02:00