NAME¶
gsi - Gambit-C Scheme Interpreter and Compiler
SYNOPSIS¶
gsi [ -
:arg,... ] [
-f ] [
-v ] [[-] [
-e ] [
file ]]...
gsc [
options] [
files]
gsc-script, gsi-script, scheme-ieee-1178-1990, scheme-r4rs,
scheme-srfi-0, six, and
six-script: currently synonyms for
gsi.
scheme-r5rs is registered in the Debian alternatives system and can be
configured to point at
gsi.
DESCRIPTION¶
This manual page documents briefly the
gsi and
gsc commands.
The
Gambit-C programming system is a full implementation of the Scheme
language which conforms to the R4RS, R5RS, and IEEE Scheme standards. It
consists of two main programs:
gsi, the Gambit Scheme interpreter, and
gsc, the Gambit Scheme to C compiler. The interpreter provides an
interactive environment with a debugger, while the compiler can produce
stand-alone executables or modules which can be linked or loaded at run time.
Interpreted code and compiled code can be freely mixed. C modules can be
linked with Scheme modules.
The interpreter is executed in
interactive mode when no file or `-' or
`-e' option is given on the command line. When at least one file or `-' or
`-e' option is present the interpreter is executed in
batch mode.
Entering
,q or (exit) at the interpreter's command prompt will exit the
interpreter.
In
batch mode the command line arguments denote files to be loaded, REPL
interactions to start (`-' option), and expressions to be evaluated (`-e'
option). Note that the `-' and `-e' options can be interspersed with the files
on the command line and can occur multiple times. The interpreter processes
the command line arguments from left to right, loading files with the `load'
procedure and evaluating expressions with the `eval' procedure in the global
interaction environment. After this processing the interpreter exits.
gsc-cc-o.bat is a script called by
gsc to generate object files
during compilation. It takes its data from environment variables and is not
intended for user interaction.
OPTIONS¶
A summary of options is included below. For a complete description, see the Info
files.
- -
- Initiate a REPL at this point. (Continue by issuing a ,(c 0)
command at the interpreter prompt)
- -:
- Comma separated list of run-time options
- -e
- Evaluate an expression.
- -f
- Skip initialization file.
- -v
- Show version of program.
SEE ALSO¶
The documentation for these programs is arguably too extensive to cover with man
pages. Only the common command line options are given here. The programs are
documented fully in
Gambit-C, available on-line at the Gambit-C
Homepage. Once package gambc-doc is installed, this 200+ page document is
available via the Info system (info gambit-c), in html via doc-base, or as
files in /usr/share/doc/gambc (html, pdf, txt).
The Debian package r5rs-doc provides the Revised(5) Report on the Algorithmic
Language Scheme in several formats. That document is the defining description
of the programming language Scheme.
dhelp(1), gcc(1), update-alternatives(8)
COPYRIGHT¶
Gambit-C is Copyright (C) 1994-2008 by Marc Feeley, all rights reserved.
Gambit-C is released under a dual LGPL and Apache 2 license.
For further information refer to /usr/share/doc/gambc/copyright.
This manual page is
Copyright (C) 2006-2008 Marc Feeley and Kurt B. Kaiser <kbk@shore.net>
Released under the same license as Gambit-C.
AUTHOR¶
Gambit-C was written by Marc Feeley <gambit@iro.umontreal.ca>.
Homepage:
http://www.iro.umontreal.ca/~gambit/