[Python-checkins] python/dist/src/Doc/lib tkinter.tex,1.22,1.23

[david_ascher at users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv24617/dist/src/Doc/lib

Modified Files:
	tkinter.tex 
Log Message:
Implementation of patch 869468

Allow the user to create Tkinter.Tcl objects which are
just like Tkinter.Tk objects except that they do not
initialize Tk. This is useful in circumstances where the
script is being run on machines that do not have an X
server running -- in those cases, Tk initialization fails,
even if no window is ever created.

Includes documentation change and tests.

Tested on Linux, Solaris and Windows.

Reviewed by Martin von Loewis.


Index: tkinter.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/tkinter.tex,v
retrieving revision 1.22
retrieving revision 1.23
diff -C2 -d -r1.22 -r1.23
*** tkinter.tex	28 Jul 2003 14:39:13 -0000	1.22
--- tkinter.tex	18 Feb 2004 05:59:52 -0000	1.23
***************
*** 95,99 ****
  \end{verbatim}
  
! \begin{classdesc}{Tk}{screenName=None, baseName=None, className='Tk'}
  The \class{Tk} class is instantiated without arguments.
  This creates a toplevel widget of Tk which usually is the main window
--- 95,99 ----
  \end{verbatim}
  
! \begin{classdesc}{Tk}{screenName=None, baseName=None, className='Tk', useTk=1}
  The \class{Tk} class is instantiated without arguments.
  This creates a toplevel widget of Tk which usually is the main window
***************
*** 102,105 ****
--- 102,116 ----
  \end{classdesc}
  
+ \begin{funcdesc}{Tcl}{screenName=None, baseName=None, className='Tk', useTk=0}
+ The \function{Tcl} function is a factory function which creates an object
+ much like that created by the \class{Tk} class, except that it does not
+ initialize the Tk subsystem.  This is most often useful when driving the Tcl
+ interpreter in an environment where one doesn't want to create extraneous
+ toplevel windows, or where one cannot (i.e. Unix/Linux systems without an X
+ server).  An object created by the \function{Tcl} object can have a Toplevel
+ window created (and the Tk subsystem initialized) by calling its
+ \method{loadtk} method.
+ \end{funcdesc}
+ 
  Other modules that provide Tk support include: