home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / j / jacal1a0.zip / jacal / README < prev    next >
Text File  |  1992-12-24  |  3KB  |  104 lines

  1. This directory contains the distribution of jacal1a.  Jacal is a
  2. symbolic mathematics system which runs under Scheme language
  3. implementations.  Scm, a P1178 and R4RS compliant Scheme
  4. implementation is available from the same sources as jacal.
  5.  
  6. The author can be reached at jaffer@ai.mit.edu or
  7. Aubrey Jaffer, 84 Pleasant St., Wakefield MA 01880.
  8.  
  9.                    MANIFEST
  10.  
  11.   `README' is this file.  It contains a MANIFEST, INSTALLATION
  12.     INSTRUCTIONS, and a TROUBLE SHOOTING GUIDE.
  13.   `COPYING' details the LACK OF WARRANTY for jacal and the conditions
  14.     for distributing jacal.
  15.   `ChangeLog' documents changes to the jacal.
  16.   `code.doc' has some documentation on jacal internals.
  17.  
  18.   `demo' demonstrates batch file use.  "batch(demo);" to use in jacal.
  19.   `manual' has Tex files which tell how to use jacal.
  20.     `cmds.tex' is documentation on commands.
  21.     `relnotes.tex' is a list of some things not consistent between
  22.         jacal and manual.tex.
  23.     `macros.tex' has tex macros for printing manual.tex.
  24.     `manual.tex' running "tex manual.tex" will format both
  25.         commands and release notes.
  26.  
  27.   `math.scm' is the file you load into scheme in order to run jacal.
  28.   `scl.scm' loads code from SLIB.
  29.   `toploads.scm' contains comments describing the rest of the files.
  30.  
  31.               INSTALLATION INSTRUCTIONS
  32.  
  33.   Scl.scm uses files from SLIB, the scheme library.  If you are
  34.   running jacal in Scheme you will need to install SLIB.  SLIB is
  35.   available from the same sources as jacal.  See README in SLIB for
  36.   how to install SLIB.
  37.  
  38. Different Scheme implementaions use different filename extensions. You
  39. may need to either link or change to suitable names the source files
  40. so that your Scheme can find them with the command (load "math").
  41. Look through the list below to find the filename extension for your
  42. Scheme.
  43.  
  44. * scm
  45.     extension is ".scm"
  46.  
  47. * MIT Scheme 
  48.     HP-UX, Unix: extension is ".scm"
  49.  
  50. * MacScheme 
  51.  
  52. * PC Scheme 
  53.     PCSCHEME is a R3RS implementation.  The file sc4-sc3.scm needs to
  54.     be finished in order for JACAL to run.
  55.  
  56. * T 
  57.     extension is ".scm"
  58.  
  59. * Chez Scheme 
  60.  
  61. * Elk 
  62.     extension is ".scm"
  63.  
  64. * Scheme->C 
  65.     extension is ".scm"
  66.  
  67. * Gambit
  68.     extension is ".scm"
  69.  
  70. * SIOD 
  71.     Siod is lacking some of the rev^4 datatypes.  JACAL will not run.
  72.  
  73. * Pseudoscheme 
  74.     This translates scheme programs to common lisp.
  75.  
  76. * Scheme84 
  77.     extension is ".scm"
  78.  
  79. * UMBscheme
  80.  
  81. * Vincennes Scheme 
  82.  
  83. * XScheme 
  84.  
  85. * Fools' Lisp 
  86.  
  87.                 RUNNING JACAL
  88.  
  89. To use from Scheme type:
  90.   scheme
  91.   (load "math")
  92.  
  93.                COMPILING JACAL
  94.  
  95. There are some tests which are run at the end of loading "math".  If
  96. these do not give any warnings then you can either try using the
  97. system "type (math)" or compiling it.
  98.  
  99. It is very worthwhile to compile SLIB files, "types.scm" and "poly.scm".
  100.  
  101.             TROUBLE SHOOTING GUIDE
  102.  
  103. Not yet written.
  104.