Provided by: scm_5e5-3.3_amd64 bug

NAME

       scm - a Scheme Language Interpreter

SYNOPSIS

       scm [-a kbytes ] [-muvqib] [--version] [--help]
       [[-]-no-init-file] [--no-symbol-case-fold]
       [-p int ] [-r feature ] [-h feature ]
       [-d filename ] [-f filename ] [-l filename ]
       [-c expression ] [-e expression ] [-o dumpname ]
       [-- | - | -s] [ filename ] [ arguments ...  ]

DESCRIPTION

       Scm is a Scheme interpreter.

       Upon  startup scm loads the file specified by by the environment variable SCM_INIT_PATH or
       by the parameter IMPLINIT in the makefile (or scmfig.h) if SCM_INIT_PATH is  not  defined.
       The makefiles attempt to set IMPLINIT to "Init.scm" in the source directory.

       Unless  the option -no-init-file or --no-init-file occurs in the command line or if scm is
       being invoked as a script, "Init.scm" checks to see if there is file "ScmInit.scm" in  the
       path  specified  by  the environment variable HOME (or in the current directory if HOME is
       undefined).  If it finds such a file, then it is loaded.

       "Init.scm" then looks for command input from one of three sources: From an option  on  the
       command line, from a file named on the command line, or from standard input.

