8000 bpo-33479: add architecture and threading model sections to Tkinter module docs by roseman · Pull Request #27717 · python/cpython · GitHub
[go: up one dir, main page]
Skip to content

bpo-33479: add architecture and threading model sections to Tkinter module docs #27717

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Aug 11, 2021
Merged

bpo-33479: add architecture and threading model sections to Tkinter module docs #27717

Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
810973c
added some material to intro - context on tcl/tk versions, scope of t…
roseman Aug 10, 2021
015c7ff
new architecture section providing an overview of tcl, tk, ttk, and tix
roseman Aug 10, 2021
292471f
new section on threading model
roseman Aug 10, 2021
1d8d233
typo: s/mode/mod/
ambv Aug 11, 2021
90e7699
Add Blurb
ambv Aug 11, 2021
7e4c859
More minor fixes
ambv Aug 11, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
10000
Diff view
Diff view
Prev Previous commit
Next Next commit
new architecture section providing an overview of tcl, tk, ttk, and tix
  • Loading branch information
@roseman
roseman committed Aug 10, 2021
commit 015c7ff37f560b57e9be8357fc771b84e0bbf7e3
41 changes: 41 additions & 0 deletions Doc/library/tkinter.rst
View file
Open in desktop
4286
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,47 @@ details that are unchanged.
Brent Welch's encyclopedic book.


Architecture
------------

Tcl/Tk is not a single library but rather consists of a few distinct
modules, each with a separate functionality and its own official
documentation. Python's binary releases also ship an add-on module
together with it.

Tcl
Tcl is a dynamic interpreted programming language, just like Python. Though
it can be used on its own as a general-purpose programming language, it is
most commonly embedded into C applications as a scripting engine or an
interface to the Tk toolkit. The Tcl library has a C interface to
create and manage one or more instances of a Tcl interpreter, run Tcl
commands and scripts in those instances, and add custom commands
implemented in either Tcl or C. Each interpreter has an event queue,
and there are facilities to send events to it and process them.
Unlike Python, Tcl's execution model is designed around cooperative
multitasking, and Tkinter bridges this difference
(see `Threading model`_ for details).

Tk
Tk is a `Tcl package <http://wiki.tcl.tk/37432>`_ implemented in C
that adds custom commands to create and manipulate GUI widgets. Each
:class:`Tk` object embeds its own Tcl interpreter instance with Tk loaded into
it. Tk's widgets are very customizable, though at the cost of a dated appearance.
Tk uses Tcl's event queue to generate and process GUI events.

Ttk
Themed Tk (Ttk) is a newer family of Tk widgets that provide a much better
appearance on different platforms than many of the classic Tk widgets.
Ttk is distributed as part of Tk, starting with Tk version 8.5. Python
bindings are provided in a separate module, :mod:`tkinter.ttk`.

Tix
`Tix`<https://core.tcl.tk/jenglish/gutter/packages/tix.html>_ is an older
third-party Tcl package, an add-on for Tk that adds several new widgets.
Python bindings are found in the :mod:`tkinter.tix` module.
It's deprecated in favor of Ttk.


Tkinter Modules
---------------

Expand Down
0