README for python-tix
---------------------

How to install a version of python that supports Tix:

1. If Python, Tcl, Tk, and Tix are not installed on your system, get
	them. You do not need the Tcl and Tk sources to compile
	Python, but you do need them to compile Tix. So if you don't
	have Tix, then you have to get everything. 

(For some reason, Netscape sometimes has trouble contacting ftp.smli.com)

	Python: ftp.python.org       /pub/python/src/python1.3.tar.gz 
	Tcl:    ftp.smli.com         /pub/tcl/tcl7.4.tar.gz
	Tk:     ftp.smli.com         /pub/tcl/tk4.0.tar.gz
	Tix:    ftp.cis.upenn.edu    /pub/ioi/Tix4.0b4.tar.gz 

2. Unpack the files you just got in the same parent directory as the
	parent directory of Python and python-tix. 
	For example:

	gunzip tk4.0.tar.gz ; tar -xvf tk4.0.tar

	Order of upacking does not matter as long as python-tix.tar.gz
	is unpacked after python itself. 
 
3. These instructions are _very_ brief. For more information, please
	look at the docs for the package you are trying to install. 
	Compile and install Tcl, Tk and Tix in that order.  If
	some of these are already on your system, then you don't have
	to reinstall them. To install Tcl and/or Tk, go to the top
	directory of the Tcl or Tk source and type "./configure". Then
	type "make". If you can install these in a normal place such
	as /usr/local, you will be better off later. If you want to
	install them in another place, you must edit the Makefiles or
	pass arguments to "./configure". To install, type 'make
	install" (Read their documentation) To build Tix, go to the
	src dircetory of the Tix distribution and type "./configure"
	then type "make."

	Examples:	

		To build Tcl:
			cd /usr/src/tcl7.4/
			./configure
			make
			make install
		
		To build Tk:
			cd /usr/src/tk4.0/
			./configure
			make
			make install
		
		To build Tix:
			cd /usr/src/Tix4.0b4/src
			./configure
			make
			make install

	If you have problems, read the documentation of the package
	you are having problems with.
		
	
4. Edit "tix-install" so that it knows where all of your Tcl/Tk/Tix
	files are.
5. Execute tix-install.
6. Edit Setup.in in the Modules Directory of the Python distribution:

	> Uncomment the line  TKPATH=:$(DESTLIB)/tkinter
	> After where the file says:

	 #tkinter tkintermodule.c tkappinit.c -DWITH_APPINIT 
	   -I/usr/local/include -L/usr/local/lib -ltk -ltcl -lX11

	> You should add this:

	# Tix additions... 
	pytix=./../../Tix4.0b4/src #These should point to the directories
	pytk=./../../tk4.0         #where the libraries are...  
	pytcl=./../../tcl7.4
	  tkinter tkintermodule.c tkappinit.c -DWITH_APPINIT \
	-DWITH_TIX -L${pytk} -L${pytcl} -L${pytix} \
	-I/usr/local/include -L/usr/local/lib -ltix -ltk -ltcl -lX11


5. Compile and install the Python distribution. In the top level of
	the source, type:
	
	./configure      (If you are installing in /usr/local)

	or

	./configure --prefix=your_prefix (If installing somewhere else)

	then type:

	 make
	 make install
	 make libinstall

6. Try out a few programs from the python-tix/demos directory. 
	While in the python-tix/demos directory:

		python NoteBook.py

7. Currently the only documentation available for the Tkinter module
	is the "Tkinter Life Preserver" at

	ftp://ftp.cwi.nl/pub/python/doc/tkinter-doc.tar.gz

	For help with the Tix stuff, the Tix html man pages are very
	good.

---------------------------------------------------------
If you have trouble, it will probably come in one of two forms:

1. Python says: TCL ERROR: Tcl_AppInit failed.
	
	This usually means that python can not find all of the Tk,
Tcl, or Tix files that it needs. To remedy this, look at the 
environment variables TCL_LIBRARY, TK_LIBRARY, TIX_LIBRARY. Try
running tixwish. It will give you more descriptive error messages
about the libraries.

2. Python says: No module named Tkinter

	The Tkinter module is not in your sys.path. You should put the
directory with the python modules in your path.

--------------------------------------------------------
If you have questions or comments, please feel free to send me mail at

	jmp7d@virginia.edu

 	Thanks,

	James Patten

