NAME

       s2ci - Scheme interpreter

SYNTAX

       s2ci [ option ]

DESCRIPTION

       The  s2ci  command  (previously  known as sci) invokes a Scheme interpreter.  The language
       accepted by this interpreter is that defined in the essential  portions  of  the  Revised4
       Report on the Algorithmic Language Scheme, with minor constraints and some additions.  The
       Scheme interpreter is written in Scheme which has then been compiled using the Scheme-to-C
       compiler, s2cc.

OPTIONS

       These options are accepted by s2ci.

       -e             Echo text read from the standard input file on the standard output file.

       -emacs         Scheme interpreter is controlled by GNU emacs.

       -nh            Do not print the interpreter version header on the standard output file.

       -np            Do not prompt for input from the standard input file on the standard output
                      file.

       -q             Do not print the result of each expression evaluation.

       -scgc   statflag
                      Enables  garbage  collection  statistics.   If  set  to  1,  then   garbage
                      collection  statistics will be printed.  The default is 0, that will result
                      in no statistics.

       -sch  heap     Specifies the initial size of the heap in megabytes.  The default heap size
                      is 4 MB.  The maximum heap size allowed is 1000 MB.

       -scl percent   Specifies  the  percent  of the heap allocated after a generational garbage
                      collection that will force a full collection.  The default is 40%.

       -scm  main     Specifies the function that  should  be  used  instead  of  the  predefined
                      "main".   The  function  name  must  be  entered  in the correct case, i.e.
                      letters typically upshifted.

       -scmh  heap    Specifies the maximum heap size in megabytes.  The default  is  five  times
                      the initial size of the heap.

ENVIRONMENT VARIABLES

       The  items  controlled by -sc.. flags can also be controlled by environment variables.  If
       both the flag and the environment variable are provided, then the  flag's  value  will  be
       used.

       SCGCINFO       Controls  the  reporting  of  garbage collection statistics to the standard
                      error file.  If set to  1,  then  garbage  collection  statistics  will  be
                      printed.  The default setting is 0 that will not print the statistics.

       SCHEAP         Specifies the initial size of the heap in megabytes.  The default heap size
                      is 4 MB.  The maximum heap size allowed is 1000 MB.

       SCLIMIT        Specifies the percent of the heap allocated after  a  generational  garbage
                      collection that will force a full collection.  The default is 40%.

       SCMAXHEAP      Specifies  the maximum size of the heap in megabytes.  The default value is
                      five times the initial heap size.

FILES

       The interpreter is one a.out file with the name  s2ci.   All  files  associated  with  the
       interpreter are found in the directory .../schemetoc/scrt.

SEE ALSO

       Harold  Abelson and Gerald Jay Sussman with Julie Sussman, Structure and Interpretation of
       Computer Programs, The MIT Press.

       William Clinger and Jonathan Rees (Editors), Revised4 Report on the  Algorithmic  Language
       Scheme,  LISP  Pointers,  Volume  IV,  Number 3, July-September 1991.  PostScript for this
       report is included in the software distribution.

       Jerry D. Smith, An Introduction to Scheme, Prentice Hall, Inc.  Chapter  notes  for  using
       this text with Scheme->C are included in the software distribution.

       R. Kent Dybvig, The SCHEME Programming Language, Prentice Hall, Inc.

       Daniel P. Friedman and Matthias Felleisen, The Little LISPer, MIT Press.

       Joel F. Bartlett, Scheme->C  a Portable Scheme-to-C Compiler, WRL Research Report 89/1.

       Additional documentation is included in the software distribution.

       s2cc(1)

QUESTIONS, COMMENTS, AND COMPLAINTS

       http://alioth.debian.org/projects/scheme2c/

                                              local                                       S2CI(1)