home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / proglang / isetl.arj / READ.ME < prev    next >
Text File  |  1989-10-03  |  5KB  |  120 lines
  1.  
  2. ISETL 2.0  (c) Gary Marc Levin 1987,1988,1988,1989
  3.  
  4. This copyright covers the source code, object code, documentation, and
  5. test and demonstration programs.  Parts of the code and documentation
  6. are copyright Evans and Sutherland.  See documentation for full
  7. description.
  8.  
  9. This program may be copied in either source or object form and
  10. distributed by anyone.  The only restrictions are that this file be
  11. included in any copied material, and that no charge be made over and
  12. above copying, media, and mailing costs.
  13.  
  14. The program has been developed by Gary Levin at Clarkson University.
  15. Please address any problems or questions to:
  16.  
  17.     Gary Levin
  18.     Dept of Math and Computer Science
  19.     Clarkson University
  20.     Potsdam, NY 13676
  21.     (315) 268-2384              Office
  22.     (315) 286-2395              Math Office
  23.         gary@clutx.clarkson.edu     Internet
  24.         GARY@CLUTX                  BITNET
  25.  
  26. I would appreciate hearing from anyone who has compiled the
  27. system from the source.
  28.  
  29. I am also interested in any problems that are discovered.  This would
  30. include:
  31.  
  32.     (1) Failures in the software.  If there is an error message,
  33.     please include that in your report.  If the results are
  34.     unexpected, include an explanation of what you expected and
  35.     what actually occurred.  Where possible, please provide sample
  36.     input that will reproduce the error.
  37.  
  38.     (2) Problems with the documentation.  If you feel that the
  39.     documentation is misleading or unclear, let me know where you
  40.     have problems.
  41.  
  42.     (3) Missing features.  If there is a feature that you think would
  43.     be useful, describe it and give some examples of how it would
  44.     be useful.
  45.  
  46.  
  47. =========
  48.  
  49. To install ISETL from source tape or disks.
  50.  
  51.  
  52. Load the files into an empty directory.
  53.  
  54.     From the MS-DOS disk, you will need to unarchive the files.  The program
  55.     'arce' will extract the files from the archives.  Ex: 'arce tests' will
  56.     produce all the test/result files.  You probably want to be on an empty
  57.     disk, say B:, with this disk on A:.  The command 'a:arce a:tests'
  58.     will place the files that are extracted on disk B:.  You will probably
  59.     wish to place the contents of test.arc and demo.arc in subdirectories.
  60.  
  61.     On VMS, define ``isetl :== $disk:[directory]isetl.exe'' if you
  62.     wish to pass command line arguments.  The leading $ is required.
  63.  
  64.     "READ.ME"  (this file)
  65.  
  66.     "isetl" (compiled to run under 4.2bsd) and ".isetlrc"
  67.     or "isetl.exe" and "isetl.ini" (MS-DOS,VMS) and ed.com (MS-DOS)
  68.     or "isetl" and "isetl.ini" (Mac).
  69.  
  70.     *.c and *.h files needed to create isetl.
  71.  
  72.     parser.y to re-create parser.c and parser.h.
  73.  
  74.     Makefile to automatically perform compilation.
  75.  
  76.         This only works on Unix sustems.  Type "make vax" (use your machine
  77.     type in place of vax) and wait.  Move "isetl" to wherever you want
  78.     it.  See machine.h if you need to tailor the source to a machine
  79.     not yet covered.
  80.  
  81.     *.lpr -- line printer approximations to the printed documentation
  82.  
  83.     *.t -- isetl source files to test features and provide examples.
  84.     Interesting examples:
  85.         curry.t        Uses of higher order functions
  86.         error.t         Common errors and the message that results
  87.         file.t        File creation and access
  88.         group.t        Does [op,S] form a group?
  89.         insert.t    Examples of %.  Generalizes: %+ is Sigma
  90.         io.t        Formated input and output
  91.         object.t    Object-oriented programming
  92.                 primeg.t    Three different ways to compute primes
  93.         primel.t        primes is most mathematical, primel is
  94.         primes.t        Pascal-like, primeg uses generators
  95.         where.t        Using the 'where' expr
  96.  
  97.  
  98.     *.r -- standard output for corresponding *.t files.  If you
  99.     run "isetl -s", this is the output.  There may be some
  100.     differences in output, in particular the tests of "random" and
  101.     "arb" and printing of sets.  If these are the only differences,
  102.     everything is fine.
  103.  
  104.     These test cases are also examples of most of the features
  105.     present in ISETL.
  106.  
  107.     The files in directory Demo (or demo.arc on MS-DOS disks) form a
  108.     demonstration suite for ISETL.  Type `isetl demo' to begin the
  109.     demonstration.  On Mac, you must have isetl and isetl.ini in the
  110.     directory containing the demos.
  111.  
  112. Similarly, you need to rename "isetl.ini" as ".isetlrc".
  113.  
  114. The Macintosh version needs source files derived from Symantec code.
  115. These cannot be distributed.  You can compile the Mac version under
  116. THINK C with Screen undefined.  Spread the files out into segments
  117. that are smaller than 32K.  You may need to compile with separate
  118. strings.
  119.  
  120.