home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d519 / oaklisp.lha / OakLisp / Amiga.README next >
Text File  |  1991-07-22  |  3KB  |  84 lines
  1.  
  2.             What this is
  3.  
  4.  
  5. This is a straight port of the OAKLISP system to the Amiga. OAKLISP is
  6. a Scheme-like LISP with an object-oriented base. An R3RS Scheme
  7. environment is included in the package. I haven't added any
  8. amiga specific features, and have no plans for either supporting or
  9. developing this system. It's being distributed so others can make use
  10. of it.
  11.  
  12.             Files
  13.  
  14.  
  15. Amiga.README    - You're reading it. It describes the Amiga distribution.
  16. COPYING        - The license agreement for distribution.
  17. README        - This describes the Unix distribution
  18. oaklisp.man    - Formatted version of the Unix manual page (flags apply).
  19. oaklisp.lzh    - Contains the actual executables:
  20.     etc/emulator    - The byte code interpreter used by OAKLISP.
  21.     lib/oaklisp.olc    - The OAKLISP environment.
  22.     lib/oaklisp.ols    - The Scheme environment.
  23. src.lzh        - source to etc/emulator.
  24. bytecodes.lzh    - the rest of the oaklisp bytecode files, plus Unix shell
  25.           script to drive the compiler
  26.  
  27.             Useage
  28.  
  29.  
  30. Extract oaklisp.lzh to wherever you want OAKLISP to live (don't forget
  31. the -x flag).  Assign OAKPATH: to that directory. The following two
  32. aliases can then be used to invoke oaklisp & scheme as described in
  33. the man page:
  34.  
  35. alias oaklisp "oakpath:etc/emulator [] oakpath:lib/oaklisp.olc"
  36. alias scheme "oakpath:etc/emulator [] oakpath:lib/oaklisp.ols"
  37.  
  38. If you are only going to use the Scheme or OAKLISP environment, you
  39. may delete the unused file in oakpath:lib.
  40.  
  41. The environment variables in the man page aren't used. The OAKPATH
  42. variable is in the assign, and the OAKLISP & SCHEME variables can be
  43. imbedded in the aliases.
  44.  
  45.             Rebuilding
  46.  
  47.  
  48. The src archive containes the source to etc/emulator. This is the
  49. emulator for the byte code machine that OAKLISP runs on. This not the
  50. source to the LISP system proper. You can rebuild the emulator using
  51. Lattice C 5.10a and the supplied SASCOPTS and lmkfile. Changing the
  52. processor type is recommended if you've got a faster processors. Any
  53. other changes you make at your own risk.
  54.  
  55.  
  56. The reason the source to the LISP system is not included is that
  57. rebuilding it (in the state it's shipped in) requires a running T
  58. system. I haven't built - and don't plan on building - that for the
  59. Amiga. If you want to work on that, the README file contains
  60. enough information that you should be able to obtain a complete (and
  61. current) distribution.
  62.  
  63.             Warnings:
  64.  
  65.  
  66. I haven't thoroughly tested this port. Since the byte code interpter
  67. seems to work fine, and the rest of it is unchanged, it should be OK.
  68.  
  69. If you run oaklisp (or Scheme) without any flags, it uses about 2 meg
  70. of RAM. See oaklisp.man for the -h flag to see how that number might
  71. be reduced.
  72.  
  73. I have not included the oaklisp.lo? files. If you need those, you
  74. should obtain them from the author. See the file README.
  75.  
  76. This has only been tested on an A3000 under 2.0x (x > 3). It should
  77. work on any version of AmigaDOS (but you'll need the 1.3 shell for the
  78. aliases to work). Performance on anything slower than a 16MHz '020 is
  79. probably going to be abysmal.
  80.  
  81. There is no documentation for the OAKLISP environment in this
  82. distribution. The README file contains enough information to obtain an
  83. OAKLISP manual.
  84.