mach/arm/READ_ME

   1 These are the comments as I received them from Albert Koelmans.
   2 The only thing I did was adapt the installation mechanism for ACK, and
   3 made some adaptions to de code generator to support the improved FP package.
   4 I also removed some comments that were no longer up-to-date.
   5
   6 Ceriel Jacobs
   7
   8 AMSTERDAM COMPILER KIT - BACKEND FOR ACORN RISC MACHINE PROCESSOR
   9 ===========================================================================
  10
  11 This file contains some advice on how to go about installing the ARM backend
  12 for the Amsterdam Compiler Kit (ACK), followed by a shar file containing the
  13 backend itself. In what follows, ~ will denote the ACK root directory (on
  14 most systems, this will be /usr/em), also called EMHOME in most makefiles.
  15
  16 Make sure that your PATH includes ~/bin
  17
  18 cd to ~/bin, and type
  19    ln ack arm
  20
  21 cd to ~/mach/proto/ncg, and inspect file param.h. The constant MAXEMLINES
  22 should be at least 40. Edit the file if necessary.
  23
  24 cd to ~/util/ncgg, and inspect file param.h. The constant MAXNODES should
  25 have as parameter at least 1200. If this is not the case, edit the
  26 file and type 'make install' to generate a new ncgg.
  27
  28 If some compilations fail, inspect file Out in the appropriate subdirectory
  29 to find the cause.
  30
  31 ACK will create an a.out file which includes an ACK header and symbol table.
  32 Use the cv program to strip these off, after which the executable should be
  33 downloaded onto an Archimedes machine and have it's type set to FF8.
  34
  35 Acknowledgements: the first version of the backend was written by an anonymous
  36 student at the Vrije Universiteit, Amsterdam. The code generator was further
  37 developed and debugged by Albert Koelmans. Andrew Michael wrote most of the
  38 assembler sources. A simple RiscOs interface was added by Albert Koelmans.
  39 All of this involved extensive help from Ceriel Jacobs. The assertion in the
  40 ACK documentation that writing a backend is a major task is certainly true...
  41
  42 In case of major problems, bugs etc, contact me at the address below....
  43
  44 Revision history:
  45
  46 jan 1990 version 1.0
  47
  48 mar 1990 version 1.1
  49          Some bugs sorted out
  50          Backend generates tighter code
  51          Much better target optimiser
  52 apr 1990 version 2.0
  53          Register variables introduced
  54          more bugs removed
  55
  56 Albert Koelmans
  57 (albert.koelmans@newcastle.ac.uk)