Doc changes for the big Tkinter rename.

Doc/library/idle.rst

@@ -10,11 +10,11 @@ IDLE
    single: Python Editor
    single: Integrated Development Environment
 
-IDLE is the Python IDE built with the :mod:`Tkinter` GUI toolkit.
+IDLE is the Python IDE built with the :mod:`tkinter` GUI toolkit.
 
 IDLE has the following features:
 
-* coded in 100% pure Python, using the :mod:`Tkinter` GUI toolkit
+* coded in 100% pure Python, using the :mod:`tkinter` GUI toolkit
 
 * cross-platform: works on Windows and Unix (on Mac OS, there are currently
   problems with Tcl/Tk)

Doc/library/othergui.rst

@@ -3,13 +3,13 @@
 Other Graphical User Interface Packages
 =======================================
 
-There are an number of extension widget sets to :mod:`Tkinter`.
+There are an number of extension widget sets to :mod:`tkinter`.
 
 .. seealso::
 
    `Python megawidgets <http://pmw.sourceforge.net/>`_
       is a toolkit for building high-level compound widgets in Python using the
-      :mod:`Tkinter` module.  It consists of a set of base classes and a library of
+      :mod:`tkinter` package.  It consists of a set of base classes and a library of
       flexible and extensible megawidgets built on this foundation. These megawidgets
       include notebooks, comboboxes, selection widgets, paned widgets, scrolled
       widgets, dialog windows, etc.  Also, with the Pmw.Blt interface to BLT, the

Doc/library/tk.rst

@@ -12,19 +12,20 @@ Graphical User Interfaces with Tk
 
 Tk/Tcl has long been an integral part of Python.  It provides a robust and
 platform independent windowing toolkit, that is available to Python programmers
-using the :mod:`Tkinter` module, and its extension, the :mod:`Tix` module.
+using the :mod:`tkinter` package, and its extension, the :mod:`tkinter.tix` 
+module.
 
-The :mod:`Tkinter` module is a thin object-oriented layer on top of Tcl/Tk. To
-use :mod:`Tkinter`, you don't need to write Tcl code, but you will need to
+The :mod:`tkinter` package is a thin object-oriented layer on top of Tcl/Tk. To
+use :mod:`tkinter`, you don't need to write Tcl code, but you will need to
 consult the Tk documentation, and occasionally the Tcl documentation.
-:mod:`Tkinter` is a set of wrappers that implement the Tk widgets as Python
+:mod:`tkinter` is a set of wrappers that implement the Tk widgets as Python
 classes.  In addition, the internal module :mod:`_tkinter` provides a threadsafe
 mechanism which allows Python and Tcl to interact.
 
-:mod:`Tkinter`'s chief virtues are that it is fast, and that it usually comes
+:mod:`tkinter`'s chief virtues are that it is fast, and that it usually comes
 bundled with Python. Although its standard documentation is weak, good 
 material is available, which includes: references, tutorials, a book and 
-others. :mod:`Tkinter` is also famous for having an outdated look and feel, 
+others. :mod:`tkinter` is also famous for having an outdated look and feel, 
 which has been vastly improved in Tk 8.5. Nevertheless, there are many other 
 GUI libraries that you could be interested in. For more information about 
 alternatives, see the :ref:`other-gui-packages` section.
@@ -32,9 +33,9 @@ alternatives, see the :ref:`other-gui-packages` section.
 .. toctree::
    
    tkinter.rst
-   tix.rst
-   scrolledtext.rst
-   turtle.rst
+   tkinter.tix.rst
+   tkinter.scrolledtext.rst
+   tkinter.turtle.rst
    idle.rst
    othergui.rst
 

Doc/library/scrolledtext.rst → Doc/library/tkinter.scrolledtext.rst

-:mod:`ScrolledText` --- Scrolled Text Widget
-============================================
+:mod:`tkinter.scrolledtext` --- Scrolled Text Widget
+====================================================
 
 .. module:: ScrolledText
+   :synopsis: Old name for the tkinter.scrolledtext module.
+
+.. module:: tkinter.scrolledtext
    :platform: Tk
    :synopsis: Text widget with a vertical scroll bar.
 .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
 
