========================================================================
EMchat is now written entirely in emacs-lisp, so theoretically it should
run on anything that can run (S)XEmacs and can connect to the ICQ servers.

You will need at least XEmacs 21.4 or any version of SXEmacs.
========================================================================

This installation is definitely a 'no-brainer'

1) Check the Makefile, and edit anything as required.

   On Windows, you must have set your HOME variable (e.g. on Windows 98
   in your autoexec.bat, add 'set HOME=C:\' before installation. You
   should have set HOME for Cygwin anyway). Reboot if necessary before
   installing EMchat!

   For Cygwin, search for '# Cygwin #' in the Makefile and to see what
   you need to change to build on Cygwin.

   For Solaris, search for '# Solaris #' in the Makefile to see what
   you need to change to build on Solaris.

2) 'make'

3) become 'root' and then 'make install'. On Windows just type
   'make install'

Hold it, you're not finished yet...

Add the following to your `user-init-file' (XEmacs -- ~/.xemacs/init.el
                                            SXEmacs -- ~/.sxemacs/init.el)
---------- cut ----------

(require 'emchat)
(setq emchat-user-alias "me")


---------- cut ----------

As the user that will be using EMchat, fire up (S)XEmacs and...

M-x emchat-setup RET

That will set up the needed stuff in your home directory.

Adding your own UIN:
-------------------
~/.emchat/world is the file that stores not only the UIN's of your
friends but also your own UIN.

Just edit ~/.emchat/world and change the UIN beside 'me' to reflect your
own UIN.

Of course you can change the alias ('me') of your own UIN to be whatever
you want.  But you'll have to change the (setq emchat-user-alias "...") 
line in your `user-init-file' to match.


Ok, now you're done.

'M-x emchat-login'.  There you go! 

Don't hesitate to message me a success report or mail me your
screenshots!


Example world file:
------------------
Literally you can put anything you like in this resource file, such as
this introduction.  EMchat will only consider a line to be a valid buddy
if...

    -- `:icq' starts at column zero (there's no leading whitespace or
       characters).

    -- There is one space between `:icq' and a UIN.

    -- There is one space between a UIN and a buddy name.

    -- The buddy name does NOT contain any colon `:' characters.
       Buddy names can contain whitespace anywhere except as the
       first character.

    -- There is one space between the buddy name and any group names.
       Group names begin with a colon `:'.

So, for example...

:icq 34307457 emchat
:icq 12345678 me
:icq 88888888 the queen :royalty

This way, it defines three buddies: \"emchat\", \"me\", and \"the
queen\". It reads alias name until the end of the line, or until the
first group name.  In that example, the buddy \"the queen\" is in
the group `:royalty'.

Adding your own UIN:

Just change \"12345678 me\" above to your UIN/alias.  And don't
forget to change the (setq emchat-user-alias \"me\") line in your
`user-init-file' to match.

BTW, that 1st buddy up there, 34307457 emchat, is a valid UIN, it's
mine. :-)

Remember to M-x emchat-world-update after changing this rc file.