home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / READMEs / Peanuts-2 / Developer / languages / lisp / AKCL.README < prev    next >
Encoding:
Text File  |  1996-11-09  |  3.2 KB  |  122 lines

  1. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  2. ;;;                                                                       ;;;
  3. ;;;  AKCL (Austin Kyoto Common Lisp) Version (1.599) for NeXT computers   ;;;
  4. ;;;                                                                       ;;;
  5. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  6.  
  7.                Noritake Yonezawa
  8.              Department of Computer Science
  9.            University of Illinois at Urbana-Champaign
  10.               yonezawa@cs.uiuc.edu
  11.  
  12.                  August 1, 1991
  13.  
  14.  
  15. This AKCL port runs on NeXT OS 2.0 or later.
  16.  
  17. Current version uses GCC-1.40 and modified GAS-1.38.1 instead of NeXT's (g)cc
  18. and (g)as to compile C-files generated by the AKCL compiler. It doesn't
  19. work well with NeXT's (g)as.
  20.  
  21. The restrictions of this port are as follows:
  22.  
  23.   * The process size of running AKCL is fixed.
  24.   * SYSTEM::FASLINK is not supported.
  25.  
  26.  
  27. How to compile and install
  28. --------------------------
  29.  
  30. DON'T follow the instructions in akcl-1-599/README.
  31. It's for the original AKCL. Especially, DON'T run add-defs
  32. that will overwrite to makefiles I already hacked.
  33.  
  34. 0.1. If you don't have /usr/local/src, make it as follows:
  35.  
  36.     mkdirs /usr/local/src
  37.  
  38. 0.2. Uncompress and untar the distribution file there:
  39.  
  40.     mv AKCL-1-599-NeXT.src.tar.Z /usr/local/src
  41.     cd /usr/local/src
  42.     uncompress -c AKCL-1-599-NeXT.src.tar.Z | tar -xvf -
  43.  
  44. 1.1. Make AKCL library directory as follows:
  45.  
  46.     mkdirs /usr/local/lib/kcl
  47.  
  48. 1.2. If you don't have /usr/local/bin, make it as follows:
  49.  
  50.     mkdirs /usr/local/bin
  51.  
  52. 2.1. Compile GCC as follows:
  53.  
  54.     cd /usr/local/src/gcc-1.40
  55.     make
  56.  
  57. 2.2. Install GCC binaries as follows:
  58.  
  59.     make install
  60.  
  61.      "kcl-cc", "kcl-cc1", and "kcl-cpp" are installed in /usr/local/lib/kcl.
  62.  
  63. 3.1. Compile GAS as follows:
  64.  
  65.     cd /usr/local/src/gas-1.38.1.hacked
  66.     make
  67.  
  68. 3.2. Install GAS as follows:
  69.  
  70.     make install
  71.  
  72.      "kcl-as" is installed in /usr/local/lib/kcl.
  73.  
  74. 4.1. If you want to change the process size of AKCL,
  75.      modify the following value at line 7 in
  76.      /usr/local/src/akcl-1-599/c/sbrkNeXT.c:
  77.  
  78.     int big_heap = 0x1000000;
  79.  
  80. 4.2. Compile AKCL as follows:
  81.  
  82.     cd /usr/local/src/akcl-1-599
  83.     make -f Smakefile
  84.  
  85. 4.3. If the compilation is done successfully,
  86.      "saved_kcl" is made in /usr/local/src/akcl-1-599/unixport.
  87.      Try /usr/local/src/akcl-1-599/xbin/kcl.
  88.      It is a shell script that invokes the saved_kcl.
  89.  
  90. 4.4. Move executable files as follows:
  91.  
  92.     mv /usr/local/src/akcl-1-599/unixport/saved_kcl /usr/local/lib/kcl
  93.     mv /usr/local/src/akcl-1-599/xbin/kcl /usr/local/bin
  94.  
  95. 4.5. Edit /usr/local/bin/kcl as follows:
  96.  
  97.     #!/bin/sh
  98.     /usr/local/lib/kcl/saved_kcl /usr/local/lib/kcl/
  99.  
  100. 4.6. Add /usr/local/bin to your $path. Don't forget to rehash.
  101.      Now you are ready to run AKCL. Try:
  102.  
  103.     kcl
  104.  
  105.  
  106. A hint to link your C object files and libraries in AKCL
  107. --------------------------------------------------------
  108.  
  109. Add your extra C object files and libraries to the following lines
  110. in /usr/local/src/akcl-1-599/unixport/makefile:
  111.  
  112.     EXTRAS= $(ODIR)/sbrkNeXT.o $(ODIR)/unexNeXT.o $(ODIR)/seekNeXT.o
  113.     LIBS= -lm -lg
  114.  
  115. They will be linked in /usr/local/src/akcl-1-599/unxport/raw_kcl
  116. when making saved_kcl.
  117.  
  118. --
  119. Noritake Yonezawa <yonezawa@cs.uiuc.edu>
  120. Department of Computer Science
  121. University of Illinois at Urbana-Champaign
  122.