INSTALLATION
============

To install LPU, proceed as follows:

 -  un-zip and un-tar the supplied distribution file under a
    directory of your choice. This will create a subdirectory
    'lpu-VERSION', where 'VERSION' will be replaced by the actual
    version of the distribution.

    Example:

        gunzip lpu-0.9-24.tar.gz
        tar xvf lpu-0.9-24.tar

    will create a subdirectory 'lpu-0.9-24' within the current
    directory. This will be called 'LPU base directory' within
    this file.

 -  change to subdirectory 'src' of the LPU base directory.

 -  in 'Makefile', set the value of symbol 'BINDIR' to an appropriate
    location. The selected directory should be in your PATH, or in
    the PATH of all users which will use LPU. IMHO /usr/local/bin is
    an appropriate place for it in a UNIX environment. 

 -  make
    this should compile without errors or warnings.

 -  make install
    this will copy the image 'lpu' and the shell script 'lpu.sh' to the
    desired location.
    Possibly, you need root permission to perform this step.

After that, you should have a look at the examples in subdirectory
'demo', the manual (in 'doc/de' for German and 'doc/en' for English),
and the README files in these directories.

If you want to create your own examples outside of the subdirectory
'demo', you should create a directory $HOME/.lpu, and copy the files
lpu.dev, lpu.tab, and possibly lpu.par from demo/ into that directory.

