Official instructions should be read in the MUESLI Installation Guide
(cf. 'muesli_inst_guide.pdf')

Note that the path string specifying the location of the source files of MUESLI
cannot contain the plus character ('+'). Space, however, is a valid character.

------------
 configure:
------------

Before build MUESLI, first 'cd' to the directory having the name of a compiler,
for example:
  $ cd GNU_GFC

Then run the 'configure' script:
  $ ./configure

The configure options, available via:
  $ ./configure --help
allow the user, among other things, to specify the BLAS/LAPACK libraries and
the compilers used.

This updates the file 'Makefile.config'. In some rare cases, you should manually
modify some entries of this configuration file.

Lastly, apply appropriate changes to the 'configurable options' at the beginning
of the three Makefiles:
	<COMPILER_NAME>/Makefile
	<COMPILER_NAME>/tests/Makefile
	<COMPILER_NAME>/tests/fgl/Makefile

--------------
 fast build :                        only shared, optimized libraries are built
--------------

  $ make -s

  $ make install

[ $ make -s distclean ]


--------------
 twin build :   shared, optimized libraries, together with archived, debug ones
--------------

  $ make -s CFG=debug

  $ make -s clean

  $ make -s

  $ make install

[ $ make -s distclean ]


-------------------------------
 verbose output during build :
-------------------------------

  $ make MODE=verbose

  $ make install

[ $ make distclean ]


---------------------------------
 debug mode for debugging apps :                 only archived, debug libraries
---------------------------------

  $ make -s CFG=debug

  $ make -s CFG=debug install


'make install' produces a useful shell script, named 'muesli-config', which can
be used either in command line or in a makefile to select the compiler, compile
and link your program.

----------
 testing:
----------

To test the 'muesli-config' script, go to <COMPILER_NAME>/tests/muesli-config/
and type 'make'; this should create the executable file 'test_muesli_config_fml'.

Before doing installation you may want to test the whole MUESLI library; for
this, go to <COMPILER_NAME>/tests/ and type:

  $ make

  $ ./run_all

Type [RETURN] for running each module test; each test must complete without
Errors nor Segmentation Fault.

