This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
yap-6.3/INSTALL
vsc e5f4633c39 This commit was generated by cvs2svn to compensate for changes in r4,
which included commits to RCS files with non-trunk default branches.


git-svn-id: https://yap.svn.sf.net/svnroot/yap/trunk@5 b08c6af1-5177-4d33-ba66-4b1c6b8b522a
2001-04-09 19:54:03 +00:00

133 lines
3.4 KiB
Plaintext

These are some basic instructions to compile and install YAP:
1. How to compile Yap:
To compile YAP just do:
(1) mkdir arch
(2) cd arch
(3) ../configure
(4) check the Makefile for any extensions or changes you want to make.
(5) make
(6) If the compilation succeeds, try ./yap
(7) Happy? make install
1.1 Where to install Yap
Recent versions of Yap try to follow GNU conventions on where to
place software.
o The main executable is placed at BINDIR. This executable is
actually a script that calls the Prolog engine, stored at LIBDIR.
o LIBDIR contains the Prolog engine and a Prolog library.
o INCLUDEDIR is used if you want to use Yap as a library.
1.2 Which Yap
Compiling Yap with the standard options give you a plain vanilla
Prolog. You can tune Yap to include some extra functionality
o -DCOROUTINING=1 gives you delaying on goals, eg, freeze.
o -DRATIONAL_TREES=1 includes support for rational trees.
o -DDEPTH_LIMIT=1 allows depth limited evaluation, say for
implementing iterative deepening.
o -DYAP_ARRAYS gives you two different styles of arrays.
o -DANALYST and -DLOW_LEVEL_TRACER give you low level
debugging. ANALYST tells how your program uses the abstract machine
instructions. LOW_LEVEL_TRACER dumps the gory details of what your
program is doing.
The next two options are good fun, but arguably not production
quality:
o -DTABLING gives tabling in XSB style.
o -DYAPOR gives or-parallelism in Muse style. If you add -DSBA to it
you will have the Sparse Binding Array instead of copying. If you add
-DACOW instead you will have the \alphaCOW model, that is, forking
instead of copying.
1.3 Porting Yap
The system has been mainly tested with GCC, but we have been able to
compile versions of Yap under lcc in Linux, Sun's cc compiler, IBM's
xlc, SGI's cc, and Microsoft's Visual C++ 6.0. The HP-UX preprocessor
is known to choke under Yap.
1.3.1 Yap and GCC
Yap has been developed to take advantage of GCC (but not to depend on
it). The major advantage of GCC is threaded code and register
reservation.
YAP is set by default to compile with the best compilation flags we
know. Even so, a few specific options can be used depending on the
architecture:
1.3.1.1 x86
The flag:
YAP_EXTRAS= ... -DBP_FREE=1
tells us to use the %bp register (frame-pointer) as the emulator's
program counter. This seems to be stable and should become default
real soon now.
1.3.1.2 Sparc/Solaris2
Use:
YAP_EXTRAS= ... -mno-app-regs -DOPTIMISE_ALL_REGS_FOR_SPARC=1
and YAP will get two extra registers! This trick does not work on
SunOS 4 machines.
1.3.1.3 Tuning GCC/Yap for your machine model
Versions of GCC can be tweaked for different processors, eg, 486,
Pentium, PentiumPro, Ultrasparc, Supersparc. Unfortunately, some of
these tweaks do may make Yap run slower or not at all in other machines
with the same instruction set, so they cannot be made default.
The best options also depends on the version of GCC you are using, and
it is a good idea to consult the GCC manual under the menus "Invoking
GCC"/"Submodel Options". We next describe a few:
(a) GCC up to 2.7.*:
o 486:
YAP_EXTRAS= ... -m486 -DBP_FREE=1
to take advantage of 486 specific optimisations in GCC 2.7.*.
o Pentium:
YAP_EXTRAS= ... -m486 -malign-loops=2 -malign-jumps=2 -malign-functions=2
o PentiumPros are known not to require alignment.
o Super and UltraSparcs:
YAP_EXTRAS= ... -msupersparc
(b) GCC 2.8.*, EGCS, GCC 2.95.*
o Check -march=XXX for fun.