bpo-33280: Reorganize external Tcl/Tk references. (GH-6473)

(cherry picked from commit 67a8f4fed3)

Co-authored-by: Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2018-04-25 11:30:58 -07:00 committed by GitHub
parent 6a1799e6f0
commit 53d36cc961
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

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,9 +37,6 @@ 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/>`_
Official manual for the latest tcl/tk version.
`Programming Python <http://learning-python.com/about-pp4e.html>`_ `Programming Python <http://learning-python.com/about-pp4e.html>`_
Book by Mark Lutz, has excellent coverage of Tkinter. Book by Mark Lutz, has excellent coverage of Tkinter.
@ -42,7 +44,25 @@ this should open a window demonstrating a simple Tk interface.
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 <https://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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^