home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD2.img / d5xx / d520 / oaklisp / readme < prev    next >
Text File  |  1991-07-20  |  3KB  |  83 lines
  1. This directory contains a release of the Oaklisp system.
  2.  
  3. Oaklisp is (C) Copyright 1986,87,88,89,90 Kevin Lang and Barak
  4. Pearlmutter.  In the Freeware tradition, permission is explicitly
  5. granted for anyone to use and copy this software, provided that
  6. neither it nor any derived work is sold.  All other rights reserved.
  7.  
  8. Enhancements, bug reports, and bug fixes should be mailed to
  9. Barak.Pearlmutter@CS.CMU.EDU for those with appropriate access to the
  10. Internet, or
  11.  
  12.     Barak Pearlmutter
  13.     Department of Computer Science
  14.     Carnegie-Mellon University
  15.     Pittsburgh, PA  15213
  16.  
  17. for others.
  18.  
  19. Some of the Makefiles in this collection use CMU CS specific features.
  20. If you can't figure out what's going on, try just ignoring and
  21. deleting the weird stuff.
  22.  
  23. An Oaklisp Language Manual is available as a CMU CS technical report.
  24.  
  25.  
  26.  
  27. The contents of this directory are as follows:
  28.  
  29. Makefile; type "make install" to get things set up.
  30.  
  31. bin/    contains some shell scripts.  Either put this directory in
  32.     your search path or make links from some directory on your
  33.     search path to the scripts oaklisp, oakliszt, and scheme.
  34.  
  35.     The command to run Oaklisp is "oaklisp".  The command to run
  36.     Oaklisp with an R3RS compatibility package loaded is "scheme".
  37.     The command to compile an Oaklisp source file is "oakliszt".
  38.     For instance, to compile foo.oak, producing foo.oa, one types
  39.     "oakliszt foo".
  40.  
  41.     To use these scripts, you should setenv OAKPATH to the
  42.     directory this file is in, with no trailing slash, or change
  43.     the default location by editing them.
  44.  
  45. etc/    contains a symbolic link to the bytecode emulator executable,
  46.     "emulator", which lives down in the src/ subdirectory.
  47.  
  48. src/    contains C source to make the bytecode emulator.  If Oaklisp
  49.     won't boot, you may need to edit the file config.h to reflect
  50.     your machine, although it tries to adapt itself to various
  51.     environments.  In particular, make sure it gets BIG_ENDIAN and
  52.     UNSIGNED_CHARS set correctly.
  53.  
  54.     If you have CMU make, just cd to fast/ and "make emulator".
  55.     If you have a System-V style make that recognizes VPATH, add
  56.     the line "VPATH = ../src" to the beginning of fast/makefile,
  57.     cd to fast/ and "make emulator".  If you have a lowest common
  58.     denominator make, cd to fast/ and type "cp
  59.     ../src/{Makefile,*.[ch]} ." and then "make emulator".
  60.  
  61. lib/    contains Oaklisp bootable worlds.  The only crucial one is
  62.     "oaklisp.??c" which is the normal Oaklisp world.
  63.     "oaklisp.??z" is the batch compiler world, necessary for the
  64.     "oakliszt" command.  The "??" in these filenames is either
  65.     "ol" or "lo" for big endian and little endian machines,
  66.     respectively.  Of course, you only really need the ones for
  67.     the endianity of your machine.
  68.  
  69. mac/    **OPTIONAL**
  70.  
  71.     contains all the Oaklisp source files needed to build a world,
  72.     including the compiler and the scheme compatibility package.
  73.  
  74. linker/    **OPTIONAL**
  75.  
  76.     contains the world builder tool, which is written in T.  (T is
  77.     distributed by the Free Software Foundation of Cambridge
  78.     Mass.)  This is used for building new cold world loads,
  79.     necessary only when extremely low level changes are made to
  80.     the system.  Someday someone will get around to porting the
  81.     world builder to Oaklisp, which would be very simple.
  82.  
  83.