IceMC-0.2 - INSTALL (2002/11/26)

---------------------------------------------
 I N S T A L L
---------------------------------------------

The source is compatible to Qt 3.0.0 but should also compile with earlier
versions.

Installing IceMC is (hopefully) easy:
1. unzip, untar and change into the iceMC directory.
2. (optional) modify Makefile to your needs
3. Then just type:

'./make' and
'./make install' (you must be root for this => copys iceMC to /usr/local/bin/)

That's it! PLEASE report problems and bugs.

---------------------------------------------
 U N I N S T A L L
---------------------------------------------

type './make uninstall'
or
delete the iceMC binary manually
(e.g. rm /usr/local/bin/iceMC)

---------------------------------------------
 P R O B L E M S ?
---------------------------------------------

1. qt version compatibility:

The source is compatible to Qt 3.0.0 but should also compile with earlier
versions (Qt 2.3.1 should work). If you can't compile this version try
IceMC-0.1-beta (it compiles with 2.1.1 and functionality is more or less the
same).

2. make problems:

(a) Have a look at your environment variables: QTDIR should point to your qt directory and the shared libraries should be in your linkers search path (or set LD_LIBRARY_PATH to your qts lib/ directory). A few examples (for bash):

export QTDIR=/usr/lib/qt
export CPLUS_INCLUDE_PATH=$QTDIR/include:$CPLUS_INCLUDE_PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH

(b) if you have linking problems (like "... cannot fint -lqt") the most obvious reason could be that your linker doesn't find the qt libraries (files named like libqt.so). You can adjust the variable LFLAGS in the makefile and make the linker look in the specified directory (e.g. LFLAGS = -L/usr/qt/3/lib) or try to set LD_LIBRARY_PATH (see above).

(c) if you have tmake installed (get it at www.troll.no) you can create your own Makefile with 'tmake icemc.pro -o Makefile'.

(d)You might also check if the right moc version is used (should be in $QTDIR/bin but could easily be somewhere else => try 'which moc'). Also be sure that the right version of moc is used, if you installed a newer qt version by yourself. You can correct the MOC variable in the Makefile to point to the right location.

3. segfault when starting up

Got a bug report that icemc segfaults with a special qt version, when linked against libqt. Change libqt to libqt-mt (multithreaded library) in the Makefile if you encounter this problem. (didn't verify this information)

If you still have problems have a look at the more detailed homepage:

http://www.mittendorfer.com/gm/comp/icemc/icemc.htm
or email me: georg@mittendorfer.com
