diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 65 | 
1 files changed, 34 insertions, 31 deletions
| @@ -1,17 +1,18 @@ -This directory contains the distribution of scm5d9.  Scm conforms to +This directory contains the distribution of scm5e1.  Scm conforms to  Revised^5 Report on the Algorithmic Language Scheme and the IEEE P1178  specification. SCM runs under Amiga, Atari-ST, MacOS, MS-DOS, OS/2,  NOS/VE, Unicos, VMS, Unix and similar systems. -               <http://swissnet.ai.mit.edu/~jaffer/SCM> +               `http://swiss.csail.mit.edu/~jaffer/SCM' -Manifest -======== +0.1 Manifest +============  `.gdbinit'       provides commands for debugging SCM with GDB  `COPYING'        details the LACK OF WARRANTY for SCM and the conditions                   for distributing SCM.  `ChangeLog'      changes to SCM. +`Idiffer.scm'    Linear-space O(PN) sequence comparison.  `Iedline.scm'    Gnu readline input editing.  `Init.scm'       Scheme initialization.  `Link.scm'       Dynamic link/loading. @@ -30,6 +31,7 @@ Manifest  `continue.h'     continuations.  `crs.c'          interactive terminal control.  `debug.c'        debugging, printing code. +`differ.c'       Linear-space O(PN) sequence comparison.  `dynl.c'         dynamically load object files.  `ecrt0.c'        discover the start of initialized data space                   dynamically at runtime. @@ -93,8 +95,8 @@ Manifest  File: scm.info,  Node: SLIB,  Next: Building SCM,  Prev: Making SCM,  Up: Installing SCM -SLIB -==== +2.2 SLIB +========  [SLIB] is a portable Scheme library meant to provide compatibility and  utility functions for all standard Scheme implementations.  Although @@ -102,18 +104,18 @@ SLIB is not _neccessary_ to run SCM, I strongly suggest you obtain and  install it.  Bug reports about running SCM without SLIB have very low  priority.  SLIB is available from the same sites as SCM: -   * swissnet.ai.mit.edu:/pub/scm/slib3a1.tar.gz +   * swiss.csail.mit.edu:/pub/scm/slib3a2.tar.gz -   * ftp.gnu.org:/pub/gnu/jacal/slib3a1.tar.gz +   * ftp.gnu.org:/pub/gnu/jacal/slib3a2.tar.gz -   * ftp.cs.indiana.edu:/pub/scheme-repository/imp/slib3a1.tar.gz +   * ftp.cs.indiana.edu:/pub/scheme-repository/imp/slib3a2.tar.gz -Unpack SLIB (`tar xzf slib3a1.tar.gz' or `unzip -ao slib3a1.zip') in an +Unpack SLIB (`tar xzf slib3a2.tar.gz' or `unzip -ao slib3a2.zip') in an  appropriate directory for your system; both `tar' and `unzip' will  create the directory `slib'.  Then create a file `require.scm' in the SCM "implementation-vicinity" -(this is the same directory as where the file `Init5d9.scm' is +(this is the same directory as where the file `Init5e1.scm' is  installed).  `require.scm' should have the contents:       (define (library-vicinity) "/usr/local/lib/slib/") @@ -138,8 +140,8 @@ overrides `require.scm'.  Again, absolute pathnames are recommended.  File: scm.info,  Node: Making SCM,  Next: SLIB,  Prev: Installing SCM,  Up: Installing SCM -Making SCM -========== +2.1 Making SCM +==============  The SCM distribution has "Makefile" which contains rules for making  "scmlit", a "bare-bones" version of SCM sufficient for running `build'. @@ -150,7 +152,7 @@ Makefiles are not portable to the majority of platforms.  If `Makefile'  works for you, good; If not, I don't want to hear about it.  If you  need to compile SCM without build, there are several ways to proceed: -   * Use the build (http://swissnet.ai.mit.edu/~jaffer/buildscm.html) +   * Use the build (http://swiss.csail.mit.edu/~jaffer/buildscm.html)       web page to create custom batch scripts for compiling SCM.     * Use SCM on a different platform to run `build' to create a script @@ -165,14 +167,14 @@ need to compile SCM without build, there are several ways to proceed:  File: scm.info,  Node: Editing Scheme Code,  Next: Debugging Scheme Code,  Prev: SCM Session,  Up: Operational Features -Editing Scheme Code -=================== +3.7 Editing Scheme Code +======================= - - Function: ed arg1 ... + -- Function: ed arg1 ...       The value of the environment variable `EDITOR' (or just `ed' if it       isn't defined) is invoked as a command with arguments ARG1 .... - - Function: ed filename + -- Function: ed filename       If SCM is compiled under VMS `ed' will invoke the editor with a       single the single argument FILENAME. @@ -214,8 +216,8 @@ other systems:  File: scm.info,  Node: Problems Compiling,  Next: Problems Linking,  Prev: Automatic C Preprocessor Definitions,  Up: Installing SCM -Problems Compiling -================== +2.8 Problems Compiling +======================  FILE    PROBLEM / MESSAGE                HOW TO FIX  *.c     include file not found.          Correct the status of @@ -248,8 +250,8 @@ scl.c   syntax error.                    #define SYSTNAME to your system  File: scm.info,  Node: Problems Linking,  Next: Problems Running,  Prev: Problems Compiling,  Up: Installing SCM -Problems Linking -================ +2.9 Problems Linking +====================  PROBLEM                              HOW TO FIX  _sin etc. missing.                   Uncomment LIBS in makefile. @@ -258,8 +260,8 @@ _sin etc. missing.                   Uncomment LIBS in makefile.  File: scm.info,  Node: Problems Running,  Next: Testing,  Prev: Problems Linking,  Up: Installing SCM -Problems Running -================ +2.10 Problems Running +=====================  PROBLEM                              HOW TO FIX  Opening message and then machine     Change memory model option to C @@ -278,17 +280,17 @@ remove <FLAG> in scmfig.h and        Do so and recompile files.  recompile scm.                         add <FLAG> in scmfig.h and             recompile scm.                        -ERROR: Init5d9.scm not found.        Assign correct IMPLINIT in makefile +ERROR: Init5e1.scm not found.        Assign correct IMPLINIT in makefile                                       or scmfig.h.                                       Define environment variable                                       SCM_INIT_PATH to be the full -                                     pathname of Init5d9.scm. +                                     pathname of Init5e1.scm.  WARNING: require.scm not found.      Define environment variable                                       SCHEME_LIBRARY_PATH to be the full                                       pathname of the scheme library                                       [SLIB].                                       Change library-vicinity in -                                     Init5d9.scm to point to library or +                                     Init5e1.scm to point to library or                                       remove.                                       Make sure the value of                                       (library-vicinity) has a trailing @@ -298,8 +300,8 @@ WARNING: require.scm not found.      Define environment variable  File: scm.info,  Node: Testing,  Next: Reporting Problems,  Prev: Problems Running,  Up: Installing SCM -Testing -======= +2.11 Testing +============  Loading `r4rstest.scm' in the distribution will run an [R4RS]  conformance test on `scm'. @@ -349,7 +351,7 @@ Some symbol names print incorrectly. Change memory model option to C                                       than HEAP_SEG_SIZE).  ERROR: Rogue pointer in Heap.        See above under machine crashes.  Newlines don't appear correctly in   Check file mode (define OPEN_... in -output files.                        `Init5d9.scm'). +output files.                        `Init5e1.scm').  Spaces or control characters appear  Check character defines in  in symbol names.                     `scmfig.h'.  Negative numbers turn positive.      Check SRS in `scmfig.h'. @@ -364,5 +366,6 @@ Sparc(SUN-4) heap is growing out of control       This causes lots of stuff which should be collected to not be.       This will be a problem with any _conservative_ GC until we find       what instruction will clear the register windows.  This problem is -     exacerbated by using lots of call-with-current-continuations. +     exacerbated by using lots of call-with-current-continuations.  A +     possible fix for dynthrow() is commented out in `continue.c'. | 
