X-Git-Url: http://git.dolda2000.com/gitweb/?a=blobdiff_plain;f=README;h=171ea3697e966e41bdeaf032481e377765e690e0;hb=bf565de3497d78eeb397ebed7b9bc055724161f9;hp=e69de29bb2d1d6434b8b29ae775ad8c2e48c5391;hpb=d3372da97568d5e1f35fa19787c8ec8af93a0435;p=doldaconnect.git

diff --git a/README b/README
index e69de29..171ea36 100644
--- a/README
+++ b/README
@@ -0,0 +1,76 @@
+			Dolda Connect - README
+
+			     Introduction
+
+Dolda Connect is a  peer-to-peer file sharing program, designed around
+the  Direct Connect  protocol.  It is  written  in a  fashion that  is
+intended  for  flexibility  and  easy  extension.  It  currently  only
+supports  the normal  Direct  Connect protocol,  but  support is  also
+planned  for the  ADC protocol,  and  it can  most likely  be made  to
+support a great deal of other file sharing protocols as well.
+
+			    Extensibility
+
+Dolda Connect is  built around a client-server model,  in the way that
+there  is  a server  (daemon)  program  carrying  out all  the  actual
+file-sharing work, and a number of client programs that connect to the
+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.   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. 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
+figure out  how to  do simple  things. If in  doubt, just  contact the
+author.
+
+			       Clients
+
+So far,  the following clients  are distributed along with  the source
+tree:
+
+ * A Gtk2 based GUI, which loosely resembles a normal Direct Connect
+   client program.
+ * 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 (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 seems  to be  leaking some
+memory.
+
+			     Installation
+
+See the INSTALL file.
+
+			    Documentation
+
+Documentation is still  spotty at best. For any  information not found
+in  the README or  INSTALL files  (or the  source code,  if you  are a
+programmer), contact the author.
+
+			       Credits
+
+Dolda Connect is primarily written  by Fredrik Tolf. He can be reached
+through  the e-mail address  <fredrik@dolda2000.com>. His  homepage is
+<http://www.dolda2000.com/~fredrik/>.
+
+
+
+This documented was last updated 2007-04-11, reflecting release 0.3 of
+Dolda Connect.