(guile.info.gz) Invoking Guile
Info Catalog
(guile.info.gz) Guile Scripting
(guile.info.gz) The Meta Switch
9.1 Invoking Guile
==================
Here we describe Guile's command-line processing in detail. Guile
processes its arguments from left to right, recognizing the switches
described below. For examples, see Scripting Examples.
`-s SCRIPT ARG...'
Read and evaluate Scheme source code from the file SCRIPT, as the
`load' function would. After loading SCRIPT, exit. Any
command-line arguments ARG... following SCRIPT become the script's
arguments; the `command-line' function returns a list of strings
of the form `(SCRIPT ARG...)'.
`-c EXPR ARG...'
Evaluate EXPR as Scheme code, and then exit. Any command-line
arguments ARG... following EXPR become command-line arguments; the
`command-line' function returns a list of strings of the form
`(GUILE ARG...)', where GUILE is the path of the Guile executable.
`-- ARG...'
Run interactively, prompting the user for expressions and
evaluating them. Any command-line arguments ARG... following the
`--' become command-line arguments for the interactive session; the
`command-line' function returns a list of strings of the form
`(GUILE ARG...)', where GUILE is the path of the Guile executable.
`-l FILE'
Load Scheme source code from FILE, and continue processing the
command line.
`-e FUNCTION'
Make FUNCTION the "entry point" of the script. After loading the
script file (with `-s') or evaluating the expression (with `-c'),
apply FUNCTION to a list containing the program name and the
command-line arguments -- the list provided by the `command-line'
function.
A `-e' switch can appear anywhere in the argument list, but Guile
always invokes the FUNCTION as the _last_ action it performs.
This is weird, but because of the way script invocation works under
POSIX, the `-s' option must always come last in the list.
Scripting Examples.
`-ds'
Treat a final `-s' option as if it occurred at this point in the
command line; load the script here.
This switch is necessary because, although the POSIX script
invocation mechanism effectively requires the `-s' option to
appear last, the programmer may well want to run the script before
other actions requested on the command line. For examples, see
Scripting Examples.
`\'
Read more command-line arguments, starting from the second line of
the script file. The Meta Switch.
`--emacs'
Assume Guile is running as an inferior process of Emacs, and use a
special protocol to communicate with Emacs's Guile interaction
mode. This switch sets the global variable use-emacs-interface to
`#t'.
This switch is still experimental.
`--use-srfi=LIST'
The option `--use-srfi' expects a comma-separated list of numbers,
each representing a SRFI number to be loaded into the interpreter
before starting evaluating a script file or the REPL.
Additionally, the feature identifier for the loaded SRFIs is
recognized by `cond-expand' when using this option.
guile --use-srfi=8,13
`--debug'
Start with the debugging evaluator and enable backtraces. Using
the debugging evaluator will give you better error messages but it
will slow down execution. By default, the debugging evaluator is
only used when entering an interactive session. When executing a
script with `-s' or `-c', the normal, faster evaluator is used by
default.
`-h, --help'
Display help on invoking Guile, and then exit.
`-v, --version'
Display the current version of Guile, and then exit.
Info Catalog
(guile.info.gz) Guile Scripting
(guile.info.gz) The Meta Switch
automatically generated byinfo2html