8000 [3.9] bpo-42560: rework external references in Tkinter docs (GH-27838… · python/cpython@c579f0b · GitHub
[go: up one dir, main page]

Skip to content

Commit c579f0b

Browse files
ambvroseman
andauthored
[3.9] bpo-42560: rework external references in Tkinter docs (GH-27838) (GH-27896)
- reorganized from two sections (tkinter vs. tcl/tk) into three (tkinter, tcl/tk, and books) - main (recommended) tkinter docs have one tutorial (tkdocs) and one reference (shipman), added better descriptions - dropped link to Tkinter page on wiki (suggestion by E. Paine; outdated, most material already linked to from python.org) - replaced Tcl/Tk recent man pages and core dev home with single link to main Tcl/Tk page (which holds both of these) - updated Modern Tkinter link to book page on TkDocs site (was Amazon link to old version), dropped description - replaced Grayson book by Moore book (newer, covers ttk) - changed Ousterhout ref to second edition, covers ttk - dropped link to Welch book (old). (cherry picked from commit d1049d1) Co-authored-by: Mark Roseman <mark@markroseman.com>
1 parent 986750b commit c579f0b

File tree

1 file changed

+19
-32
lines changed

1 file changed

+19
-32
lines changed

Doc/library/tkinter.rst

Lines changed: 19 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -21,47 +21,34 @@ installed, so you can read the Tcl/Tk documentation specific to that version.
2121

2222
.. seealso::
2323

24-
Tkinter documentation:
24+
* `TkDocs <http://tkdocs.com/>`_
25+
Extensive tutorial on creating user interfaces with Tkinter. Explains key concepts,
26+
and illustrates recommended approaches using the modern API.
2527

26-
`Python Tkinter Resources <https://wiki.python.org/moin/TkInter>`_
27-
The Python Tkinter Topic Guide provides a great deal of information on using Tk
28-
from Python and links to other sources of information on Tk.
28+
* `Tkinter 8.5 reference: a GUI for Python <https://www.tkdocs.com/shipman/>`_
29+
Reference documentation for Tkinter 8.5 detailing available classes, methods, and options.
2930

30-
`TKDocs <http://www.tkdocs.com/>`_
31-
Extensive tutorial plus friendlier widget pages for some of the widgets.
31+
Tcl/Tk Resources:
3232

33-
`Tkinter 8.5 reference: a GUI for Python <https://www.tkdocs.com/shipman/>`_
34-
On-line reference material.
33+
* `Tk commands <https://www.tcl.tk/man/tcl8.6/TkCmd/contents.htm>`_
34+
Comprehensive reference to each of the underlying Tcl/Tk commands used by Tkinter.
3535

36-
`Tkinter docs from effbot <http://effbot.org/tkinterbook/>`_
37-
Online reference for tkinter supported by effbot.org.
36+
* `Tcl/Tk Home Page <https://www.tcl.tk>`_
37+
Additional documentation, and links to Tcl/Tk core development.
3838

39-
`Programming Python <http://learning-python.com/about-pp4e.html>`_
40-
Book by Mark Lutz, has excellent coverage of Tkinter.
39+
Books:
4140

42-
`Modern Tkinter for Busy Python Developers <https://www.amazon.com/Modern-Tkinter-Python-Developers-ebook/dp/B0071QDNLO/>`_
43-
Book by Mark Roseman about building attract 8000 ive and modern graphical user interfaces with Python and Tkinter.
41+
* `Modern Tkinter for Busy Python Developers <https://tkdocs.com/book.html>`_
42+
By Mark Roseman. (ISBN 978-1999149567)
4443

45-
`Python and Tkinter Programming <https://www.manning.com/books/python-and-tkinter-programming>`_
46-
Book by John Grayson (ISBN 1-884777-81-3).
44+
* `Python and Tkinter Programming <https://www.packtpub.com/product/python-gui-programming-with-tkinter/9781788835886>`_
45+
By Alan Moore. (ISBN 978-1788835886)
4746

48-
Tcl/Tk documentation:
47+
* `Programming Python <http://learning-python.com/about-pp4e.html>`_
48+
By Mark Lutz; has excellent coverage of Tkinter. (ISBN 978-0596158101)
4949

50-
`Tk commands <https://www.tcl.tk/man/tcl8.6/TkCmd/contents.htm>`_
51-
Most commands are available as :mod:`tkinter` or :mod:`tkinter.ttk` classes.
52-
Change '8.6' to match the version of your Tcl/Tk installation.
53-
54-
`Tcl/Tk recent man pages <https://www.tcl.tk/doc/>`_
55-
Recent Tcl/Tk manuals on www.tcl.tk.
56-
57-
`ActiveState Tcl Home Page <https://tcl.tk>`_
58-
The Tk/Tcl development is largely taking place at ActiveState.
59-
60-
`Tcl and the Tk Toolkit <https://www.amazon.com/exec/obidos/ASIN/020163337X>`_
61-
Book by John Ousterhout, the inventor of Tcl.
62-
63-
`Practical Programming in Tcl and Tk <http://www.beedub.com/book/>`_
64-
Brent Welch's encyclopedic book.
50+
* `Tcl and the Tk Toolkit (2nd edition) <https://www.amazon.com/exec/obidos/ASIN/032133633X>`_
51+
By John Ousterhout, inventor of Tcl/Tk, and Ken Jones; does not cover Tkinter. (ISBN 978-0321336330)
6552

6653

6754
Tkinter Modules

0 commit comments

Comments
 (0)
0