                    PyQt - Python Bindings for the Qt Toolkit


INTRODUCTION

These are the Python bindings for Qt.  You must also have the SIP Python
bindings generator installed.

The homepage is http://www.riverbankcomputing.co.uk/pyqt/.

The homepage of SIP is http://www.riverbankcomputing.co.uk/sip/.


COMMERCIAL VERSION

If you have the Commercial version of PyQt then you should also have a
license file that you downloaded separately.  The license file must be copied
to the "sip" directory before starting to build PyQt.


INSTALLATION

Check for any other README files in this directory that relate to your
particular platform.  Feel free to contribute a README for your platform or to
provide updates to any existing documentation.

The first step is to configure PyQt by running the following command.

	python configure.py

This assumes that the correct Python interpreter is on your path.  Something
like the following may be appropriate on Windows.

	c:\python23\python configure.py

If you have multiple versions of Python installed then make sure you use the
interpreter for which you wish to generate bindings for.

The configure.py script takes many options.  Use the "-h" command line option
to display a full list of the available options.

The next step is to build PyQt using your platform's make command.

	make

The final step is to install PyQt by running the following command.  (Depending
on your system you may require root or administrator privileges.)

	make install

Note that this method of installation is relatively new.  If you experience
problems than please send a bug report and try the old method described below.

Note that if you built SIP using "the new way", you must also build PyQt using
"the new way".


INSTALLATION - THE OLD WAY

This is the deprecated method of building PyQt.  It will be removed once the
new way, described above, has proved itself to be stable.

This method uses either "tmake" or "qmake" to actually generate the required
Makefiles.  "qmake" is provided with Qt v3.x.  If you are using an earlier
version of Qt then you will need a copy of "tmake" (v1.8 or later) which is
available from Trolltech (http://www.trolltech.com).  You will need to
configure "tmake" for your system by setting the TMAKEPATH environment variable
to an appropriate value - see the "tmake" documentation for the details.

First of all, run the `build.py' Python script.  If you have multiple versions
of Python installed then make sure you use the interpreter for which you wish
to build the bindings for.  The build script generates the C++ code appropriate
for your system and all the relevant makefiles.  The script takes a number of
options that allows you to override particular settings.  Run
"python build.py -h" to get a list of the available options.

Compiling and installing PyQt is then a simple case of running "make" followed
by "make install".  Note that on a system where you would normally only need
administrator privileges to install PyQt, you also need them to compile PyQt.

Note that if you built SIP using "the old way", you must also build PyQt using
"the old way".


THE REST OF THE DISTRIBUTION

The "examples2" and "examples3" directories contain some examples (for Qt v2.x
and Qt v3.x respectively) of Python scripts, including versions of the standard
Qt tutorials and examples.

The "doc" directory contains SGML and HTML documentation for the bindings.
This documentation includes a section describing the differences visible to
the Python programmer between this and the previous version - please read it.

The "eric" directory contains a Python debugger called "eric" written using
PyQt.  eric is maintained by Detlev Offenbach.

The "sip" directory contains the .sip files that the "sip" executable generates
the C++ code from.  If you are creating bindings for another module that
sub-classes from any of the Qt classes (eg. PyKDE) then these files will be
needed by that module's build process.


Phil Thompson
phil@riverbankcomputing.co.uk
