MLDONKEY INTEGRATION FOR KDE
============================

This package helps integrate MLDonkey into KDE3. It provides the
following features:

 * A replacement MLDonkey GUI using the KDE framework
 * ED2K link handling in Konqueror
 * Konqueror service menu for adding all links on a web page
 * Control Centre module for configuring MLDonkey and client
   connectivity
 * A panel applet for Kicker that displays MLDonkey status and
   can launch the GUI on demand

The suite has been developed primarily for KDE 3.1, but may also work
with KDE 3.0. This is, however, unsupported and not recommended.


INSTALLATION
============

Untar the kmldonkey source archive, cd into the newly created
directory, and run these commands:

 ./configure --prefix=$(kde-config --prefix)
 make
 make install (as root)

The --prefix argument to configure above should automatically determine the
prefix to your KDE installation. Notice that some distributions (notably
certain versions of Mandrake) keep some KDE directories in non-standard
places which the configure script is unable to detect. You should look for
a binary package for your distribution if you aren't familiar with its KDE
quirks. You can find binary packages at the following address:

   http://savannah.nongnu.org/files/?group=kmldonkey

Once you have successfully compiled and installed the package,
launch the Control Centre and tell KDE how to contact your
MLDonkey (you'll find a new MLDonkey subsection under the Internet
section if it was successfully installed). Then add the applet to your
panel, or just use the standalone application (Internet/KMLDonkey).


TROUBLESHOOTING
===============

If KMLDonkey doesn't appear on your menus or in the Control Centre, or if
the KMLDonkey application appears without toolbars or icons and tends to
crash a lot, this is very likely because it was configured using the wrong
prefix, so the data files needed have ended up somewhere other than where
your KDE expects to find them. This is a common problem with certain
platforms, and if you experience this, you should look for a binary package
for your platform (see the link above). Failing that, double-check the
--prefix argument you pass to ./configure - you should at least find a
directory called share/services under the prefix you specify, containing
*.desktop and *.protocol files. These are data files installed by KDE, and
if you locate these, you know you're on the right track.

Some platforms (some versions of Mandrake linux especially) use non-standard
data directories that the configure script cannot guess at. In this case,
you should ask for vendor support, specifically telling them to stop doing
idiotic things like that (although in the case of Mandrake, I believe
they've corrected the problem in Mandrake 9.1 - you may want to consider
upgrading if you're afflicted by this issue).


INSTALLATION ON MAC OS X
========================

Although OS X isn't an officially supported platform (unless somebody
wants to buy me a Mac; then I'd be happy to ;) ), these notes on
compiling kmldonkey for OS X were contributed by
<josephlandry@yahoo.fr>:

1) Requirements:
OS X, of course
Apple developer tools (available at https://connect.apple.com/, free
subscription needed)

The following packages have to be installed with Fink (a dselect-like 
package manager, http://fink.sf.net/)

- arts-dev
- kdebase3-dev or kdebase3-ssl-dev 
- kdelibs3-dev or kdelibs3-ssl-dev 
- libart2 
- qt3-dev 
- libjpeg 

2) Installation:

- download kmldonkey and extract the archive

- delete the admin directory, download an OS X-ready admin archive from
  http://ranger.befunk.com/fink/ and extract it, replacing the one you
  just deleted, then reconstruct the configure script:

    make -f admin/Makefile.common cvs

- build and install kmldonkey:

    ./configure --prefix=/sw --with-qt-includes=/sw/include/qt \
      --with-qt-libraries=/sw/lib --with-extra-includes=/sw/include \
      --with-extra-libs=/sw/lib
    make
    sudo make install

FYI, /sw is the root folder of packages installed with fink.


COPYRIGHT
=========

This program is copyright (C) 2002, 2003 Petter E. Stokke
                          (C) 2003 Sebastian Sauer

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
