home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / schemos2.zip / readme next >
Text File  |  1995-03-13  |  7KB  |  173 lines
  1. MIT Scheme 7.4 (alpha) for OS/2
  2.  
  3. MIT Scheme is an implementation of the Scheme programming language.
  4. This implementation is compliant with the "Revised^4 Report on the
  5. Programming Language Scheme" and (with one small exception) the "IEEE
  6. Standard for the Programming Language Scheme".  It supplies a large
  7. runtime library, a native-code compiler with source-level debugging
  8. tools, and an extensible integrated text editor which looks very much
  9. like GNU Emacs.
  10.  
  11. MIT Scheme is free software.  Source code for the entire
  12. implementation should have been available in the same place you got
  13. this file.
  14.  
  15. Prerequisites
  16. -------------
  17.  
  18. The Scheme files use about 20 megabytes of disk space when unZIPped.
  19. You can reduce this by deleting some files (see "Image Files" below).
  20.  
  21. MIT Scheme requires a fair amount of RAM to run well.  We haven't
  22. tried running this on any machine with less than 36 megabytes, so we
  23. don't have any hard data on what the smallest practical amount of RAM
  24. is.  However, for running Scheme under OS/2 Warp, 8 megabytes is
  25. probably the least you should consider, and 12 megabytes is probably
  26. comfortable.  If you want to use the Scheme compiler or the Edwin text
  27. editor, you should have at least 16 megabytes of RAM.
  28.  
  29. MIT Scheme has been tested only on OS/2 Warp 3.0, but it should also
  30. run under OS/2 versions 2.1 and 2.11.  It was compiled using IBM C
  31. Set++/2 version 2.1 using the OS/2 Toolkit version 3.0.
  32.  
  33. Installation
  34. ------------
  35.  
  36. After unpacking this ZIP file, you will have the following files:
  37.  
  38. README        This file.
  39. SCHEME.EXE    The Scheme executable program
  40. LIB\        A directory containing the data files needed by Scheme.
  41. OBJECTS\    A directory containing REXX scripts to create PM objects.
  42. ICONS\        A directory containing some useful icons.
  43.  
  44. 1. Move SCHEME.EXE to any directory that appears in your PATH.
  45.  
  46. 2. Move the LIB directory anywhere you like.  You may rename it to
  47.    anything you like.  (Here at MIT, we use "\SCHEME\LIB".)  After you
  48.    have chosen where it will be located, set the
  49.    MITSCHEME_LIBRARY_PATH environment variable in CONFIG.SYS to be
  50.    that location.
  51.  
  52.    For example, if you decide to store the directory as "C:\SCHDATA",
  53.    you would add the following to CONFIG.SYS:
  54.  
  55.    SET MITSCHEME_LIBRARY_PATH=C:\SCHDATA
  56.  
  57.    You can override the setting of this environment variable with the
  58.    "-library" command line option to Scheme, for example:
  59.  
  60.    SCHEME -LIBRARY D:\SCHEME\LIB
  61.  
  62.    If you supply a "-library" option, it is not necessary to have the
  63.    environment variable defined.  For example, instead of editing
  64.    CONFIG.SYS, you might create a ".cmd" file to invoke Scheme and
  65.    pass it the "-library" option automatically.
  66.  
  67. 3. The REXX programs in "OBJECTS" can be used to create PM objects to
  68.    invoke Scheme with various common settings.  I'm not a REXX
  69.    programmer, so I don't really understand how these things work, but
  70.    if you do know REXX, you should be able to modify these programs to
  71.    your own tastes.
  72.  
  73.    You don't need to keep this directory after you have run the
  74.    programs in it.
  75.  
  76.    By the way, you don't need to start Scheme from the presentation
  77.    manager -- you can start it from the shell also.
  78.  
  79. 4. The "ICONS" directory contains some Scheme-ish icons.  You can
  80.    paste these into existing PM program objects to make them look
  81.    different.  If you aren't interested in these icons, you can delete
  82.    this directory.
  83.  
  84. 5. Consider setting some of other environment variables described
  85.    below.
  86.  
  87. Image Files
  88. -----------
  89.  
  90. Scheme stores its runtime environment in a binary "image" file, which
  91. is loaded into the Scheme process directly.  An image file is a
  92. snapshot of Scheme's memory taken at a particular time (you can create
  93. your own image files using the DISK-SAVE procedure).  This
  94. distribution comes with four different image files, each of which
  95. contains different mixes of programs.  These image files are stored in
  96. the LIB\ directory.
  97.  
  98. 1. RUNTIME.COM is the basic runtime environment with no other programs
  99.    loaded.  This is the smallest image file.  All other image files
  100.    contain are supersets of this file.  This is the default image file
  101.    that is used when Scheme starts up, unless it is overridden by a
  102.    command-line option.
  103.  
  104. 2. COMPILER.COM contains the basic runtime environment and the LIAR
  105.    native-code compiler.  This is the image file that is loaded when
  106.    Scheme is started with the "-compiler" command-line option.
  107.  
  108. 3. EDWIN.COM contains the basic runtime environment and the Edwin text
  109.    editor.  This is the image file that is loaded when Scheme is
  110.    started with the "-edwin" command-line option.
  111.  
  112. 4. ALL.COM contains the basic runtime environment, the LIAR compiler,
  113.    and the Edwin editor.  This is the largest of the image files.
  114.  
  115. You can delete any of these files that you aren't going to use (these
  116. image files take up a LOT of disk space!).  However, keep in mind that
  117. you need at least one image file to run Scheme at all.
  118.  
  119. Documentation
  120. -------------
  121.  
  122. You can get documentation for Scheme from "swiss-ftp.ai.mit.edu" in
  123. the directory "/pub/scheme-7.3/doc/".  There are two documents:
  124.  
  125. * The MIT Scheme User's Guide describes how to run and use Scheme.  It
  126.   describes all of the environment variables and command line options,
  127.   how to run the compiler and editor, etc.
  128.  
  129. * The MIT Scheme Reference Manual documents the programming language
  130.   and the runtime library.  This is a large and detailed document for
  131.   writing programs.
  132.  
  133. Environment Variables
  134. ---------------------
  135.  
  136. MITSCHEME_LIBRARY_PATH says where to find Scheme's data files.  This
  137. is the only required environment variable.
  138. SET MITSCHEME_LIBRARY_PATH=D:\SCHEME\LIB
  139.  
  140. MITSCHEME_INF_DIRECTORY tells Scheme where to find debugging
  141. information for the runtime system.  The default value for this
  142. environment variable is a subdirectory "src" located in the directory
  143. specified by MITSCHEME_LIBRARY_PATH.
  144. SET MITSCHEME_INF_DIRECTORY=D:\SCHEME\LIB\SRC
  145.  
  146. The TMP environment variable tells Scheme the name of a directory
  147. where it can store temporary files.  If not specified, a number of
  148. different possible directories are tried, in order:
  149.     1. \TMP on the current drive
  150.     2. C:\
  151.     3. the current directory
  152.     4. \ on the current drive
  153. SET TMP=D:\TMP
  154.  
  155. The HOME environment variable tells Scheme where your "home" directory
  156. is located.  This is where Scheme looks for init files, and it is also
  157. what the "~/" filename prefix expands to.  If not specified, Scheme
  158. uses the root directory of the current drive.
  159. SET HOME=D:\CPH
  160.  
  161. The SHELL environment variable tells Edwin what shell program to use
  162. in shell buffers and for running shell commands.  If not specified,
  163. this defaults to the standard OS/2 shell, "cmd.exe".
  164. SET SHELL=D:\LOCAL\PROG\4OS225\4OS2.EXE
  165.  
  166. Bug Reporting
  167. -------------
  168.  
  169. If you discover any bugs, we'd like to hear about them.  Please send
  170. bug reports to
  171.  
  172.    bug-cscheme-os2@zurich.ai.mit.edu
  173.