Variants of the Libraries

[Home] [prev] [up] [next] ((Makefile.def))

5.2 Variants of the Libraries

The distribution of the Aldor libraries comes in three variants:

the ordinary version libaldor.al and libalgebra.al,
the GMP (GNU multiprecision library) version libalgebra-gmp.al and libalgebra-gmp.a, and
the debug version libaldord.al and libalgebrad.a.

All these variants are not compatible with each other.

ALLPROSE provides a simple mechanism for several variants of the project and testcases library which are built on the corresponding Aldor libraries. The following variable specifies which library variants should be built.

ToDo ⊲ 2 ⊳ Must change include/myalps.as .nw and tools/generateTestCases.pl .nw if we have other POSTFIXes than "d", "-gmp", or "".

We would rather like to suggest that all variants of libraries come with the same name but are collected in different subdirectories, i. e., all libraries related to the debug version should go into $ALDORROOT/lib/debug, all libraries related to the GMP version should go under $ALDORROOT/lib/gmp. In these directories the libraries should all have the same name. For example, instead of libalgebra.al, libalgebrad.al, and libalgebra-gmp.al in the directory lib, we would have libalgebra.al in the subdirectories lib/ordinary, lib/debug, and lib/gmp. In that way the corresponding file include/algebra.as could be made a bit simpler.

ToDo ⊲ 3 ⊳ Currently, there is some restriction on the variants, since the include files include/myalps.as .nw and include/testcases.as select the library name only depending on the Aldor command line switches -dDEBUG and -dGMP.

27⟨library variants 27⟩≡ (21) 30 ⊳
VARIANTSTOBUILD=debug
# ordinary
# gmp

Defines:
VARIANTSTOBUILD, never used.

The above value of VARIANTSTOBUILD can be any value xxx as long as there are corresponding variables VARIANTPOSTFIX xxx and VARIANTFLAGS xxx etc.

For each of the variants there are four variables. They are put on the command line for the specific variant as can be seen in the targets libraryvariant.% and executablevariant.% in Makefile.inc .nw.

VARIANTPOSTFIX xxx specifies the postfix of the variant library for both the .al and the .a version of the library.
For example, if

VARIANTPOSTFIXdebug=d

is given, then the names of the debug variant would be src/libmyalpsd.al and src/libmyalpsd.a .
VARIANTASSERTION xxx specifies the specific assertion that must be given when working with that variant. A typical case is
VARIANTASSERTIONdebug=-dDEBUG

for the debug variant.
VARIANTFLAGS xxx specifies all other flags specific to that variant of the library. In particular, the libraries on which the project is built should be specified here. Furthermore, it is a good place for optimizer flags. One need not specify -l$(LIBRARYNAME) since that flag is added automatically.
VARIANTEXECUTABLEFLAGS xxx specifies flags that must be given in addition to the flags above in order to compile an executable.
Variables of the form VARIANTEXECUTABLEFLAGS xxx are put on the command line for the compilation of an executable (including the testsuite).

If there is some need to have specific flags for certain executables, it is possible to define them through a variable VARIANTSOMENAMEFLAGSxxx where SOMENAME has to be replaced by the actual name of the specific executable (without any variant postfix). For example if the name of the executable is Foo, and it needs the flags ’-Dbar -Drandom’ for the ordinary variant. Then one would have to define the following variable.

VARIANTFooFLAGSordinary=-Dbar -Drandom

Of course this limits the possible names of executables, since their names appear as substrings in a Makefile variable.

30⟨library variants 27⟩+≡ (21) ⊲27
VARIANTPOSTFIXordinary=
VARIANTASSERTIONordinary=
VARIANTFLAGSordinary=-q3 -qinline-all -lalgebra -laldor
VARIANTEXECUTABLEFLAGSordinary=

VARIANTPOSTFIXgmp=-gmp
VARIANTASSERTIONgmp=-dGMP
VARIANTFLAGSgmp=-q3 -qinline-all -lalgebra-gmp -laldor
VARIANTEXECUTABLEFLAGSgmp=-Cruntime=foam-gmp,gmp,m

VARIANTPOSTFIXdebug=d
VARIANTASSERTIONdebug=-dDEBUG
VARIANTFLAGSdebug=-q1 -lalgebrad -laldord
VARIANTEXECUTABLEFLAGSdebug=

Defines:
VARIANTASSERTION, never used.
VARIANTEXECUTABLEFLAGS, never used.
VARIANTFLAGS, never used.
VARIANTPOSTFIX, never used.

[Home] [prev] [up] [next] ((Makefile.def))