Installation instructions
==================

Note: The installation is a pain right now!

This patch is ALPHA quality and may cause you problems - you have been 
warned. Only proceed if you comfortable with compiling things from
source.

1. Download and install plptools, the version I'm unsing is 0.3, but
there may be a later one.

2. You need to install the header files for plp, right now the
location is hard coded in Makefile.am as /usr/local/include/plp so
unless you have autoconf, automake etc. you will need to put them
there. The shared library libplp should be in /usr/local/bin.

3. Get a kdebase source distribution and extract it somewhere. Note
that I've tested this patch with the 1.1.2 pre-release, but you can also
make it work with 1.1 sources by changing the #ifdef in psion.cpp.

You now have all you need, you just need to apply the patch!

4. If you are running the 1.1.2pre release from ftp.kde.org then you can
just copy all of the files in the kfm subdirectory into the kdebase source
tree like this:

rich@kde$ cd kpsion-0.1
rich@kde$ cp -R kfm /usr/src/kde-1.1.2pre/kdebase/kfm

If you are not running 1.1.2pre then you need to apply the .diff files
to the kdebase source files using patch (Try out 'man patch' if you
don't know how).

5. Run the kdebase configure script

6. cd to the kfm directory and run 'make'

7. If step 6 compiled ok then 'make install'

8. Logout then login (or restart kfm by some other means)

In order for the patch to work you must be running the ncpd from
plptools. The easiest way to do this is to create a new kdelnk in the
Autostart folder on your desktop that runs the demon when you start
KDE.

Files changed
=============

kdebase/kfm/kioslave/psion.h		Added
kdebase/kfm/kioslave/psion.cpp	Added
kdebase/kfm/kioslave/manage.cpp	Patched
kdebase/kfm/kioserver.cpp		Patched

Bugs
====

- libplp does not preserve the const-ness of its const char * which
will break in a BIG way with Qt 2.0 because of unicode QStrings.
- Does not work with KDE 2.0
- Probably lots more!
