Installation from CVS
---------------------

$ cd kdebluetooth
$ make -f Makefile.cvs
$ ./configure --prefix=/usr
$ make
$ make install
$ kdekillall kded; kded (or restart kde)

Apart from the more obvicious stuff you'll also need
Qt3.2, openobex 1.0.0 and artsc. Qt 3.1 might work too with 
some smaller changes.

If you're using debian sid, I strongly recommend building
a debian package instead of installing it manually:
$ cd kdebluetooth
$ make -f Makfile.cvs
$ debuild --rootcmd=fakeroot binary

This will save you a lot of pain when you update to a
newer version eventually.

If you don't want to compile some application - kbtserialchat
and bemused for instance - then use the following 
configure line:
$ DO_NOT_COMPILE="kbtserialchat bemused" ./configure (etc.)


Compilation errors
------------------

Error message:
uic: File generated with too recent version of Qt Designer (3.2 vs. 3.xx)

When using Qt Designer 3.2 to change a ui file, it will change the version
of that file to 3.2. Simply changing the version back to 3.1 seems to
work well though. You can do this manually or simply run 
./downgrade_ui
in the base directory of kdebluetooth.


Troubleshooting
---------------

If something's not working, please check first
if bluez itself is installed correctly:

Inquiry for other discoverable devices:
 $ hcitool inq
 Inquiring ...
         00:60:57:5C:E6:BD       clock offset: 0x0f0e    class: 0x500204

Browse services of other device
 $ sdptool browse 00:60:57:5C:E6:BD
 Browsing 00:60:57:5C:E6:BD ...
 Service Name: Fax
 Service RecHandle: 0x10000
 Service Class ID List:
 ...

Browse your own services:
 $ sdptool browse FF:FF:FF:00:00:00
 Browsing FF:FF:FF:00:00:00 ...
 Service Name: SDP Server
 Service Description: Bluetooth service discovery server
 ...

Now let's take a look at the kdebluetooth tool.

kio_sdp:
Open konqueror and type "sdp:/". After about ten
seconds it should display some other discoerable
bluetooth devices, but at least there should appear
an "local system" entry. Clicking on one of the
icons should list the services offered by it.
As a shortcut there should be a bluetooth icon
in konqueror's services sidebar.

kbluetoothd:
This daemon will start other server application
when someone connects to your computer, similar to
inetd. kbluetoothd doesn't run as a daemon itself,
but as a plugin of the kded daemon.
kbluetoothd will be loaded when kded is restarted.
So restart KDE or just kill and restart kded (killall 
kded; kded).
Check if kbluetoothd was loaded:
 $ dcop kded 
 mountwatcher
 kbluetoothd  <==
 kssld
 kpasswdserver
 favicons

Check if kbluetoothd registered all services:
 $ dcop kded kbluetoothd services
 kbemusedsrv
 kbtobexsrv
 kbthandsfree
 kbtserialchat

There should also be a new control center module under 
Network/Bluetooth where you can enable/disable these 
services and see which port was assigned to them.

Now try to send a file to your computer with a mobile
phone or PDA. kbtobexsrv should pop up and display
the received files now.