Quick guide
-----------

On many systems, configuration, compilation and installing only requires
to issue the following commands:

	./configure
	make
	make install

Everything will be installed under /usr/local in this case.


Complex guide
-------------

The ./configure script is used to guess values for several system-dependent
variables, such as compilers, flags and tools. To select special C flags or
a special compiler, set CFLAGS and CC to the desired valued when invoking
configure. In a bourne-like shell that looks like:

	CC=gcc CFLAGS="-g -Wall" ./configure

Note that variables that contain spaces must be surrounded by " to glue them
together. The default target-directory for this software is /usr/local.
You may specify another choice with the --prefix-flag, as here:

	./configure --prefix=/somewhere/else

There are a lot of other not-so-common flags than can be used with
configure. Enter

	./configure --help

to get a list of them, with a small explanation for each one. The
makefiles contain no data that is of interest for installation. All
relevant variables are stored in config-`uname`/config.dat, which is
in turn created by configure.

When the configuration is finished, call "make" to compile the software.
Note that you have to use GNU make to do this job. GNU make can be
obtained at alpha.gnu.ai.mit.edu, sunsite.unc.edu and any of the
countless mirror-sites of these servers. If there occur any problems
during compilation, please send a bug-report to the address given in
README.

Finally, the binaries and the documentation may be installed using the
"make install" command. The documentation is provided in texinfo-format,
and by default only the info-pages are installed. To create and install
everything in dvi-format (which is highly recommended for hardcopies),
use "make install-dvi".

There are some commands that may be passed to make. "make help", called
in the main directory, will display a complete list of them.
