[3.6] bpo-33280: Reorganize external Tcl/Tk references. (GH-6473). (#6602)

(cherry picked from commit 67a8f4fed3)

Co-authored-by: Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
This commit is contained in:
Andrés Delfino 2018-04-26 11:10:10 -03:00 committed by Serhiy Storchaka
parent b16681fb1e
commit 4533494ac5
1 changed files with 29 additions and 24 deletions

View File

@ -13,12 +13,17 @@
The :mod:`tkinter` package ("Tk interface") is the standard Python interface to 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 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 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 is maintained at ActiveState.)
installed on your system by running ``python -m tkinter`` from the command line;
this should open a window demonstrating a simple Tk interface. 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:: .. seealso::
Tkinter documentation:
`Python Tkinter Resources <https://wiki.python.org/moin/TkInter>`_ `Python Tkinter Resources <https://wiki.python.org/moin/TkInter>`_
The Python Tkinter Topic Guide provides a great deal of information on using Tk 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. from Python and links to other sources of information on Tk.
@ -32,17 +37,32 @@ this should open a window demonstrating a simple Tk interface.
`Tkinter docs from effbot <http://effbot.org/tkinterbook/>`_ `Tkinter docs from effbot <http://effbot.org/tkinterbook/>`_
Online reference for tkinter supported by effbot.org. Online reference for tkinter supported by effbot.org.
`Tcl/Tk manual <https://www.tcl.tk/man/tcl8.5/>`_ `Programming Python <http://learning-python.com/about-pp4e.html>`_
Official manual for the latest tcl/tk version.
`Programming Python <http://learning-python.com/books/about-pp4e.html>`_
Book by Mark Lutz, has excellent coverage of Tkinter. Book by Mark Lutz, has excellent coverage of Tkinter.
`Modern Tkinter for Busy Python Developers <http://www.amazon.com/Modern-Tkinter-Python-Developers-ebook/dp/B0071QDNLO/>`_ `Modern Tkinter for Busy Python Developers <https://www.amazon.com/Modern-Tkinter-Python-Developers-ebook/dp/B0071QDNLO/>`_
Book by Mark Rozerman about building attractive and modern graphical user interfaces with Python and Tkinter. Book by Mark Rozerman about building attractive and modern graphical user interfaces with Python and Tkinter.
`Python and Tkinter Programming <https://www.manning.com/books/python-and-tkinter-programming>`_ `Python and Tkinter Programming <https://www.manning.com/books/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:
`Tk commands <https://www.tcl.tk/man/tcl8.6/TkCmd/contents.htm>`_
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 <https://www.tcl.tk/doc/>`_
Recent Tcl/Tk manuals on www.tcl.tk.
`ActiveState Tcl Home Page <http://tcl.activestate.com/>`_
The Tk/Tcl development is largely taking place at ActiveState.
`Tcl and the Tk Toolkit <https://www.amazon.com/exec/obidos/ASIN/020163337X>`_
Book by John Ousterhout, the inventor of Tcl.
`Practical Programming in Tcl and Tk <http://www.beedub.com/book/>`_
Brent Welch's encyclopedic book.
Tkinter Modules Tkinter Modules
@ -175,21 +195,6 @@ documentation that exists. Here are some hints:
place to go when nothing else makes sense. place to go when nothing else makes sense.
.. seealso::
`Tcl/Tk 8.6 man pages <https://www.tcl.tk/man/tcl8.6/>`_
The Tcl/Tk manual on www.tcl.tk.
`ActiveState Tcl Home Page <http://tcl.activestate.com/>`_
The Tk/Tcl development is largely taking place at ActiveState.
`Tcl and the Tk Toolkit <http://www.amazon.com/exec/obidos/ASIN/020163337X>`_
The book by John Ousterhout, the inventor of Tcl.
`Practical Programming in Tcl and Tk <http://www.beedub.com/book/>`_
Brent Welch's encyclopedic book.
A Simple Hello World Program A Simple Hello World Program
^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^