Installation
************

Packages
========

   Cthugha-L is split into 3 packages:

`cthugha-L-1.1.src.tgz'
     This package holds only the source. You have to compile everything
     yourself.

`cthugha-L-1.1.bin.tgz'
     This package also holds the precompiled binaries and the
     documentation as postscript file.  The precompiled binaries are
     compiled with gcc-2.7.2.1 for ELF.

`cthugha-L-1.1.xtr.tgz'
     The extra package contains a lot of palettes, translation tables
     and pcx-files.

Configure
=========

   Before compiling Cthugha-L you might want to specify some setting in
the file `configure'. You should not change any of the `Makefile's.

   You should set, where to install Cthugha to, and set the places where
Cthugha searches for header files and libraries.

   If you want to compile Cthugha-L for a non-Linux system you can use
the `USE_' options in that file. You propably have to turn off most
things.

Make
====

   After you have set everything in the file `configure' you can run
`make' to really generate the programs, the documentation and the
translation tables (1).

   You can already now try out Cthugha. Try running Cthugha with the
option `-E ./extra', so that Cthugha can find the translation tables.

   ---------- Footnotes ----------

   (1) Since version 1.0 Cthugha generates the translation tables when
it is starting. But some translation tables are so complex, that that
method would take too much time, so they are generated the old fashion
way.

Install
=======

   If Cthugha compiled successfully you can run `make install'.  This
copies all the files to the right places (as specified in `configure').
You should do that as root. `make install' tries to set all the
necessary file rights.

Uninstall
=========

   If you want to get rid of Cthugha (I don't know why that could
happen) you can remove it by running `make uninstall'.  The entry in
the file `/usr/info/dir' is not removed automatically.

Problems you might have
=======================

*The compiler complains about missing header files.*
     Check the settings in `configure'.

     If the missing file is `ncurses.h', but you have a header file
     named `curses.h' than that file will be good enough.

*gcc can not find some libraries.*
     Check if the paths in `configure' are set correctly.

     A problem (I have it sometimes) with shared libraries is, that you
     don't have the "library without version number".  For example if
     you have `libXaw.so.6' and *no* `libXaw.so' you should add a link
     with
                    ln -s libXaw.so.6 libXaw.so

     You should add such links for all your shared libraries.

*gcc still can not find some libraries.*
     Check if you have installed `svgalib' and a new version of
     XFree86. `xcthugha' needs XFree86 3.2 (or newer) for all the
     features to work. For older versions you have to disable some
     things, especially the DGA and screen saver support.

