Preliminary * Preliminary * Preliminary * Preliminary * Preliminary



Installation Notes
==================



0. Remarks
----------
Korigin is pre-alpha code. The limitations going along with that are
affecting the installation procedure, too. The current installation is
*NOT* KDE compliant. This will change later.

BTW, Korigin will *not* compile with EGCS 1.0. Actually, it will not
*link* with EGCS due to missing type_info fields. We did not try GNU
C++ 2.8.0, so we assume it does *not* work. You need GNU C++ 2.7.2.x


1. Get the Latest Version
-------------------------
The latest version of Korigin can be obtained from:

   http://ap-dec717c.physik.uni-karlsruhe.de/~korigin/


2. Unpacking the Files
----------------------
Un-tar the Korigin sources. Type:

   $ tar xvvzf korigin-XXXXXX.tgz

where XXXXXX is the release date. This will produce a directory ./korigin/
with subdirectories. Change to the ./korigin/ directory.


3. Editing the Makefile
-----------------------
Edit the file ./mk.korigin in the ./korigin/ directory. This file contains
system-dependent settings, such as linker paths, and, above all, the
directory which contains korigin. This must be set to the directory where
the mk.korigin file is located.

You can also configure which modules you want to use. The rules for the
module configuartion are quite simple: each entry corresponds to the
equally named subdirectory in the ./modules/ tree. This allows you to
have a module in several versions on your disk - just edit the MODULES=
section to pick the right one.

Only modules mentioned in the MODULES= section will be linked.


4. Compile Korigin
------------------
Now that the Makefiles are configured for your system, you can compile
Korigin:

   $ make

This will (or will not) produce an executable "korigin" in the current
directory. Note that Korigin is not yet capable of the standard KDE
installation routine, so the target "install" is not yet available.
You should leave the executable where it is.

   $ (cd doc; make; cd ..)

builds the documentation, currently only for the base library.


5. Install Icons etc.
---------------------
You have to install the icons into /opt/kde/share/apps/korigin/pics/ as
well as the skeleton of the online manual by launching:

   $ make install

This will also copy koriginrc to ~/.kde/config/koriginrc.


(C) 1997, 98 Hfner and Schemitz.
