Overview of the DEC Scheme->C Compiler.
;* Copyright 1989 Digital Equipment Corporation
;* All Rights Reserved
;*
;* Permission to use, copy, and modify this software and its documentation is
;* hereby granted only under the following terms and conditions. Both the
;* above copyright notice and this permission notice must appear in all copies
;* of the software, derivative works or modified versions, and any portions
;* thereof, and both notices must appear in supporting documentation.
;*
;* Users of this software agree to the terms and conditions set forth herein,
;* and hereby grant back to Digital a non-exclusive, unrestricted, royalty-free
;* right and license under any changes, enhancements or extensions made to the
;* core functions of the software, including but not limited to those affording
;* compatibility with other hardware or software environments, but excluding
;* applications which incorporate this software. Users further agree to use
;* their best efforts to return to Digital any such changes, enhancements or
;* extensions that they make and inform Digital of noteworthy uses of this
;* software. Correspondence should be provided to Digital at:
;*
;* Director of Licensing
;* Western Research Laboratory
;* Digital Equipment Corporation
;* 100 Hamilton Avenue
;* Palo Alto, California 94301
;*
;* This software may be distributed (but not offered for sale or transferred
;* for compensation) to third parties, provided such third parties agree to
;* abide by the terms and conditions of this notice.
;*
;* THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
;* WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
;* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT
;* CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
;* DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
;* PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
;* ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
;* SOFTWARE.
This is the root directory for the Scheme-to-C compiler which was done at
Digital Equipment Corporation's Western Research Laboratory. The compiler
distribution consists of several directories:
doc contains documentation:
index.mss a Scribe reference document for the language
which is in the form of an annoted index to
the Revised**3 Scheme standard.
index.psf Postscript for index.mss.
intro.mss a Scribe document introducing Scheme->C.
intro.psf Postscript for intro.mss.
scc.l UNIX man page for the Scheme->C compiler.
sci.l UNIX man page for the Scheme->C interpreter.
gnuemacs contains emacs lisp code
scrt contains the runtime system.
scsc contains the compiler.
test contains compiler and runtime test programs.
cdecl a C declaration compiler written in Scheme.
xlib X11 Xlib stubs for Scheme->C.
In order to install the compiler and interpreter on a system, the following
steps must be done.
1. Verify that this directory contains the previously mentioned directories.
2. Edit the makefile in this directory so that the directory definitions
at the head of the file are correct for your installation:
SRCDIR full name of this directory
MIPSDIR full name of the directory that should be used to build
Scheme->C for a DECstation 3100.
VAXDIR full name of the directory that should be used to build
Scheme->C for a VAX.
The other definitions need not be changed.
2. Create directories for a specific processor. For a VAX this is done
by:
1 >make forVAX
and for a DECstation 3100, this is done by:
1 >make forMIPS
3. Build Scheme->C for a specific processor. For a VAX this is done
by:
2 >cd VAXDIR (defined in step 2)
3 >make port
and for a DECstation 3100, this is done by:
2 >cd MIPSDIR (defined in step 2)
3 >make port
N.B. During the compilation of scrt/signal.c on DECstations, you may get
the warning: "cpp: warning /usr/include/mips/cpu.h:504: CONS redefined".
This warning can be ignored.
4. Verify that the interpreter and compiler were correctly built:
4 >cd test
5 >../scrt/sci
SCHEME->C -- ...
> (load "test51.sc")
MODULE form ignored
TEST51
"test51.sc"
> (test51 '())
Hello world!
#F
> ^D
6 >make test51
../scsc/sccomp -schf ../scsc/sccomp.heap -C test51.sc
test51.sc:
../scsc/sccomp -schf ../scsc/sccomp.heap -c -g test51.c
cc -o test51 -g test51.o ../scrt/libsc.a -lm
7 >test51
Hello world!
5. Install the libraries, compiler, and interpreter in some directory
such as ~/bin:
8 >cd ..
9 >make "destdir = /udir/`whoami`/bin" install-private
10 >rehash
Given that this directory in the current search path, the compiler can
now be accessed by "scc" and the interpreter by "sci".
N.B. Users of DECstations will see two or three sequences of error messages
ending with "*** Error code 1 (ignored)." These errors may be ignored.
6. At this point, the source in cdecl and xlib can now be compiled as
desired.
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.