T.O.C.
  1. configuring
  2. building
  N. references

1. CONFIGURING

For a local (in-place install) typically all that is needed is
  ./configure \
	--with-boost=/where/is/boost \
	--with-babel-libtool=/where/babel/runtime/installed/bin/babel-libtool \
	--with-mpi=/where/mpich/installed \
and for more recent versions of mpich which use mpicxx instead of mpiCC, add
--with-mpi-cxx=/where/mpich/installed/bin/mpicxx

To configure with an installation prefix other than `pwd`, do for example
  ./configure --prefix=/tmp [... etc]
  NOTE: During configuration, the prefix location must be writable.
*** This may require running configure as root if prefix points
to a system area. ***

If boost is installed in a path normally found by the compiler
while searching for headers to satisfy
	#include "boost/shared_ptr.hpp"
then the --with-boost argument can be omitted.

If MPI support is not wanted, configure --with-mpi=no.

2. BUILDING

Building this package minimally takes just
	configure {flags} ; make; make install

Features that configure cannot find on your system
will be ignored in the build, leaving a working
subset of the package, unless boost is absent.  
In particular, doxygen and mpi optional,
though the spec and example are poorly documented in the
absence of doxygen.

To build and use this package in its full glory requires:
	a modern c++ compiler supporting namespaces.
	the boost headers current for your compiler.
	doxygen with graphviz (dot).

The documentation targets will issue an Error(ignored)
if doxygen is not found. As the source and include
files are intended to be self-explanatory (as needed
from a specification) the generated documentation is
strictly optional. The online version of the docs can
usually be found somewhere in the neighborhood of
www.cca-forum.org/ccafe.


N. References

  http://www.boost.org
  http://www.cca-forum.org