GtkICQ is a program based on Mirabilis' ICQ protocol, and designed for use
with the Gtk+ widget library.  It is meant to be a high speed, high quality
alternative for Mirabilis' Java client (Mirabilis' only attempt at a Linux
client).  Though GtkICQ is quite stable at this time, it is still
development software, and most certainly contains bugs.

If you have a bug to report, or are unable to get GtkICQ working, feel free
to email the author (jwise@pathwaynet.com).  As of now, there is no mailing
list for GtkICQ (hint, hint), so replies may be delayed.

Also, if you're interested in helping with the GtkICQ project, send an email
to jwise@pathwaynet.com.  There is a large need for someone who can fix up
the autoconf/automake files.

REQUIREMENTS:
-------------
* Gtk+, Gdk v1.1.2 or above
* Glib v1.1.3 or above
* X11R5 (or above) and libraries
* Linux kernel 2.0.x or greater
* Perl 5 (for running convertrc.pl script)
* Gnome v0.20 or above (for gnome support)

Following are the installation instructions for two different setups (the
titles should be self-explanatory).  If you use Gnome, the Gnome support
contains a number of features which aren't offered in the "no-gnome"
version (e.g. Gnome applet, hotkeys for menu options, etc).

NOTE: There was a new feature introduced in v0.55 which seems to be causing
some trouble.  Auto-away was recently added, but requrires the X screen
saver extensions (/usr/X11R6/lib/libXss.a on RedHat systems).  If you don't
have these libraries, then comment out the -DUSE_XSCREENSAVER line in the
appropriate Makefile.

COMPILING WITH GNOME SUPPORT:
-----------------------------

1. Untar the gtkicq-x.xx.tar.gz
   $ tar zxf gtkicq-x.xx.tar.gz
   This will create a subdirectory, gtkicq-x.xx/

2. cd gtkicq-x.xx/

3. Run './configure'
   This will create the Makefiles and configuration header files required to
   build GtkICQ.  For configuration options, run './configure --help'.
   Again, if anyone could help fix up the configure scripts, any help would
   be appreciated.

4. Run 'make' to compile everything.

5. As root, type 'make install'
   NOTE: Previous versions of GtkICQ have installed libgnome*.so files over
   those already installed.  The support/ directory has now been completely
   removed, and 'make install' will no longer overwrite your libraries.

6. If you've used mICQ, or a very early version of GtkICQ (any of the
   gtkicq-1998xxxx type), then run 'convertrc.pl <file>', where <file> is
   the location of your existing .micqrc (usually ~/.micqrc).  The newer
   versions of GtkICQ use a different type of configuration file.

WITHOUT GNOME SUPPORT:
----------------------

1. Change to the src directory.
   $ cd src/

2. $ cp Makefile.no_gnome Makefile
   Makefile.no_gnome is a pre-prepared Makefile.  Unfortunately, due to lack
   of knowledge of automake, only the Gnome version supports the automatic
   generation of Makefiles.  Please edit this file to suit your setup.

3. Run 'make'

4. As root, run 'make install'
   NOTE: Previous versions of GtkICQ have installed libgnome*.so files over
   those already installed.  The support/ directory has now been completely
   removed, and 'make install' will no longer overwrite your libraries.

5. If you've used mICQ, or a very early version of GtkICQ (any of the
   gtkicq-1998xxxx type), then run 'convertrc.pl <file>', where <file> is
   the location of your existing .micqrc (usually ~/.micqrc).  The newer
   versions of GtkICQ use a different type of configuration file.

-----------------------------------------------------------------------------

Everything should be set up and ready to run.  If you have any problems,
feel free to contact Jeremy Wise <jwise@pathwaynet.com> for further
assistance.  Bug reports, feature requests, hints and patches may also be
sent to the above address.  Flames to /dev/null.
