From 8e90f15ac88c66ddb7b084bb5780a126d35168af Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Sun, 22 Aug 2021 21:04:57 +0200 Subject: [3.10] bpo-42560: rework external references in Tkinter docs (GH-27838) (GH-27893) - 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 d1049d1d6b43296d4db1aa8668aa4ca807bf7adb) Co-authored-by: Mark Roseman --- Doc/library/tkinter.rst | 51 ++++++++++++++++++------------------------------- 1 file changed, 19 insertions(+), 32 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 2d7c02f..34238f4 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -31,47 +31,34 @@ details that are unchanged. .. seealso:: - Tkinter documentation: + * `TkDocs `_ + Extensive tutorial on creating user interfaces with Tkinter. Explains key concepts, + and illustrates recommended approaches using the modern API. - `Python Tkinter Resources `_ - The Python Tkinter Topic Guide provides a great deal of information on using Tk - from Python and links to other sources of information on Tk. + * `Tkinter 8.5 reference: a GUI for Python `_ + Reference documentation for Tkinter 8.5 detailing available classes, methods, and options. - `TKDocs `_ - Extensive tutorial plus friendlier widget pages for some of the widgets. + Tcl/Tk Resources: - `Tkinter 8.5 reference: a GUI for Python `_ - On-line reference material. + * `Tk commands `_ + Comprehensive reference to each of the underlying Tcl/Tk commands used by Tkinter. - `Tkinter docs from effbot `_ - Online reference for tkinter supported by effbot.org. + * `Tcl/Tk Home Page `_ + Additional documentation, and links to Tcl/Tk core development. - `Programming Python `_ - Book by Mark Lutz, has excellent coverage of Tkinter. + Books: - `Modern Tkinter for Busy Python Developers `_ - Book by Mark Roseman about building attractive and modern graphical user interfaces with Python and Tkinter. + * `Modern Tkinter for Busy Python Developers `_ + By Mark Roseman. (ISBN 978-1999149567) - `Python and Tkinter Programming `_ - Book by John Grayson (ISBN 1-884777-81-3). + * `Python and Tkinter Programming `_ + By Alan Moore. (ISBN 978-1788835886) - Tcl/Tk documentation: + * `Programming Python `_ + By Mark Lutz; has excellent coverage of Tkinter. (ISBN 978-0596158101) - `Tk commands `_ - Most commands are available as :mod:`tkinter` or :mod:`tkinter.ttk` classes. - Change '8.6' to match the version of your Tcl/Tk installation. - - `Tcl/Tk recent man pages `_ - Recent Tcl/Tk manuals on www.tcl.tk. - - `ActiveState Tcl Home Page `_ - The Tk/Tcl development is largely taking place at ActiveState. - - `Tcl and the Tk Toolkit `_ - Book by John Ousterhout, the inventor of Tcl. - - `Practical Programming in Tcl and Tk `_ - Brent Welch's encyclopedic book. + * `Tcl and the Tk Toolkit (2nd edition) `_ + By John Ousterhout, inventor of Tcl/Tk, and Ken Jones; does not cover Tkinter. (ISBN 978-0321336330) Architecture -- cgit v0.12