Amiga compile of micq - Revision 6
==================================

This is a rather straightforward compile of micq, done under ADE.  Two 
versions are included: one with ANSI colors, and the other one without.  
ANSI colors will make it unreadable on most systems.  Blame that german 
icon maker who had the wonderful idea of using color 4-7 for a bunch of 
gray shades when the standard ANSI index needs readable colors there, with 
the result that it's impossible to use most ANSI color codes in a CLI.  
Sigh.




Requirements:
-------------
  - ixemul.library (47.2 is available on Aminet in util/libs)
    Run ixprefs to set it to use your TCP/IP stack (AmiTCP/Miami or #?-225)

  - A valid ICQ userID.  micq cannot create a new account (yet)

  - A 68020 or better.  I have no intention of wasting everyone's CPU 
    time by supporting a CPU that is long dead.



How to use it: 
--------------
Just run it from a CLI.  Details are in the original micq README.  Keep 
in mind this probably needs a fairly good stack size, 20 KB should be safe.



Changes
-------

   Rev 3:
   ------
        Re-compiled with the May 12th sources

        To the guy who sent me that fake mail: nice try...
        Mirabilis doesn't have an ADSL account on bellglobal.com.....

   Rev 4:
   ------
        Recompiled with May 13th sources (Rev 3 was really May 12th)

   Rev 5:
   ------
        Recompiled with May 14th sources (customizable commands)


   Rev 6:
   ------
        PLEASE read the FAQ below.  The micq author told me some Amiga 
        users started asking him about Amiga-specific stuff.  Sigh.

        Some of the Amiga-specific stuff has been added to the original 
        sources, so I no longer have to manualy add them with each new 
        version.  Thanks Matt!

        Recompiled with the May 28th sources (search user@host added)

        
QuickFaq [tm]:
--------------

Q: How about a GUI?
A: No.  I don't have time, and I don't want to rewrite the whole code when 
   the original source tree changes every few days.  Beside, I'm sure 
   someone else out there is going to write a full-featured ICQ clone for 
   the Amiga now that some of the packets have been publicly documented by 
   those writing the current UNIX clones.


Q: How about 'feature x'?
A: No.  I am NOT writing micq, I just recompile it for the Amiga.  Email 
   the micq author about micq-related bugs and feature requests, not me.

   [Added in Rev 6]

   Please, do NOT mail him about adding a GUI or about problems with running 
   it with Miami!  He's writing this under UNIX, so he can't help you there.
   Also he's well aware of missing commands, and he's doing what he can
   to add them, so don't ask him to add command "dothis" - just be patient, 
   this is work in progress.

   To sum it up:
   
   Mail me (merlin@thule.no) about problems getting it to run on your Amiga
   Mail Matt about micq-specific bug, like if a given command no longer
      works (Linux Master is him, so please don't pester him online with 
      Amiga-specific stuff).
   Mail your requests for a GUI, new commands and such to the Trashcan :)


Q: What's this "Command: 0028  Seq is 5" stuff?
A: It's simply that micq received a packets it doesn't understand.  Keep 
   in mind that micq is written by people analyzing the protocol since 
   Miserabilis won't release the specs (as if the ICQ protocol was 
   some form of high technology <snicker>), so micq only support a 
   fraction of the protocol.  The author is still working on implementing 
   more, so just be patient - this is really work in progress.

Q: How do I add new users to my contact list?
A: Add them to the .micqrc file created when you first run micq (in the 
   same directory as micq itself), or use the new 'add' command.

Q: Where do I find the latest ixemul stuff?
A: Aminet has v47.2 in util/libs, search for ixemul in that dir.  Get 
   the appropriate library, as well as the ixemul#?-bin archive (for the 
   prefs editor and other tools).

Q: Why gcc+ixemul?  It sucks!
A: See the first FAQ entry.

Q: I cannot get it to run with AS225/Miami/AmiTCP/whatever stack
A: There's a tool called ixprefs that comes in the ixemul-bin archive.
   Run it, and select the appropriate stack in it (note that Miami is the 
   same as AmiTCP there).


Q: I get a totaly wrong date as the datestamp.
A: This is fairly complex...  The short story is: the GMT offset is 
   calculated by ixemul through an env var named TZ and a bunch of 
   config file.  Problem is, the content of the TZ var as wanted by 
   ixemul isn't compatible with the content of the TZ var as wanted by 
   SAS/C...  If you don't care about SAS/C, then get the ixemul-timezone 
   archive, install it, and set TZ to the appropriate timezone.  A solution 
   would be to set a local var only in the CLI from where you run micq - 
   this could be done through a short AmigaDOS script that sets the var 
   and then runs micq, and it would take precedence over the global one.


Q: Is this port legal?
A: To the extent of my knowledge, yes.  There's nothing illegal there in 
   distributing sources or recompiling them, or some group like those 
   hosting rooshell.com would get sued for giving source fragments for 
   icqspoof.c or similar stuff :).  But, this isn't endorsed by Mirabilis 
   either, so they might still be unhappy about it.  Maybe that wouldn't 
   have happened if they kept a more open policy, and understood that 
   running the Java version is NOT always an alternative for the UNIX 
   shell users who need a commandline-version, or for the Amiga users who 
   don't have a working JVM.  So they will have to PROVE how this work is 
   causing them any harm before the people behind it stop their work.


Q: Where can I get the micq sources?
A: ftp://micq.ml.org/ has the latest sources.


Eric (merlin@thule.no)
======================
