server in order to command it and display its status. The interaction
between the client and server is carried out using a well-defined
protocol, making it fairly easy to write new clients for specialized
-tasks.
+tasks. It is worthy of note that the default configuration file
+disables running clients over the network, for convenience of
+setup. See the INSTALL file for details and instructions on how to
+enabled networked clients.
To make it easier to write new clients, a C library has been written
to make common functions easier, such as connecting, authenticating,
sending requests and parsing the responses. The C library also has a
wrapper module for GNU Guile, so that clients can be written in
-Scheme.
+Scheme. As of 0.3, there is also a Python module available seperately.
None of these are documented (yet), but there are a number of examples
scattered around the source tree, so it should not be awfully hard to
Clients
-So far, the following clients are distributet along with the source
+So far, the following clients are distributed along with the source
tree:
* A Gtk2 based GUI, which loosely resembles a normal Direct Connect
* A GNOME panel applet for showing the status of current downloads in
progress.
* A Gaim chat plugin for chatting in hubs and writing private
- messages.
+ messages (only for Gaim 2.0.0 and above).
* A command-line automatic downloader written in Scheme.
* A chat logger written in Scheme.
+ * A hub manager written in Scheme.
-The GNOME applet and Gaim plugin are somewhat experimental. The applet
-seems to be working well, but the installation have some quirks (since
-GNOME does not normally look in /usr/local, care must be taken with
-the installation prefix). The Gaim plugin has some performance issues
-and seems to be leaking some memory. The performance problems lie in
-Gaim itself, however, and the Gaim developers have indicated that they
-will be fixed in Gaim 2.0.0.
+The GNOME applet and Gaim plugin are somewhat experimental. Both work
+fairly well, but they do require special care during installation,
+since neither GNOME nor Gaim usually look for applets/plugins in the
+directories where Dolda Connect gets installed by default. See the
+files doc/INSTALL.applet and doc/INSTALL.gaim for further details.
Installation
-See the INSTALL file.
+See the doc/INSTALL file.
+
+ Documentation
+
+Documentation is still rather weak, but it is getting better. Besides
+the README and INSTALL* files, there are now manpages for the daemon
+and its config file. For any information still not found, please do
+not hesitate to contact the author.
Credits
-This documented was last updated 2006-06-24, reflecting release 0.1 of
+This document was last updated 2007-05-02, reflecting release 0.4 of
Dolda Connect.