NAME

SYNOPSIS

Only the most useful options are listed here; see below for the remainder.

DESCRIPTION

Guile works well for interactive use, basic scripting, and extension of larger applications, as well as for stand-alone Scheme application development.

The guile executable itself provides a stand-alone interactive compiler and run-time for Scheme programs, both for interactive use and for executing Scheme scripts or programs.

This manual page provides only brief instruction in invoking guile from the command line. Please consult the Guile info documentation for more information, (type info "(guile)Invoking Guile" at a command prompt).

OPTIONS

-L DIRECTORY

Add DIRECTORY to the front of Guile's module load path.

-l FILE

Load Scheme source code from FILE.

-e FUNCTION

After reading SCRIPT, apply FUNCTION to command-line arguments. Note that FUNCTION is evaluated, so, for example, (@ (my-module) my-proc) is valid here.

\

The "meta switch", used to work around limitations in #! scripts. See "The Meta Switch" in the texinfo documentation for more details.

--

Stop argument processing, and start guile in interactive mode.

-c EXPR

Stop argument processing, and evaluate EXPR as a Scheme expression.

-s SCRIPT-FILE

Load Scheme source from SCRIPT-FILE and execute as a script. Note that in many cases it is not necessary to use -s; one may invoke guile simply as guile SCRIPT-FILE ARG...

-ds

Carry out -s SCRIPT at this point in the option sequence. Note that this argument must be used in conjunction with -s.

--debug

Start guile with the debugging VM. By default, debugging is on when guile is invoked interactively; it is off otherwise.

--no-debug

Start guile without the debugging VM, even if guile is being run interactively.

--auto-compile

Compile source files automatically (default behavior).

--no-auto-compile

Disable automatic source file compilation.

--listen[=P]

Listen on a port or socket for remote REPL connections. See the manual for more details.

--use-srfi=N,M...

Load SRFI extensions N, M, etc. For example, --use-srfi=8,13.

-x EXTENSION

Add EXTENSION to the guile load extension list.

-h, --help

Describe command-line options and exit.

-v, --version

Display guile version and exit.

-q

In interactive mode, suppress loading the user's initialization file, ~/.guile.

ENVIRONMENT

GUILE_LOAD_PATH

If $GUILE_LOAD_PATH is set before guile is started, its value is used to augment the path to search for Scheme files when loading. It should be a colon-separated list of directories, which will be prefixed to the default %load-path.

GUILE_LOAD_COMPILED_PATH

If $GUILE_LOAD_COMPILED_PATH is set before guile is started, its value is used to augment the path to search for compiled Scheme files (.go files) when loading. It should be a colon-separated list of directories, which will be prefixed to the default %load-compiled-path.

FILES

~/.guile

A Guile script that is executed before any other processing occurs. For example, the following .guile activates guile's readline interface:

SEE ALSO

info guile

should give you access to the complete manual.

http://www.schemers.org provides a general introduction to the Scheme language.

REPORTING BUGS

COPYING

Permission is granted to make and distribute verbatim copies of this document provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this document under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this document into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.

AUTHORS

guile is GNU software. Guile is originally based on Aubrey Jaffer's SCM interpreter, and is the work of many individuals.