aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2017-02-20 00:05:29 -0800
committerBryan Newbold <bnewbold@robocracy.org>2017-02-20 00:05:29 -0800
commit302e3218b7d487539ec305bf23881a6ee7d5be99 (patch)
treebf1adafe552a17b3b78522048bb7c24787696dd3 /README
parentc7d035ae1a729232579a0fe41ed5affa131d3623 (diff)
downloadscm-302e3218b7d487539ec305bf23881a6ee7d5be99.tar.gz
scm-302e3218b7d487539ec305bf23881a6ee7d5be99.zip
Import Upstream version 5e1upstream/5e1
Diffstat (limited to 'README')
-rw-r--r--README65
1 files changed, 34 insertions, 31 deletions
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://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'.