From 302e3218b7d487539ec305bf23881a6ee7d5be99 Mon Sep 17 00:00:00 2001 From: Bryan Newbold Date: Mon, 20 Feb 2017 00:05:29 -0800 Subject: Import Upstream version 5e1 --- README | 65 ++++++++++++++++++++++++++++++++++------------------------------- 1 file changed, 34 insertions(+), 31 deletions(-) (limited to 'README') diff --git a/README b/README index e672a56..6a1ba84 100644 --- a/README +++ b/README @@ -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://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 in scmfig.h and Do so and recompile files. recompile scm. add 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'. -- cgit v1.2.3