This readme file contains instructions on compiling the programs located in
single.zip, stepwise.zip and dls.zip. You may not have all these packages
but the instructions are the same for all. The compiler is expected to be
gcc.

I assume you are using some variant of UNIX. For some DOS_compiler, there may
be problems with end-of-line character(s) used etc. dos2unix and unix2dos may
be helpful in that case. This may also occur if individual files are moved
between UNIX and DOS/Windows system, as e.g. ftp may change the end-of-line
characters.


INSTALLING THE PACKAGES

You need Modules-package and the addons.zip. Unpack them and make note of
the location where you unpacked them. The directory will be needed later.
These packages do not contain any programs, only code that is shared by
the programs in other packages.

single.zip contains algorithms and programs that work with fixed number of
clusters. Even if you don't need the programs themselves, the algorithms
are used elsewhere and therefore you need this package.

Unzip single.zip. This creates directory "single". cd into it and edit the
Makefile. The first two lines contain paths to both Modules and AddOns.
Check that these are correct (the default is that all directories are under
same directory).

For dls.zip and stepwise.zip the procedure is the same, except they have
a path for single-directory created when unzipping the single.zip.


COMPILING THE PROGRAMS

To compile a specific program, use command

    make programname

The list of programs is in the beginning of each makefile in variable TGTS.

To compile all programs in specific package, "make" is enough. To remove
object files and executables, use "make clean". To install the executables
into $(HOME)/bin/ use "make install".

To compile, install and clean the object-files, use

    make install && make clean