Preconditions
=======================

ABACUS is implemented in CWEB[1] a Literate Programming system by
D. Knuth and S.Levy. To compile the library the C++ source code has to
be extracted from the CWEB files. You need the programms ctangle and
cweave to produce source code and documentation. Both programms can be
obtained from ftp://labrea.stanford.edu/pub/cweb/cweb.tar.gz .

Compile CWEB for your System and put ctangle and cweave in a location
that is part of your PATH variable. 


Compiling
========================

After extracting the tar-file containing the ABACUS source code enter
the directory abacus-2.4-alpha/Make-settings. It contains a couple of
files with settings for different systems. Edit a file of your choice
or create a new one and change the values of the variables defined in
the file.

Here is an example: 


>>>-------------------- BEGIN -------------------------<<<

CCC   = g++            # your compiler
STRIP = strip -x       # the strip programm

# $(ARCHTECT) identifies the architecture and the operating system  
# Possible values are, e.g. :
# linux20-gcc29, linux20-gcc33, solaris-gcc29, solaris-gcc33
#
ARCHTECT = linux20-gcc29


#  your system. Possible values are -DABACUS_SYS_LINUX and
#  -DABACUS_SYS_SOLARIS
CCFLAG_SYS      = -DABACUS_SYS_LINUX 

#  DO NOT CHANGE ANYTHING BELOW
###################################
CCFLAG_COMPILER = -DABACUS_COMPILER_GCC29  -Wall
CCFLAG_DEBOPT   = -O3
CCFLAG_PARALLEL = 

# Do not blow up the object files with multiple template
# instantiations of the same function.
#CCFLAG_TEMPLATE = -fno-implicit-templates -DABACUS_TEMPLATES_EXPLICIT -IETI
CPLEXFLAGS      = -DCPX_PROTOTYPE_ANSI -DPROTOTYPE_MAX

>>>--------------------  END  -------------------------<<<


Go to the base directory of the ABACUS distribution execute the
following commands where <file> should be replaced by the name of the
file you edited before:

   make depened ABACUS_MAKE_SETTINGS=<file>
   make lib-all ABACUS_MAKE_SETTINGS=<file>

Here is an example : 

   make depened ABACUS_MAKE_SETTINGS=linux20-gcc29
   make lib-all ABACUS_MAKE_SETTINGS=linux20-gcc29

After compiling ABACUS the source directory contains a directory
abacus-2.4-alpha with the ABACUS library and the include files.


References
===========================
[1] http://www-cs-faculty.stanford.edu/~knuth/cweb.html