Pristine Ack-5.5
[Ack-5.5.git] / util / int / READ_ME
1 # $Id: READ_ME,v 2.3 1994/06/24 10:45:33 ceriel Exp $
2
3 This directory contains the sources of the EM interpreter. A parallel
4 directory contains the manual page and the documentation.  Two types of
5 interpreters can be generated.
6
7 - Normal Version
8 A call to  make  will result in the generation of an interpreter,  int.  This
9 interpreter will do full checking and can do logging on request.  It is the
10 normal interpreter to be used for software checking and grooming.
11
12 - Fast Version
13 If the interpreter is used for the purpose of running programs rather than for
14 testing them, a considerably faster version can be generated by undefining the
15 macro   LOGGING   in the include file   logging.h .  This interpreter will
16 still give some warnings: about bad trap numbers, unimplemented system calls
17 and the occurrence of traps.
18
19 There are a small number of compile-time flags, each in a separate file:
20         loggin.h        - distinguishes between normal and fast version
21         debug.h         - ignore
22         segcheck.h      - ignore
23         sysidf.h        - define the approrpiate system name
24         v7ioctl.h       - define if ioctl requests should conform to UNIX V7
25         nofloat.h       - define if the C compiler used has no floating point
26
27
28 There are two subdirectories:
29         switch          - generates opcode-analysing switches
30         test            - contains testprograms
31
32
33 Installation note:
34 The file do_fpar.c (do floating point arithmetic) contains a macro  MAXDOUBLE
35 which defines the largest possible double on the present machine. It is set to
36 99.e999, which may not be acceptable to your compiler. Adjust as necessary.
37
38 Note:
39 This interpreter assumes that the  char  in the C compiler used to translate
40 the interpreter, is a signed char.  It is not impossible to adapt the
41 interpreter to unsigned chars, but it is not trivial.
42