OPTIONS

       The options are processed in the order specified on the command line.

       -akbytes
            specifies  that  scm  should allocate an initial heapsize of kbytes.  This option, if
            present, must be the first on the command line.

       --no-init-file
            Inhibits the loading of "ScmInit.scm" as described above.

       --no-symbol-case-fold
            Symbol (and identifier) names are case-sensitive.

       -eexpression

       -cexpression
            specifies that the scheme expression expression is to be  evaluated.   These  options
            are  inspired  by  perl  and sh respectively.  On Amiga systems the entire option and
            argument need to be enclosed in quotes.  For instance "-e(newline)".

       -rfeature
            requires feature.  This will load a file from SLIB if that  feature  is  not  already
            supported.   If  feature  is 2, 3, 4, or 5 scm will require the features necessary to
            support R2RS, R3RS, R4RS, or R5RS, respectively.

       -hfeature
            provides feature.

       -lfilename

       -ffilename
            loads filename.  Scm will load the first (unoptioned) file named on the command  line
            if no -c, -e, -f, -l, or -s option precedes it.

       -dfilename
            opens  (read-only)  the  extended relational database filename.  If filename contains
            initialization code, it will be run when the database is opened.

       -odumpname
            saves the current SCM session as the executable program dumpname.  This option  works
            only in SCM builds supporting dump.

            If  options appear on the command line after -o dumpname, then the saved session will
            continue with processing those options when  it  is  invoked.   Otherwise  the  (new)
            command line is processed as usual when the saved image is invoked.

       -plevel
            sets  the  prolixity  (verboseness)  to  level.   This is the same as the scm command
            (verbose level ).

       -v   (verbose mode) specifies that scm will print prompts,  evaluation  times,  notice  of
            loading files, and garbage collection statistics.  This is the same as -p3.

       -q   (quiet mode) specifies that scm will print no extra information.  This is the same as
            -p0.

       -m   specifies that subsequent loads, evaluations, and user interactions will be with R4RS
            macro  capability.  To use a specific R4RS macro implementation from SLIB (instead of
            SLIB's default) put -r macropackage before -m on the command line.

       -u   specifies that subsequent loads, evaluations, and user interactions will  be  without
            R4RS  macro  capability.  R4RS macro capability can be restored by a subsequent -m on
            the command line or from Scheme code.

       -i   specifies that scm should run interactively.  That means that scm will not  terminate
            until  the (quit) or (exit) command is given, even if there are errors.  It also sets
            the prolixity level to 2 if it is less than 2.  This will print  prompts,  evaluation
            times,  and  notice  of  loading files.  The prolixity level can be set by subsequent
            options.  If scm is started from a tty, it will assume that it should be  interactive
            unless given a subsequent -b option.

       -b   specifies  that scm should run non-interactively.  That means that scm will terminate
            after processing the command line or if there are errors.

       -s   specifies, by analogy with sh, that further options are  to  be  treated  as  program
            arguments.

       -    -- specifies that there are no more options on the command line.

ENVIRONMENT VARIABLES

       SCM_INIT_PATH
            is  the pathname where scm will look for its initialization code.  The default is the
            file "Init.scm" in the source directory.

       SCHEME_LIBRARY_PATH
            is the SLIB Scheme library directory.

       HOME is the directory  where  "Init.scm"  will  look  for  the  user  initialization  file
            "ScmInit.scm".

SCHEME VARIABLES

       *argv*
            contains  the  list  of  arguments to the program.  *argv* can change during argument
            processing.  This list is suitable for use as an argument to SLIB getopt.

       *R4RS-macro*
            controls whether loading  and  interaction  support  R4RS  macros.   Define  this  in
            "ScmInit.scm"  or  files  specified  on  the command line.  This can be overridden by
            subsequent -m and -u options.

       *interactive*
            controls interactivity as explained for the  -i  and  -b  options.   Define  this  in
            "ScmInit.scm"  or  files  specified  on  the command line.  This can be overridden by
            subsequent -i and -b options.

EXAMPLES

       % scm foo.scm arg1 arg2 arg3
            Load and execute the contents of foo.scm.  Parameters arg1 arg2 and arg3  are  stored
            in the global list *argv*.

       % scm -f foo.scm arg1 arg2 arg3
            The same.

       % scm -s foo.scm arg1 arg2
            Set *argv* to ("foo.scm" "arg1" "arg2") and enter interactive session.

       % scm -e '(display (list-ref *argv* *optind*))' bar
            Print ``bar''

       % scm -rpretty-print -r format -i
            Load pretty-print and format and enter interactive mode.

       % scm -r5
            Load dynamic-wind, values, and R4RS macros and enter interactive (with macros) mode.

       % scm -r5 -r4
            Like above but rev4-optional-procedures are also loaded.

FEATURES

       Runs  under  Amiga,  Atari-ST,  MacOS, MS-DOS, OS/2, NOS/VE, Unicos, VMS, Unix and similar
       systems.  Support for ASCII and EBCDIC character sets.

       Conforms to Revised^5 Report on  the  Algorithmic  Language  Scheme  and  the  IEEE  P1178
       specification.

       Support for SICP, R2RS, R3RS, and R4RS scheme code.

       Many  Common Lisp functions: logand, logor, logxor, lognot, ash, logcount, integer-length,
       bit-extract, defmacro, macroexpand, macroexpand1, gentemp, defvar, force-output, software-
       type,   get-decoded-time,   get-internal-run-time,   get-internal-real-time,  delete-file,
       rename-file, copy-tree, acons, and eval.

       Char-code-limit, most-positive-fixnum, most-negative-fixnum, and  internal-time-units-per-
       second constants.  *Features* and *load-pathname* variables.

       Arrays  and  bit-vectors.   String  ports  and  software  emulation ports.  I/O extensions
       providing most of ANSI C and POSIX.1 facilities.

       User definable responses to interrupts  and  errors,  Process-synchronization  primitives,
       String regular expression matching, and the CURSES screen management package.

       Available  add-on packages including an interactive debugger, database, X-window graphics,
       BGI graphics, Motif, and Open-Windows packages.

       A compiler (HOBBIT, available separately) and dynamic linking of compiled modules.

       Setable levels of monitoring and timing information printed interactively  (the  `verbose'
       function).  Restart, quit, and exec.

FILES

       scm.texi
              Texinfo  documentation  of  scm  enhancements, internal representations, and how to
              extend or include scm in other programs.

AUTHORS

       Aubrey Jaffer (jaffer @ alum.mit.edu)
       Radey Shouman (shouman @ ne.mediaone.net)

BUGS

SEE ALSO

       The SCM home-page:
       http://swissnet.ai.mit.edu/~jaffer/SCM.html

       The     Scheme     specifications     for     details     on      specific      procedures
       (http://swissnet.ai.mit.edu/ftpdir/scheme-reports/) or

       IEEE Std 1178-1990,
       IEEE Standard for the Scheme Programming Language,
       Institute of Electrical and Electronic Engineers, Inc.,
       New York, NY, 1991

       Brian Harvey and Matthew Wright
       Simply Scheme: Introducing Computer Science_
       MIT Press, 1994 ISBN 0-262-08226-8

       R. Kent Dybvig, The Scheme Programming Language,
       Prentice-Hall Inc, Englewood Cliffs, New Jersey 07632, USA

       H. Abelson, G. J. Sussman, and J. Sussman,
       Structure and Interpretation of Computer Programs,
       The MIT Press, Cambridge, Massachusetts, USA