[Python-checkins] r63488 - in python/trunk/Doc: glossary.rst library/future_builtins.rst library/scrolledtext.rst library/tix.rst library/tkinter.rst

[georg.brandl]

Author: georg.brandl
Date: Tue May 20 09:20:12 2008
New Revision: 63488

Log:
Add notes that tkinter modules will be renamed.


Modified:
   python/trunk/Doc/glossary.rst
   python/trunk/Doc/library/future_builtins.rst
   python/trunk/Doc/library/scrolledtext.rst
   python/trunk/Doc/library/tix.rst
   python/trunk/Doc/library/tkinter.rst

Modified: python/trunk/Doc/glossary.rst
==============================================================================
--- python/trunk/Doc/glossary.rst	(original)
+++ python/trunk/Doc/glossary.rst	Tue May 20 09:20:12 2008
@@ -16,6 +16,14 @@
       The typical Python prompt of the interactive shell when entering code for
       an indented code block.
 
+   2to3
+      A tool that tries to convert Python 2.x code to Python 3.x code by
+      handling most of the incompatibilites that can be detected by parsing the
+      source and traversing the parse tree.
+
+      2to3 is available in the standard library as :mod:`lib2to3`; a standalone
+      entry point is provided as :file:`Tools/scripts/2to3`.
+
    argument
       A value passed to a function or method, assigned to a name local to
       the body.  A function or method may have both positional arguments and

Modified: python/trunk/Doc/library/future_builtins.rst
==============================================================================
--- python/trunk/Doc/library/future_builtins.rst	(original)
+++ python/trunk/Doc/library/future_builtins.rst	Tue May 20 09:20:12 2008
@@ -15,7 +15,7 @@
 
    ... code using Python 3-style map and filter ...
 
-The :program:`2to3` tool that ports Python 2 code to Python 3 will recognize
+The :term:`2to3` tool that ports Python 2 code to Python 3 will recognize
 this usage and leave the new builtins alone.
 
 .. note::

Modified: python/trunk/Doc/library/scrolledtext.rst
==============================================================================
--- python/trunk/Doc/library/scrolledtext.rst	(original)
+++ python/trunk/Doc/library/scrolledtext.rst	Tue May 20 09:20:12 2008
@@ -13,6 +13,12 @@
 setting up a text widget and scroll bar directly.  The constructor is the same
 as that of the :class:`Tkinter.Text` class.
 
+.. note::
+
+   :mod:`ScrolledText` has been renamed to :mod:`tkinter.scrolledtext` in Python
+   3.0.  The :term:`2to3` tool will automatically adapt imports when converting
+   your sources to 3.0.
+
 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
 from the :class:`Frame` object.  This allows the :class:`ScrolledText` widget to

Modified: python/trunk/Doc/library/tix.rst
==============================================================================
--- python/trunk/Doc/library/tix.rst	(original)
+++ python/trunk/Doc/library/tix.rst	Tue May 20 09:20:12 2008
@@ -22,6 +22,11 @@
 design your application by choosing the most appropriate widgets to match the
 special needs of your application and users.
 
+.. note::
+
+   :mod:`Tix` has been renamed to :mod:`tkinter.tix` in Python 3.0.  The
+   :term:`2to3` tool will automatically adapt imports when converting your
+   sources to 3.0.
 
 .. seealso::
 

Modified: python/trunk/Doc/library/tkinter.rst
==============================================================================
--- python/trunk/Doc/library/tkinter.rst	(original)
+++ python/trunk/Doc/library/tkinter.rst	Tue May 20 09:20:12 2008
@@ -11,6 +11,11 @@
 platforms, as well as on Windows and Macintosh systems.  (Tk itself is not part
 of Python; it is maintained at ActiveState.)
 
+.. note::
+
+   :mod:`Tkinter` has been renamed to :mod:`tkinter` in Python 3.0.  The
+   :term:`2to3` tool will automatically adapt imports when converting your
+   sources to 3.0.
 
 .. seealso::
 
@@ -107,6 +112,9 @@
 :mod:`turtle`
    Turtle graphics in a Tk window.
 
+These have been renamed as well in Python 3.0; they were all made submodules of
+the new ``tkinter`` package.
+
 
 Tkinter Life Preserver
 ----------------------