From 7f7faa6c55838419caf1f21f88d4bcf150546b99 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Sat, 14 Apr 2018 17:09:33 -0300 Subject: [PATCH 1/7] Link to Tcl/Tk 8.5 -> 8.6 --- Doc/library/tkinter.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 6d90e43e33b266..2c7a4aa42a57a2 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -32,8 +32,8 @@ this should open a window demonstrating a simple Tk interface. `Tkinter docs from effbot `_ Online reference for tkinter supported by effbot.org. - `Tcl/Tk manual `_ - Official manual for the latest tcl/tk version. + `Tcl/Tk 8.6 man pages `_ + The Tcl/Tk manual on www.tcl.tk. `Programming Python `_ Book by Mark Lutz, has excellent coverage of Tkinter. From 15e80844cc55fc8ecbe323088f0628d44e464a3d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Sun, 22 Apr 2018 14:04:05 -0300 Subject: [PATCH 2/7] Update manuals link and reorganize external references --- Doc/library/tkinter.rst | 48 ++++++++++++++++++++--------------------- 1 file changed, 23 insertions(+), 25 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 2c7a4aa42a57a2..0e1c38abf6eea9 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -19,30 +19,43 @@ this should open a window demonstrating a simple Tk interface. .. seealso:: + Tkinter-specific documentation: + `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. - `TKDocs `_ - Extensive tutorial plus friendlier widget pages for some of the widgets. - `Tkinter reference: a GUI for Python `_ On-line reference material. `Tkinter docs from effbot `_ Online reference for tkinter supported by effbot.org. - `Tcl/Tk 8.6 man pages `_ - The Tcl/Tk manual on www.tcl.tk. - - `Programming Python `_ - Book by Mark Lutz, has excellent coverage of Tkinter. - `Modern Tkinter for Busy Python Developers `_ Book by Mark Rozerman about building attractive and modern graphical user interfaces with Python and Tkinter. `Python and Tkinter Programming `_ - The book by John Grayson (ISBN 1-884777-81-3). + Book by John Grayson (ISBN 1-884777-81-3). + + Tcl/Tk documentation: + + `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. + + `TKDocs `_ + Extensive tutorial plus friendlier widget pages for some of the widgets. + + `Programming Python `_ + Book by Mark Lutz, has excellent coverage of Tkinter. Tkinter Modules @@ -175,21 +188,6 @@ documentation that exists. Here are some hints: place to go when nothing else makes sense. -.. seealso:: - - `Tcl/Tk 8.6 man pages `_ - The Tcl/Tk manual on www.tcl.tk. - - `ActiveState Tcl Home Page `_ - The Tk/Tcl development is largely taking place at ActiveState. - - `Tcl and the Tk Toolkit `_ - The book by John Ousterhout, the inventor of Tcl. - - `Practical Programming in Tcl and Tk `_ - Brent Welch's encyclopedic book. - - A Simple Hello World Program ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ From e030ea54f5814bef4a8299d6c5559aa6833b1127 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Sun, 22 Apr 2018 14:14:40 -0300 Subject: [PATCH 3/7] Add version comment about -m tkinter --- Doc/library/tkinter.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 0e1c38abf6eea9..516a750c0586a3 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -13,9 +13,12 @@ The :mod:`tkinter` package ("Tk interface") is the standard Python interface to the Tk GUI toolkit. Both Tk and :mod:`tkinter` are available on most Unix platforms, as well as on Windows systems. (Tk itself is not part of Python; it -is maintained at ActiveState.) You can check that :mod:`tkinter` is properly -installed on your system by running ``python -m tkinter`` from the command line; -this should open a window demonstrating a simple Tk interface. +is maintained at ActiveState.) + +Running ``python -m tkinter`` from the command line should open a window +demonstrating a simple Tk interface, letting you know that :mod:`tkinter` is +properly installed on your system, and also showing what version of Tcl/Tk is +installed, so you can read the Tcl/Tk documentation specific to that version. .. seealso:: From 8e553a0000a865c05d37e306acba30da7a1a7e73 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Sun, 22 Apr 2018 18:22:08 -0300 Subject: [PATCH 4/7] Move links to correct section --- Doc/library/tkinter.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 516a750c0586a3..97c3d047241e00 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -22,7 +22,7 @@ installed, so you can read the Tcl/Tk documentation specific to that version. .. seealso:: - Tkinter-specific documentation: + Tkinter documentation: `Python Tkinter Resources `_ The Python Tkinter Topic Guide provides a great deal of information on using Tk @@ -40,6 +40,12 @@ installed, so you can read the Tcl/Tk documentation specific to that version. `Python and Tkinter Programming `_ Book by John Grayson (ISBN 1-884777-81-3). + `Programming Python `_ + Book by Mark Lutz, has excellent coverage of Tkinter. + + `TKDocs `_ + Extensive tutorial plus friendlier widget pages for some of the widgets. + Tcl/Tk documentation: `Tcl/Tk recent man pages `_ @@ -54,12 +60,6 @@ installed, so you can read the Tcl/Tk documentation specific to that version. `Practical Programming in Tcl and Tk `_ Brent Welch's encyclopedic book. - `TKDocs `_ - Extensive tutorial plus friendlier widget pages for some of the widgets. - - `Programming Python `_ - Book by Mark Lutz, has excellent coverage of Tkinter. - Tkinter Modules --------------- From 5431340e6d7b3af6785f8fe89dc3b373c0be5351 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Sun, 22 Apr 2018 18:43:14 -0300 Subject: [PATCH 5/7] Undo unintentional sorting change --- Doc/library/tkinter.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 97c3d047241e00..1751f81ecf8d17 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -28,24 +28,24 @@ installed, so you can read the Tcl/Tk documentation specific to that version. 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. + `TKDocs `_ + Extensive tutorial plus friendlier widget pages for some of the widgets. + `Tkinter reference: a GUI for Python `_ On-line reference material. `Tkinter docs from effbot `_ Online reference for tkinter supported by effbot.org. + `Programming Python `_ + Book by Mark Lutz, has excellent coverage of Tkinter. + `Modern Tkinter for Busy Python Developers `_ Book by Mark Rozerman about building attractive and modern graphical user interfaces with Python and Tkinter. `Python and Tkinter Programming `_ Book by John Grayson (ISBN 1-884777-81-3). - `Programming Python `_ - Book by Mark Lutz, has excellent coverage of Tkinter. - - `TKDocs `_ - Extensive tutorial plus friendlier widget pages for some of the widgets. - Tcl/Tk documentation: `Tcl/Tk recent man pages `_ From f588afd60393b29e98f1a70cdf012ec854028904 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Sun, 22 Apr 2018 23:23:30 -0300 Subject: [PATCH 6/7] Add link to Tk commands at the top of the list --- Doc/library/tkinter.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 1751f81ecf8d17..c4ad2e39cb07be 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -22,6 +22,10 @@ installed, so you can read the Tcl/Tk documentation specific to that version. .. seealso:: + `Tk commands `_ + Commands without underscores in their name correspond to :mod:`tkinter` or :mod:`tkinter.ttk` widget classes. + Change '6' to match the minor version of your Tcl/Tk installation (e.g. '5' for Tcl/Tk 8.5). + Tkinter documentation: `Python Tkinter Resources `_ From b0e0abdc2cafe65511b8c6b5b2fb57aaa437c688 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9s=20Delfino?= Date: Mon, 23 Apr 2018 09:24:38 -0300 Subject: [PATCH 7/7] Move Tk commands link, and update comment --- Doc/library/tkinter.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index c4ad2e39cb07be..d74e27e038a78c 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -22,10 +22,6 @@ installed, so you can read the Tcl/Tk documentation specific to that version. .. seealso:: - `Tk commands `_ - Commands without underscores in their name correspond to :mod:`tkinter` or :mod:`tkinter.ttk` widget classes. - Change '6' to match the minor version of your Tcl/Tk installation (e.g. '5' for Tcl/Tk 8.5). - Tkinter documentation: `Python Tkinter Resources `_ @@ -52,6 +48,10 @@ installed, so you can read the Tcl/Tk documentation specific to that version. Tcl/Tk documentation: + `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.