Szymon Stefanek Sat Dec 18 1999 ############################################################################### Installation instructions for the KVIrc IRC client. ############################################################################### # 1. Quick install ############################################################################### Steps for a quick installation ./configure make kvirc make install If something goes wrong , continue reading. ############################################################################### # 2. Step-by-step guide to the installation of this KVIrc release ############################################################################### ------------------------------------------------------------------------------- Step 1: CHECKING REQUIRED LIBRARIES (Required) ------------------------------------------------------------------------------- -Qt library in a version >= 2.0 First check if it is installed on your system: # find / -name libqt* The output should be something as: /usr/local/qt/lib/libqt.so.2.0.0 /usr/local/qt/lib/libqt.so /usr/local/qt/lib/libqt.so.2 /usr/local/qt/lib/libqt.so.2.0 If there is no output at all , or the version number is lower than 2.0.0 you must install Qt. Some newest distributions have the binary package of this library ; if you install it in this way be sure to install also the *devel* version of the package (the include files). If you don't have the binary package grab the library from ftp://ftp.troll.no/ and follow the instructions provided with it for the installation. More informations on the Qt library can be found on http://www.troll.no/ ------------------------------------------------------------------------------- Step 2: OTHER STUFF TO CHECK (Optional) ------------------------------------------------------------------------------- -A decent pthread implementation # find / -name pthread.h /usr/include/pthread.h On most systems it is provided by the pthread library: # find / -name libpthread* /usr/lib/libpthread.a /usr/lib/libpthread.so /usr/lib/libpthread_p.a Some other systems provide wrappers for other implementations. Most glibc2 based distributions provide the pthread package. The sources can be also found on your favorite gnu ftp mirror. -Thread safe X Libraries All glibc2 based distributions have it, so it should not be a problem. If your system is libc5 based (such as Slackware 4 AFAIK) You MUST upgrade to glibc2 and install the thread safe X Libraries , otherwise you will get unexplainable errors later. -The jpeg library It is not really 'required' , configure will detect it for you. But if it is installed on your system ,KVIrc will use it. ------------------------------------------------------------------------------- Step 3: PREPARING THE COMPILATION (Required) ------------------------------------------------------------------------------- First you must run the configure script. # ./configure If the script executes without errors jump to the step 4 , otherwise continue reading. The most common error here is that the Qt library can not be found. Configure accepts a commandline option that allows you to specify the path to the Qt library: --with-qt-library-dir path to the Qt library --with-qt-include-dir path to the Qt headers --with-qt-moc filename of the Qt meta object compiler --without-qt-check Do not check if Qt and X compile So if the qt library can not be found but you know that it is installed, for example, in "/usr/mylibs/qt" try running ./configure with the following options: --with-qt-library-dir="/usr/mylibs/qt/lib" --with-qt-include-dir="/usr/mylibs/qt/include" --with-qt-moc="/usr/mylibs/qt/bin/moc" ./configure --help will show a list of other available commandline options. If you 're compiling on Solaris you may need to add also: --with-solaris-libs (adds the usual lsocket lnsl....) --with-ignore-sigalarm (workaround for a common threads bug) Note: On an i386 based machine you can use --with-i386-asm to compile assembly versions of some commonly used functions. This will produce a faster executable. WARNING : This option has been actually tested only on i686 and i586 machines. If you experience problems with this option , just recompile without. This option is also known to NOT work with pgcc (still have to guess why). ------------------------------------------------------------------------------- Step 4: BUILDING KVIRC (Required) ------------------------------------------------------------------------------- The rest should be easy... # make kvirc If the compilation finishes without errors (there will be some warnings , just ignore it) you can install KVIrc: # make install KVirc should now be installed in /usr/local/bin The libraries in /usr/local/lib The images, help files and the other stuff in /usr/local/share/kvirc ------------------------------------------------------------------------------- Step 5: RUNNING KVIRC (Optional :) ------------------------------------------------------------------------------- If you already had an older KVIrc installed and want the new config files (sample popups!), delete (or rename) your old local KVIrc directory before first running KVIrc.
# kvirc if KVIrc does not start , and you get something as: kvirc: error in loading shared libraries: libkvicore.so.1: cannot open shared object file: No such file or directory Add /usr/local/lib to your /etc/ld.so.conf and run ldconfig. You may also need to add /usr/local/lib to your LD_LIBRARY_PATH ------------------------------------------------------------------------------- Step 6: HAVE FUN :) ------------------------------------------------------------------------------- NOTE: KVIrc will start a setup program the first time that it is run. You will be asked to choose an EXISTING directory. KVIrc will create a "kvirc-1.0.0" subdirectory inside , and will store there its configuration files. If you had a previous installation of kvirc and want to restore your old aliases, you must move the config file by hand. # mv /yourpath1/kvirc/config/kvi.alias.conf /yourpath2/kvirc-1.0.0/config/kvi.alias.conf where "yourpath1" is the path that you have selected in your previous installation of kvirc , and "yourpath2" is the one that you've selected in THIS installation. The two paths may be eventually the same. ############################################################################### Appendix 1 : ENABLING NON-ENGLISH LANGUAGE ############################################################################### Like most other GNU programs , KVIrc supports localization. Currently only the Italian locale is implemented. KVIrc lookups the current locale setting from the LANG enviroinement variable. For example , to make KVIrc use the Italian translations of all the string contained in the program , the LANG variable must be set to "it" # export LANG="it" now you can run kvirc :) ############################################################################### Appendix 2 : HOW TO KEEP MORE COPIES OF THE QT LIBRARY ############################################################################### COMPILING QT: Once you have the sources , unpack it in a suitable directory for building. WARNING : If you're using OLD applications that depend the OLD Qt library (the entire KDE needs it) , you must keep the OLD (1.4X) version of Qt on your system. Do NOT overwrite the old library or sources with the new ones, or all that applications will stop working. In this case better if the directory is not on your $PATH or $LD_LIBRARY_PATH.. something as /home/myuser/qt or /usr/build/qt will be ok. If you've received the sources via CVS , you already have it in the cvs dir. - I'll assume that you have unpacked your qt snapshot to /usr/build/qt if not , change the directories accordingly. We need to change temporairly QTDIR to build the library Do not change it permanently! Let's go. # cd /usr/build/qt # export QTDIR="/usr/build/qt" # ./configure # make Now have a cup of coffee :) (WARNING : If you do not have tmake properly installed you may notice that the make enters in a recursive loop after building the library...if this happens (you will notice it :) just kill the process by pressinc CTRL+C.... INSTALLING QT: Add the line /usr/build/qt/lib at the end of your /etc/ld.so.conf and run # ldconfig If something goes wrong later , you may need also to add /usr/build/qt/lib to your $LD_LIBRARY_PATH.