DARXITE INSTALLATION FOR RELEASE 0.4
====================================

The installation process is reasonably simple, but there are a couple of
things to watch out for. See the README file if you want to know what the
requirements are for running Darxite.

The Darxite system relies on a library, libdarxite, that you can build
statically or dynamically. The advantage of building a atatic library is
that you don't have yet another library cluttering up /usr/lib and you don't
need to have super-user privileges; the disadvantage is that it takes up
slightly more space and is slightly less efficient.

The first thing you need to do is, in the Darxite root directory, type
"./configure". This will attempt to guess a few things about your system and
build the right clients etc. for it. You can pass it the following options:
  --with-gnome         : try to build the GNOME client if possible
  --with-gtk           : try to build the GTK clients if possible
  --without-gnome      : don't build the GNOME clients
  --without-gtk        : don't build the GTK clients
  --with-single-thread : build the daemon as a single-threaded app
  --with-shared-lib    : build libdarxite as a shared library
  --with-debug         : disable optimisations and include debug symbols
  --prefix=<dir>       : install the executables in <prefix>/bin
Note that if you build the daemon as a single-threaded application, the
performance will not be as good as if it were multithreaded.

Instructions should now appear to tell you what to do. Eventually, once
you've typed "make", the following executables should appear:

  * daemon/darxite
  * clients/cmdline/dxftp
  * clients/gnome/control/darxite-control
  * clients/gnome/monitor_applet/darxite-monitor_applet
  * clients/gtk/dsgtk
  * clients/gtk/dxpref
  * clients/gtk/dxclip
  * clients/gtk/noctftp/noctftp
  * clients/util/darxcmd
  * clients/util/darxget
  * clients/util/darxput
  * clients/util/darxstat

To install these, type "make install" in the root of the Darxite tree.
You'll (by default) need super-user privileges to do this, because it puts
all the executables in the /usr/bin directory (by default). Now you've
installed everything, read the file "USAGE" to find out how to use it all.

PROBLEMS
--------

If the configure script doesn't guess your system correctly and you get
errors on typing "make", see the section above on options you can pass to it.

If you have any kind of problem with Darxite, then e-mail me at
<hell@ukgateway.net>. Bug reports are very gratefully accepted.
