GUILE(1) GNU Guile 2.0 GUILE(1)NAMEguile - The GNU Project Extension Language
SYNOPSISguile [-L DIRECTORY] [-l FILE] [-e FUNCTION] [\] [-c EXPR] [-s SCRIPT]
[--] [SCRIPT [ARGs for SCRIPT]]
Only the most useful options are listed here; see below for the remain‐
der.
DESCRIPTION
GNU Guile is an implementation of the Scheme programming language. It
extends the R5RS and R6RS language standards, providing additional fea‐
tures necessary for real-world use.
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 exe‐
cuting 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 expres‐
sion.
-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-autocompile
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 load‐
ing. 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:
(use-modules (ice-9 readline))
(activate-readline)
SEE ALSO
The full documentation for Guile is maintained as a Texinfo manual. If
the info and guile programs are properly installed at your site, the
command
info guile
should give you access to the complete manual.
http://www.schemers.org provides a general introduction to the Scheme
language.
REPORTING BUGS
There is a mailing list, bug-guile@gnu.org, for reporting Guile bugs
and fixes. But before reporting something as a bug, please try to be
sure that it really is a bug, not a misunderstanding or a deliberate
feature. We ask you to read the section ``Reporting Bugs'' in the
Guile reference manual (or Info system) for hints on how and when to
report bugs. Also, include the version number of the Guile you are
running in every bug report that you send in. Bugs tend actually to
get fixed if they can be isolated, so it is in your interest to report
them in such a way that they can be easily reproduced.
COPYING
Copyright (C) 2010, 2011 Free Software Foundation, Inc.
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 per‐
mission notice identical to this one.
Permission is granted to copy and distribute translations of this docu‐
ment into another language, under the above conditions for modified
versions, except that this permission notice may be stated in a trans‐
lation approved by the Free Software Foundation.
AUTHORS
Robert Merkel <rgmerk@mira.net> wrote this manpage. Rob Browning
<rlb@cs.utexas.edu> has added to it.
guile is GNU software. Guile is originally based on Aubrey Jaffer's
SCM interpreter, and is the work of many individuals.
GNU 2011-03-04 GUILE(1)
