From 1a263ad62f11709e16c41f2448421287cde21e27 Mon Sep 17 00:00:00 2001 From: Ezio Melotti Date: Sun, 14 Mar 2010 09:51:37 +0000 Subject: #7057: fix several errors. --- Doc/library/pydoc.rst | 2 +- Doc/library/tkinter.rst | 96 +++++++++++++++++++++++++-------------------- Doc/library/tkinter.tix.rst | 2 +- Doc/library/tkinter.ttk.rst | 13 +++--- Doc/library/turtle.rst | 8 ++-- Doc/using/mac.rst | 2 +- 6 files changed, 68 insertions(+), 55 deletions(-) diff --git a/Doc/library/pydoc.rst b/Doc/library/pydoc.rst index b43f84d..4103dd4 100644 --- a/Doc/library/pydoc.rst +++ b/Doc/library/pydoc.rst @@ -54,7 +54,7 @@ that will serve documentation to visiting Web browsers. :program:`pydoc` :option:`-p 1234` will start a HTTP server on port 1234, allowing you to browse the documentation at ``http://localhost:1234/`` in your preferred Web browser. :program:`pydoc` :option:`-g` will start the server and additionally bring up a -small :mod:`Tkinter`\ -based graphical interface to help you search for +small :mod:`tkinter`\ -based graphical interface to help you search for documentation pages. When :program:`pydoc` generates documentation, it uses the current environment diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 74e3fbb..7bb54fd 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -30,8 +30,8 @@ is maintained at ActiveState.) Tkinter Modules --------------- -Most of the time, the :mod:`tkinter` is all you really need, but a number -of additional modules are available as well. The Tk interface is located in a +Most of the time, :mod:`tkinter` is all you really need, but a number of +additional modules are available as well. The Tk interface is located in a binary module named :mod:`_tkinter`. This module contains the low-level interface to Tk, and should never be used directly by application programmers. It is usually a shared library (or DLL), but might in some cases be statically @@ -112,13 +112,13 @@ orientation on the system. Credits: -* Tkinter was written by Steen Lumholt and Guido van Rossum. - * Tk was written by John Ousterhout while at Berkeley. +* Tkinter was written by Steen Lumholt and Guido van Rossum. + * This Life Preserver was written by Matt Conway at the University of Virginia. -* The html rendering, and some liberal editing, was produced from a FrameMaker +* The HTML rendering, and some liberal editing, was produced from a FrameMaker version by Ken Manheimer. * Fredrik Lundh elaborated and revised the class interface descriptions, to get @@ -143,10 +143,10 @@ order to use Tkinter, you will have to know a little bit about Tk. This document can't fulfill that role, so the best we can do is point you to the best documentation that exists. Here are some hints: -* The authors strongly suggest getting a copy of the Tk man pages. Specifically, - the man pages in the ``mann`` directory are most useful. The ``man3`` man pages - describe the C interface to the Tk library and thus are not especially helpful - for script writers. +* The authors strongly suggest getting a copy of the Tk man pages. + Specifically, the man pages in the ``manN`` directory are most useful. + The ``man3`` man pages describe the C interface to the Tk library and thus + are not especially helpful for script writers. * Addison-Wesley publishes a book called Tcl and the Tk Toolkit by John Ousterhout (ISBN 0-201-63337-X) which is a good introduction to Tcl and Tk for @@ -159,6 +159,9 @@ documentation that exists. Here are some hints: .. 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. @@ -183,8 +186,8 @@ A Simple Hello World Program def createWidgets(self): self.QUIT = Button(self) self.QUIT["text"] = "QUIT" - self.QUIT["fg"] = "red" - self.QUIT["command"] = self.quit + self.QUIT["fg"] = "red" + self.QUIT["command"] = self.quit self.QUIT.pack({"side": "left"}) @@ -257,7 +260,7 @@ To make a widget in Tk, the command is always of the form:: For example:: button .fred -fg red -text "hi there" - ^ ^ \_____________________/ + ^ ^ \______________________/ | | | class new options command widget (-opt val -opt val ...) @@ -301,15 +304,15 @@ constructor, and keyword-args for configure calls or as instance indices, in dictionary style, for established instances. See section :ref:`tkinter-setting-options` on setting options. :: - button .fred -fg red =====> fred = Button(panel, fg = "red") + button .fred -fg red =====> fred = Button(panel, fg="red") .fred configure -fg red =====> fred["fg"] = red - OR ==> fred.config(fg = "red") + OR ==> fred.config(fg="red") In Tk, to perform an action on a widget, use the widget name as a command, and follow it with an action name, possibly with arguments (options). In Tkinter, you call methods on the class instance to invoke actions on the widget. The -actions (methods) that a given widget can perform are listed in the Tkinter.py -module. :: +actions (methods) that a given widget can perform are listed in +:file:`tkinter/__init__.py`. :: .fred invoke =====> fred.invoke() @@ -320,7 +323,7 @@ various forms of the pack command are implemented as methods. All widgets in methods. See the :mod:`tkinter.tix` module documentation for additional information on the Form geometry manager. :: - pack .fred -side left =====> fred.pack(side = "left") + pack .fred -side left =====> fred.pack(side="left") How Tk and Tkinter are Related @@ -332,14 +335,15 @@ Your App Here (Python) A Python application makes a :mod:`tkinter` call. tkinter (Python Package) - This call (say, for example, creating a button widget), is implemented in the - *tkinter* package, which is written in Python. This Python function will parse - the commands and the arguments and convert them into a form that makes them look - as if they had come from a Tk script instead of a Python script. + This call (say, for example, creating a button widget), is implemented in + the :mod:`tkinter` package, which is written in Python. This Python + function will parse the commands and the arguments and convert them into a + form that makes them look as if they had come from a Tk script instead of + a Python script. -tkinter (C) +_tkinter (C) These commands and their arguments will be passed to a C function in the - *tkinter* - note the lowercase - extension module. + :mod:`_tkinter` - note the underscore - extension module. Tk Widgets (C and Tcl) This C function is able to make calls into other C modules, including the C @@ -370,7 +374,7 @@ be set in three ways: At object creation time, using keyword arguments :: - fred = Button(self, fg = "red", bg = "blue") + fred = Button(self, fg="red", bg="blue") After object creation, treating the option name like a dictionary index :: @@ -381,7 +385,7 @@ After object creation, treating the option name like a dictionary index Use the config() method to update multiple attrs subsequent to object creation :: - fred.config(fg = "red", bg = "blue") + fred.config(fg="red", bg="blue") For a complete explanation of a given option and its behavior, see the Tk man pages for the widget in question. @@ -464,8 +468,8 @@ where the widget is to appear within its container, and how it is to behave when the main application window is resized. Here are some examples:: fred.pack() # defaults to side = "top" - fred.pack(side = "left") - fred.pack(expand = 1) + fred.pack(side="left") + fred.pack(expand=1) Packer Options @@ -506,7 +510,7 @@ Unfortunately, in the current implementation of :mod:`tkinter` it is not possible to hand over an arbitrary Python variable to a widget through a ``variable`` or ``textvariable`` option. The only kinds of variables for which this works are variables that are subclassed from a class called Variable, -defined in the :mod:`tkinter`. +defined in :mod:`tkinter`. There are many useful subclasses of Variable already defined: :class:`StringVar`, :class:`IntVar`, :class:`DoubleVar`, and @@ -606,7 +610,7 @@ callback This is any Python function that takes no arguments. For example:: def print_it(): - print("hi there") + print("hi there") fred["command"] = print_it color @@ -702,24 +706,32 @@ Notice how the widget field of the event is being accessed in the :meth:`turnRed` callback. This field contains the widget that caught the X event. The following table lists the other event fields you can access, and how they are denoted in Tk, which can be useful when referring to the Tk man pages. -:: - Tk Tkinter Event Field Tk Tkinter Event Field - -- ------------------- -- ------------------- - %f focus %A char - %h height %E send_event - %k keycode %K keysym - %s state %N keysym_num - %t time %T type - %w width %W widget - %x x %X x_root - %y y %Y y_root ++----+---------------------+----+---------------------+ +| Tk | Tkinter Event Field | Tk | Tkinter Event Field | ++====+=====================+====+=====================+ +| %f | focus | %A | char | ++----+---------------------+----+---------------------+ +| %h | height | %E | send_event | ++----+---------------------+----+---------------------+ +| %k | keycode | %K | keysym | ++----+---------------------+----+---------------------+ +| %s | state | %N | keysym_num | ++----+---------------------+----+---------------------+ +| %t | time | %T | type | ++----+---------------------+----+---------------------+ +| %w | width | %W | widget | ++----+---------------------+----+---------------------+ +| %x | x | %X | x_root | ++----+---------------------+----+---------------------+ +| %y | y | %Y | y_root | ++----+---------------------+----+---------------------+ The index Parameter ^^^^^^^^^^^^^^^^^^^ -A number of widgets require"index" parameters to be passed. These are used to +A number of widgets require "index" parameters to be passed. These are used to point at a specific place in a Text widget, or to particular characters in an Entry widget, or to particular menu items in a Menu widget. @@ -755,7 +767,7 @@ Menu indexes (menu.invoke(), menu.entryconfig(), etc.) * an integer which refers to the numeric position of the entry in the widget, counted from the top, starting with 0; - * the string ``'active'``, which refers to the menu position that is currently + * the string ``"active"``, which refers to the menu position that is currently under the cursor; * the string ``"last"`` which refers to the last menu item; diff --git a/Doc/library/tkinter.tix.rst b/Doc/library/tkinter.tix.rst index 6298bac..bbe66d8 100644 --- a/Doc/library/tkinter.tix.rst +++ b/Doc/library/tkinter.tix.rst @@ -84,7 +84,7 @@ Tix Widgets ----------- `Tix `_ -introduces over 40 widget classes to the :mod:`Tkinter` repertoire. There is a +introduces over 40 widget classes to the :mod:`tkinter` repertoire. There is a demo of all the :mod:`tkinter.tix` widgets in the :file:`Demo/tix` directory of the standard distribution. diff --git a/Doc/library/tkinter.ttk.rst b/Doc/library/tkinter.ttk.rst index 72875f4..7bf39b3 100644 --- a/Doc/library/tkinter.ttk.rst +++ b/Doc/library/tkinter.ttk.rst @@ -116,12 +116,13 @@ All the :mod:`ttk` Widgets accepts the following options: | | for the parent widget. | +-----------+--------------------------------------------------------------+ | takefocus | Determines whether the window accepts the focus during | - | | keyboard traversal. 0, 1 or an empty is return. If 0 is | - | | returned, it means that the window should be skipped entirely| - | | during keyboard traversal. If 1, it means that the window | - | | should receive the input focus as long as it is viewable. And| - | | an empty string means that the traversal scripts make the | - | | decision about whether or not to focus on the window. | + | | keyboard traversal. 0, 1 or an empty string is returned. | + | | If 0 is returned, it means that the window should be skipped | + | | entirely during keyboard traversal. If 1, it means that the | + | | window should receive the input focus as long as it is | + | | viewable. And an empty string means that the traversal | + | | scripts make the decision about whether or not to focus | + | | on the window. | +-----------+--------------------------------------------------------------+ | style | May be used to specify a custom widget style. | +-----------+--------------------------------------------------------------+ diff --git a/Doc/library/turtle.rst b/Doc/library/turtle.rst index 5f9de57..c6ba316 100644 --- a/Doc/library/turtle.rst +++ b/Doc/library/turtle.rst @@ -35,13 +35,13 @@ programmer to use all the commands, classes and methods interactively when using the module from within IDLE run with the ``-n`` switch. The turtle module provides turtle graphics primitives, in both object-oriented -and procedure-oriented ways. Because it uses :mod:`Tkinter` for the underlying +and procedure-oriented ways. Because it uses :mod:`tkinter` for the underlying graphics, it needs a version of Python installed with Tk support. The object-oriented interface uses essentially two+two classes: 1. The :class:`TurtleScreen` class defines graphics windows as a playground for - the drawing turtles. Its constructor needs a :class:`Tkinter.Canvas` or a + the drawing turtles. Its constructor needs a :class:`tkinter.Canvas` or a :class:`ScrolledCanvas` as argument. It should be used when :mod:`turtle` is used as part of some application. @@ -1998,7 +1998,7 @@ The public classes of the module :mod:`turtle` .. class:: RawTurtle(canvas) RawPen(canvas) - :param canvas: a :class:`Tkinter.Canvas`, a :class:`ScrolledCanvas` or a + :param canvas: a :class:`tkinter.Canvas`, a :class:`ScrolledCanvas` or a :class:`TurtleScreen` Create a turtle. The turtle has all methods described above as "methods of @@ -2013,7 +2013,7 @@ The public classes of the module :mod:`turtle` .. class:: TurtleScreen(cv) - :param cv: a :class:`Tkinter.Canvas` + :param cv: a :class:`tkinter.Canvas` Provides screen oriented methods like :func:`setbg` etc. that are described above. diff --git a/Doc/using/mac.rst b/Doc/using/mac.rst index c92398f..5ab30b6 100644 --- a/Doc/using/mac.rst +++ b/Doc/using/mac.rst @@ -143,7 +143,7 @@ There are several options for building GUI applications on the Mac with Python. the foundation of most modern Mac development. Information on PyObjC is available from http://pyobjc.sourceforge.net. -The standard Python GUI toolkit is :mod:`Tkinter`, based on the cross-platform +The standard Python GUI toolkit is :mod:`tkinter`, based on the cross-platform Tk toolkit (http://www.tcl.tk). An Aqua-native version of Tk is bundled with OS X by Apple, and the latest version can be downloaded and installed from http://www.activestate.com; it can also be built from source. -- cgit v0.12