+.. note::
+   The :mod:`ScrolledText` module has been renamed to
+   :mod:`tkinter.scrolledtext` in Python 3.0.  It is importable under both names
+   in Python 2.6 and the rest of the 2.x series.
 
-The :mod:`ScrolledText` module provides a class of the same name which
+The :mod:`tkinter.scrolledtext` module provides a class of the same name which
 implements a basic text widget which has a vertical scroll bar configured to do
 the "right thing."  Using the :class:`ScrolledText` class is a lot easier than
 setting up a text widget and scroll bar directly.  The constructor is the same
-as that of the :class:`Tkinter.Text` class.
+as that of the :class:`tkinter.Text` class.
+
+.. versionchanged:: 2.6
+   Renamed from ``ScrolledText``.
 
 The text widget and scrollbar are packed together in a :class:`Frame`, and the
 methods of the :class:`Grid` and :class:`Pack` geometry managers are acquired

Doc/library/tix.rst → Doc/library/tkinter.tix.rst

-:mod:`Tix` --- Extension widgets for Tk
-=======================================
+:mod:`tkinter.tix` --- Extension widgets for Tk
+===============================================
 
 .. module:: Tix
+   :synopsis: Old name for the tkinter.tix module.
+
+.. module:: tkinter.tix
    :synopsis: Tk Extension Widgets for Tkinter
 .. sectionauthor:: Mike Clarkson <mikeclarkson@users.sourceforge.net>
 
+.. note::
+   The :mod:`Tix` module has been renamed to :mod:`tkinter.tix` in Python 3.0.
+   It is importable under both names in Python 2.6 and the rest of the 2.x
+   series.
 
 .. index:: single: Tix
 
-The :mod:`Tix` (Tk Interface Extension) module provides an additional rich set
-of widgets. Although the standard Tk library has many useful widgets, they are
-far from complete. The :mod:`Tix` library provides most of the commonly needed
-widgets that are missing from standard Tk: :class:`HList`, :class:`ComboBox`,
-:class:`Control` (a.k.a. SpinBox) and an assortment of scrollable widgets.
-:mod:`Tix` also includes many more widgets that are generally useful in a wide
-range of applications: :class:`NoteBook`, :class:`FileEntry`,
+The :mod:`tkinter.tix` (Tk Interface Extension) module provides an additional 
+rich set of widgets. Although the standard Tk library has many useful widgets, 
+they are far from complete. The :mod:`tkinter.tix` library provides most of the
+commonly needed widgets that are missing from standard Tk: :class:`HList`, 
+:class:`ComboBox`, :class:`Control` (a.k.a. SpinBox) and an assortment of 
+scrollable widgets. 
+:mod:`tkinter.tix` also includes many more widgets that are generally useful in
+a wide range of applications: :class:`NoteBook`, :class:`FileEntry`,
 :class:`PanedWindow`, etc; there are more than 40 of them.
 
 With all these new widgets, you can introduce new interaction techniques into
@@ -22,7 +30,6 @@ applications, creating more useful and more intuitive user interfaces. You can
 design your application by choosing the most appropriate widgets to match the
 special needs of your application and users.
 
-
 .. seealso::
 
    `Tix Homepage <http://tix.sourceforge.net/>`_
@@ -50,27 +57,27 @@ Using Tix
    Toplevel widget of Tix which represents mostly the main window of an
    application. It has an associated Tcl interpreter.
 
-   Classes in the :mod:`Tix` module subclasses the classes in the :mod:`Tkinter`
-   module. The former imports the latter, so to use :mod:`Tix` with Tkinter, all
-   you need to do is to import one module. In general, you can just import
-   :mod:`Tix`, and replace the toplevel call to :class:`Tkinter.Tk` with
-   :class:`Tix.Tk`::
+   Classes in the :mod:`tkinter.tix` module subclasses the classes in the 
+   :mod:`tkinter`. The former imports the latter, so to use :mod:`tkinter.tix` 
+   with Tkinter, all you need to do is to import one module. In general, you 
+   can just import :mod:`tkinter.tix`, and replace the toplevel call to 
+   :class:`tkinter.Tk` with :class:`tix.Tk`::
 
