LICQ v1.2.6

An ICQ clone written in C and C++ using a plugin system to allow for
many possible interfaces.
See the webpage (http://www.licq.org) for more information.
Licq implements messages (online and offline), urls, chat, full file
transfer, gui configuration (with the qt-gui plugin), history as
well as a number of other features.


LICENSE

This program is licensed under the terms of the GNU GPL, a copy
of which you should have received with this package.


INSTALLATION:

(If you have a binary distribution then see the FAQ for how to
 do a manual install.  Don't worry it's very easy, any monkey
 could do it.)

As root:
1. Type './configure' and it will determine all the right settings and
   directories for your system.
2. Type 'make' and in theory it will build. If you are using a non-GNU system,
   such as FreeBSD or Solaris, you will need the GNU version of make, often
   installed as `gmake'.  If you get errors about "void *" see the FAQ.
3. Type 'make install' and licq will be installed (defaults to
   /usr/local).
4. Go to plugins/qt-gui and follow the directions there (doc/README) to install
   the Qt interface plugin (necessary).

As each user:
5. When you run licq for the first time it will install all the necessary
   files in ~/.licq.
6. You can import users from a number of other clients into Licq using
   one of the conversion scripts found on the download section of the web
   page or in the licq-data package.

Licq requires the following:
Some C++ compiler with proper standard c++ headers.

SOCKS5 Proxy Support:
Licq supports SOCKS5 proxies.  To enable this support, run configure with
--enable-socks5, and optionally --with-socks5-inc=PATH and
--with-socks5-lib=PATH.  Then just make sure all the right environment
variables are set and it should work.  Also read the SOCKS.HOWTO file.

Licq has been compiled and run successfully on the following systems at one
point (note current versions may no longer compile without a bit of tweaking):
Linux/x86
Linux/Alpha
Linux/PPC
FreeBSD/i386
AIX/RS6000
NetBSD/mk68000
Sun3/mk68000
Solaris/x86
Unixware
Solaris/sparc

CONFIGURATION:

Configuration is done through the ~/.licq/licq.conf file, which contains .ini
style options.  Help on each option is include in the file.  The contact
list is stored in conf/users.conf.  Each users info is stored as a simple
text file called {user uin}.uin.  Again, the options are pretty obvious.
You can add/remove/edit a user inside the gui, or by editing the conf files.

The History file is the file where the user history is stored...you can
specify a filename for each user, or you can put one of the following
keywords:
none : no history file
default : makes the history file history/<uin>.history


USE:

Type licq -h for commandline help.

Using licq is fairly straight-forward.  Licq itself is merely a daemon
designed to run various plugin interfaces.  I have written an advanted
gui in qt (qt-gui) which should be used as the default plugin.  Once you
have compiled and installed Licq, unpack the plugins you wish to use into
the plugins/ directory, compile them, and then install them into
/usr/local/share/licq/plugins (replace /usr/local with the prefix given
to configure if necessary).  Then start licq with the -p option:
$ licq -p qt-gui -- ...any options to the plugin...

Note the -- which tells the system to pass any options after that on to the
first plugin in the list.  Multiple plugins can be chained in this way:
$ licq -p qt-gui -p email-forward -- <qt-gui options> -- <email-forward options>


PROBLEMS:

See the BUGS file for reports on known bugs and problems.


TROUBLE-SHOOTING:

1. RUNNING
o  Segfault at startup.  If this occurs, run licq with the -d 15 switch and tell
   me how far it gets before segfaulting and I'll try and help.

Good luck.


CONTACTS:

Send any questions, comments, or other complaints to
licq-devel@lists.sourceforge.net.
