1GSI/GSC(1) User Commands GSI/GSC(1)
2
3
4
6 gsi - Gambit-C Scheme Interpreter and Compiler
7
9 gsi [ -:arg,... ] [ -f ] [ -v ] [[-] [ -e ] [ file ]]...
10 gsc [options] [files]
11
12 gsc-script, gsi-script, scheme-ieee-1178-1990, scheme-r4rs, scheme-
13 srfi-0, six, and six-script: currently synonyms for gsi.
14
15 scheme-r5rs is registered in the Debian alternatives system and can be
16 configured to point at gsi.
17
18
20 This manual page briefly documents the gsi and gsc commands.
21
22 The Gambit-C programming system is a full implementation of the Scheme
23 language which conforms to the R4RS, R5RS, and IEEE Scheme standards.
24 It consists of two main programs: gsi, the Gambit Scheme interpreter,
25 and gsc, the Gambit Scheme compiler. The interpreter provides an
26 interactive environment with a debugger, while the compiler can produce
27 stand-alone executables or modules which can be linked or loaded at run
28 time. Interpreted code and compiled code can be freely mixed. C mod‐
29 ules can be linked with Scheme modules.
30
31 The interpreter is executed in interactive mode when no file or `-' or
32 `-e' option is given on the command line. When at least one file or
33 `-' or `-e' option is present the interpreter is executed in batch
34 mode.
35
36 Entering ,q or (exit) at the interpreter's command prompt will exit the
37 interpreter.
38
39 Entering ,? at the interpreter's command prompt will display a list of
40 special commands.
41
42 In batch mode the command line arguments denote files to be loaded,
43 REPL interactions to start (`-' option), and expressions to be evalu‐
44 ated (`-e' option). Note that the `-' and `-e' options can be inter‐
45 spersed with the files on the command line and can occur multiple
46 times. The interpreter processes the command line arguments from left
47 to right, loading files with the `load' procedure and evaluating
48 expressions with the `eval' procedure in the global interaction envi‐
49 ronment. After this processing the interpreter exits.
50
51 gsc-cc-o.bat is a script called by gsc to generate object files during
52 compilation. It takes its data from environment variables and is not
53 intended for user interaction.
54
55
57 A summary of options is included below. For a complete description,
58 see the Info files.
59
60 - Initiate a REPL at this point. (Continue by issuing a ,c command
61 at the interpreter prompt)
62
63 -: Comma separated list of run-time options
64
65 -e Evaluate an expression.
66
67 -f Skip initialization file.
68
69 -v Show version of program.
70
72 The documentation for these programs is arguably too extensive to cover
73 with man pages. Only the common command line options are given here.
74 The programs are documented fully in Gambit-C, available on-line at the
75 Gambit-C Homepage. Once package gambc-doc is installed, this 200+ page
76 document is available via the Info system (info gambit-c), in html via
77 doc-base, or as files in /usr/share/doc/gambc (html, pdf, txt).
78
79
80 The Debian package r5rs-doc provides the Revised(5) Report on the Algo‐
81 rithmic Language Scheme in several formats. That document is the
82 defining description of the programming language Scheme.
83
84 dhelp(1), gcc(1), update-alternatives(8)
85
87 Gambit-C is Copyright (c) 1994-2009 by Marc Feeley, all rights
88 reserved.
89
90 Gambit-C is released under a dual LGPL and Apache 2 license.
91 For further information refer to /usr/share/doc/gambc/copyright.
92
93 This manual page is
94 Copyright (c) 2006-2009 Marc Feeley and Kurt B. Kaiser <kbk@shore.net>
95 Released under the same license as Gambit-C.
96
97
99 Gambit-C was written by Marc Feeley <gambit@iro.umontreal.ca>.
100
101 Homepage: http://gambit.iro.umontreal.ca
102
103
104
1054.4.3 June 3, 2009 GSI/GSC(1)