Read Me

Building namespace ewalena
--------------------------

There are a number of ways of building namespace ewalena library. It
is always recommended to do an "out of source build" (ie. build in an
external directory, say, "ewalena_build").  The default
CMAKE_BUILD_TYPE is debug. Almost everything can be controlled using
cmake's directives "-D".

Some build formulae are:

* Make an out-of-source directory:
    mkdir build

* Change to the out-of-source directory:
    cd build

* Choose a build type and options:

      (i) For the seriously impatient:
      	  cmake ..

      (ii) For the ncursed:
      	  ccmake ..
	  [configure (c), generate (g)]

      (iii) For making use of not default compilers, say, MPI; and in release (optimized) mode:
      	  cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER=/path/to/mpicxx ..

* Build the ewalena library: 
    make -j#N
where #N is the number of cores to make use of.

Subversion history (pre-alpha)
------------------------------

v0.2.16-17
	* Drop support for classical fields.

v0.2.14-16
	* Add an iterator class for various basis types.
	* Add ane example fof a state-space computation.
	* Improve the solver classes, generic orthogonalisation class.

v0.2.9-13
	* Transition period (alignment, documentation).

v0.2.9-12
	* Various bug fixes; especially in lac and base/tensor.*. 
	* Enhancments to configuration (make -D XXX).

v0.2.0-8
	* Improve cmake configuration (Debug / Release and make -D CMAKE_XXX).
	* Fix iterator bugs in ewalena::Matrix and ewalena::Vector.

v0.1.4-6
	* Add ewalena::SolverXXXX and ewalena::SolverControl.
	* Add simple ewalena::SuperMatrix.
	* Add ewalena::CrystalFieldBase and various XXXXTensor types for classical mechanics.
	* Additional support for Value/Vector/Tensor spaces and fields.
	* Kill all support for using deal.II objects (this is too tricky for now).

v0.1.1-4
	* Add weak support for geometrical and grids.
	* Introduce ewalena::Matrix, ewalena::Vector, ewalena::Tensor, ewalena::Point.
	* Fix and workaround bugs in cmake support.

v0.1.0
	* Add cmake support, remove broken autoconf support.
	* Add basic objects for computations in quantum mechanics.
	* Compose a directory structure.

v0.0.0
	* Library exists in a broken metaphysical state.