-      import Tix
-      from Tkconstants import *
-      root = Tix.Tk()
+      from tkinter import tix
+      from tkinter.constants import *
+      root = tix.Tk()
 
-To use :mod:`Tix`, you must have the :mod:`Tix` widgets installed, usually
+To use :mod:`tkinter.tix`, you must have the Tix widgets installed, usually
 alongside your installation of the Tk widgets. To test your installation, try
 the following::
 
-   import Tix
-   root = Tix.Tk()
+   from tkinter import tix
+   root = tix.Tk()
    root.tk.eval('package require Tix')
 
 If this fails, you have a Tk installation problem which must be resolved before
 proceeding. Use the environment variable :envvar:`TIX_LIBRARY` to point to the
-installed :mod:`Tix` library directory, and make sure you have the dynamic
+installed Tix library directory, and make sure you have the dynamic
 object library (:file:`tix8183.dll` or :file:`libtix8183.so`) in  the same
 directory that contains your Tk dynamic object library (:file:`tk8183.dll` or
 :file:`libtk8183.so`). The directory with the dynamic object library should also
@@ -85,8 +92,8 @@ Tix Widgets
 
 `Tix <http://tix.sourceforge.net/dist/current/man/html/TixCmd/TixIntro.htm>`_
 introduces over 40 widget classes to the :mod:`Tkinter`  repertoire.  There is a
-demo of all the :mod:`Tix` widgets in the :file:`Demo/tix` directory of the
-standard distribution.
+demo of all the :mod:`tkinter.tix` widgets in the :file:`Demo/tix` directory of
+the standard distribution.
 
 .. The Python sample code is still being added to Python, hence commented out
 
@@ -434,11 +441,11 @@ Manager Widgets
 Image Types
 ^^^^^^^^^^^
 
-The :mod:`Tix` module adds:
+The :mod:`tkinter.tix` module adds:
 
 * `pixmap <http://tix.sourceforge.net/dist/current/man/html/TixCmd/pixmap.htm>`_
-  capabilities to all :mod:`Tix` and :mod:`Tkinter` widgets to create color images
-  from XPM files.
+  capabilities to all :mod:`tkinter.tix` and :mod:`tkinter` widgets to create 
+  color images from XPM files.
 
   .. Python Demo of:
   .. \ulink{XPM Image In Button}{http://tix.sourceforge.net/dist/current/demos/samples/Xpm.tcl}
@@ -478,7 +485,7 @@ Miscellaneous Widgets
 Form Geometry Manager
 ^^^^^^^^^^^^^^^^^^^^^
 
-In addition, :mod:`Tix` augments :mod:`Tkinter` by providing:
+In addition, :mod:`tkinter.tix` augments :mod:`tkinter` by providing:
 
 
 .. class:: Form()

Doc/library/turtle.rst → Doc/library/tkinter.turtle.rst

-
-:mod:`turtle` --- Turtle graphics for Tk
-========================================
+:mod:`tkinter.turtle` --- Turtle graphics for Tk
+================================================
 
 .. module:: turtle
+   :synopsis: Old name for the tkinter.turtle module.
+
+.. module:: tkinter.turtle
    :platform: Tk
    :synopsis: An environment for turtle graphics.
 .. moduleauthor:: Guido van Rossum <guido@python.org>
 
+.. note::
+   The :mod:`turtle` module has been renamed to :mod:`tkinter.turtle` in Python
+   3.0.  It is importable under both names in Python 2.6 and the rest of the 2.x
+   series.
+
 
 .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
 
 
-The :mod:`turtle` module provides turtle graphics primitives, in both an
-object-oriented and procedure-oriented ways. Because it uses :mod:`Tkinter` for
+The :mod:`tkinter.turtle` module provides turtle graphics primitives, in both an
+object-oriented and procedure-oriented ways. Because it uses :mod:`tkinter` for
 the underlying graphics, it needs a version of python installed with Tk support.
 
+.. versionchanged:: 2.6
+   Renamed from ``turtle``.
+
 The procedural interface uses a pen and a canvas which are automagically created
 when any of the functions are called.
 
-The :mod:`turtle` module defines the following functions:
+The :mod:`tkinter.turtle` module defines the following functions:
 
 
 .. function:: degrees()