This set of files will build all supported PyKDE versions.

************
REQUIREMENTS
************

This version requires that you have installed and accessible:

One of Python 1.5.2, 1.6, 2.0, 2.1 or 2.2
sip-3.3.2 (other versions will not work)
PyQt-3.3.2 (other versions will not work)
Qt 2.3.x (for KDE 2.x.x) or Qt 3.0.x (for KDE 3.0.0 and later)
One of the following KDE versions: 2.1.1, 2.1.2, 2.2.0, 2.2.1, 2.2.2, 3.0.0, 3.0.1, 3.0.2

KDE3.0beta2 is not supported.

************
INSTALLATION
************

1. Unpack this tar file to a directory. The rest of this procedure
will assume /usr/local, but you can install it anywhere

2. Make /usr/local/PyKDE-3.3.2 the working directory:

        cd /usr/local/PyKDE-3.3.2

3. Run build.py with the version of python you want PyKDE to work
with, normally:

        python build.py [options]

The '-c' option will reduce compile time by up to 80% but requires
a large amount of RAM/swap space. Other options will allow you to
specify directories for various include, library, or PyQt sip files.
Run:

        python build.py -h

for a list of options.

***                                                            ***
*** Normally you will want to use the following command lines: ***
***                                                            ***
***   for KDE2:  python build.py -lqt -c                       ***
***   for KDE3:  python build.py -lqt-mt -c                    ***
***                                                            ***

If only a small amount of memory is available, you can omit the
-c switch, but compilation will take much longer. Typical
compilation times (varies with machine speed and memory) are:

      with -c:  6 to 20 minutes
      no -c:    50 to 90 minutes or longer

By default, build.py expects that the QTDIR and KDEDIR (and
TMAKEPATH for Qt2) environment variables are set correctly.
You can set the environment variables with, for example:

      export KDEDIR=/opt/kde3


For setups which require a large number of option flags to
specify the correct directories for building, the option
flags can be placed in a text file (one option with parameter
per line) and build.py run with a single -z switch specifying
the name of the text file that holds the option flags. (See
the sample 'buildrc' file):

     python build.py -z buildrc




4. (as root) Run make

5. (as root) Run make install


**************************
REBUILDING A SINGLE MODULE
**************************

If you need to rebuild a single module, for example kdecore, in the
top level directory (/usr/local/PyKDE-3.3.2 or wherever you have it installed),
do:

        python rebuild.py [options] <module name>

where 'module name' is the same as the subdirectory name for the module
in PyKDE, and 'options' is the same set of options you used when running
build.py. For example:

        python rebuild.py -c -lqt-mt kdecore
or
        python rebuild.py -c -lqt-mt kspell
or
        python rebuild.py -z buildrc kdeui

Then re-run make and make install. It is not normally necessary to
run build.py again (it will rebuild all modules), however you
can't use 'rebuild' until build.py has been run successfully
at least once.

**********
KNOWN BUGS
**********

The example program pyParts.py will not work correctly on KDE version
3.0.0 or greater. This appears to be due to problems with the KView
part being embedded (if used as an embedded viewer in konqueror, the
same problems occur). This program should run correctly under KDE2;
the example program pyKHTMLPart.py uses essentially the same PyKDE
code as pyParts.py and should work correctly.
