; FILE "ReadMeFirst" ; IMPLEMENTS Documentation/release-notes for the Gambit Scheme system version 1.8 for AmigaDOS 1.3/2.04, Motorola 68020/30/40. ; AUTHOR This document: Ken Dickey; The system: Marc Feeley. ; LAST UPDATED 1992 October 31 This is the complete Amiga sources and binaries for the Gambit Scheme System (GSS) by Marc Feeley. The Scheme sources here have been compiled with Gambit and the C sources with the Lattice (now SAS) compiler v5.04 using the 1.3 includes. It has been tested under 1.3 and 2.04 with an Amiga 2000 using a GVP '030 upgrade and on various 500, 2000, and 3000 systems. GSS implements the full IEEE Scheme Standard (P1178) with extensions (see below). An interpreter (gsi) and compiler are included. The compiler requires a 3MB Amiga minimum to do effective development, but generates very fast native 680x0 code. The interpreter runs in about 1.5 MB. You can link Scheme and C code, call C code from Scheme, and create stand-alone executable programs. This is shareware, folks (see Notes, below). However, for a high quality native-code compiler with source the price--$40--is not bad. Mark has put man years of work into this system and a check from a serious user will help keep him motivated to keep improving the compiler and runtime system. {note, send checks to Marc, not to me. I am doing this because I think that Gambit is neat and to thank Marc for making it available --Ken} DISTRIBUTION FILES lharc -- use to unarcive files: lharc -r -x x gscompiler.lha gscompiler.lha -- Gambit compiler & interpreter with sources. ReadMeFirst -- this file more -- used to read this file DISK and DIRECTORY STRUCTURE If you have a hard disk, make a directory, Gambit > makedir hd0:Gambit > cd hd0:Gambit > lharc -r -x x GambitCompiler1.8:gscompiler.lha FILES bin (dir) gcv glk gsi docs (dir) benchmarks build.doc compiler.doc Contents Contents.info gsi.man loadcompiler.scm OO-Scheme.YASOS pvm QuickTour ReadMeFirst repr scheme-refs SchemeIntro sources (dir) loader (dir) compile-runtime.68020 compile.68000+emul compile.68020+FPU convert-runtime emul.c emul.h ext.c ext_amiga.c ext_unix.c gambit.h gc.c gc.h link-full link-full.emu link-r4 link-r4.small link-r4.small.emu link-short link-short.emu link.h link_me.c load.c load.h main.c main.h mem.c mem.h opcodes.h os.c os.h os_amiga.c os_unix.c params.h r4.gsi r4_link.c r4_link_small.c run.c run.h short_link.c stats.c stats.h strings.c strings.h struct.h temp1 compiler (dir) back.scm env.scm front.scm host.scm parms.scm ptree1.scm ptree2.scm pvm.scm scheme.scm source.scm target-m68000-1.scm target-m68000-2.scm target-m68000-3.scm utils.scm interpreter (dir) macros (dir) expand.scm loadmacros.scm misc.scm syntaxenv.scm syntaxrules.scm test.scm usual.scm utils.scm config.scm gsi.scm header.scm _errors.scm _eval.scm _multi.scm _nonstandard.scm _numbers.scm _ports.scm _r4rsSyntax.scm _repr.scm _standard.scm _system.scm tools (dir) gcv.c glk.c objects (dir) ;; compiled files (gambit compiled scheme code) compiler (dir) back.O env.O format.scm front.O gsc.O gsc.scm gsi.scm host.O init.O init.scm loadcompiler.scm loadcompiler.scm.info parms.O ptree1.O ptree2.O pvm.O scheme.O source.O target-m68000-1.O target-m68000-2.O target-m68000-3.O utils.O interpreter (dir) gsi.O _errors.O _kernel.O _multi.O _nonstandard.O _numbers.O _ports.O _r4rsSyntax.O _repr.O _standard.O _syntax_eval.O _system.O USAGE Copy bin/#? to your C: directory. Invoke from the comand line as "gsi" {see gsi.man, QuickTour, & compiler.doc} OTHER DOCS QuickTour -- A Quick tour of the Gambit intepreter (Read This) build.doc -- how to build stand-alone executables compiler.doc -- how to use the compiler gsi.man -- man page for the interpreter (options & debug commands) pvm -- Gambit Portable Virtual Machine specification repr -- Gambit runtime REPResentations benchmarks -- comparison with T (YALE) and LIAR (MIT) compilers scheme-refs -- Books on Scheme SchemeIntro -- An introduction to the Scheme Programming Language OO-Scheme.YASOS -- OO Scheme: Yet Anothe Scheme Object System loadcompiler.scm -- Code to load compiler files into the interpreter SCHEME EXTENSIONS The ##System function allows you to exec calls; e.g. (##system "dir"). Futurs are supported. The full numeric tower, including rationals, bignums, and complex math is supported: (sqrt -4) -> +2i . Tracing and interactive debugging are also provided (see QuickTour). ; NOTES At the present time, GSS only runs on M680x0 based computers (including M68000 to M68040). GSS has been tested on SUN-3, HP9000/3xx, NeXT, Amiga and BBN GP1000 (Butterfly) computers. A variant of GSS has also been ported to the Macintosh. All Gambit code Copyright (C) 1992 by Marc Feeley. Interpreter requires a 1.5MB and is ShareWare $20. The Compiler require a 2.5 MB Amiga and a hard disk. The compiler and all sources are ShareWare $40. Marc's address is: Marc Feeley 3260 Ridgewood Avenue, Montreal, Quebec, Canada H3V 1B8 Amiga bugs and suggestions to Ken Dickey: kend@data.rain.com 14565 SW McFarland, Tigard, OR, USA 97223 ;; --- E O F --- ;;