1GUILE(1) GNU Guile 2.0 GUILE(1)
2
6 guile - The GNU Project Extension Language
7
9 guile [-L DIRECTORY] [-l FILE] [-e FUNCTION] [\] [-c EXPR] [-s SCRIPT]
10 [--] [SCRIPT [ARGs for SCRIPT]]
11 Only the most useful options are listed here; see below for the remain‐
13 der.
14
16 GNU Guile is an implementation of the Scheme programming language. It
17 extends the R5RS and R6RS language standards, providing additional fea‐
18 tures necessary for real-world use.
19 Guile works well for interactive use, basic scripting, and extension of
21 larger applications, as well as for stand-alone Scheme application
22 development.
23 The guile executable itself provides a stand-alone interactive compiler
25 and run-time for Scheme programs, both for interactive use and for exe‐
26 cuting Scheme scripts or programs.
27 This manual page provides only brief instruction in invoking guile from
29 the command line. Please consult the Guile info documentation for more
30 information, (type info "(guile)Invoking Guile" at a command prompt).
31
33 -L DIRECTORY
34 Add DIRECTORY to the front of Guile's module load path.
35 -l FILE
37 Load Scheme source code from FILE.
38 -e FUNCTION
40 After reading SCRIPT, apply FUNCTION to command-line arguments.
41 Note that FUNCTION is evaluated, so, for example, (@ (my-module)
42 my-proc) is valid here.
43 \ The "meta switch", used to work around limitations in #!
45 scripts. See "The Meta Switch" in the texinfo documentation for
46 more details.
47 -- Stop argument processing, and start guile in interactive mode.
49 -c EXPR
51 Stop argument processing, and evaluate EXPR as a Scheme expres‐
52 sion.
53 -s SCRIPT-FILE
55 Load Scheme source from SCRIPT-FILE and execute as a script.
56 Note that in many cases it is not necessary to use -s; one may
57 invoke guile simply as guile SCRIPT-FILE ARG...
58 -ds Carry out -s SCRIPT at this point in the option sequence. Note
60 that this argument must be used in conjunction with -s.
61 --debug
63 Start guile with the debugging VM. By default, debugging is on
64 when guile is invoked interactively; it is off otherwise.
65 --no-debug
67 Start guile without the debugging VM, even if guile is being run
68 interactively.
69 --auto-compile
71 Compile source files automatically (default behavior).
72 --no-auto-compile
74 Disable automatic source file compilation.
75 --listen[=P]
77 Listen on a port or socket for remote REPL connections. See the
78 manual for more details.
79 --use-srfi=N,M...
81 Load SRFI extensions N, M, etc. For example,
82 --use-srfi=8,13.
83 -x EXTENSION
85 Add EXTENSION to the guile load extension list.
86 -h, --help
88 Describe command-line options and exit.
89 -v, --version
91 Display guile version and exit.
92 -q In interactive mode, suppress loading the user's initialization
94 file, ~/.guile.
95
97 GUILE_LOAD_PATH
98 If $GUILE_LOAD_PATH is set before guile is started, its value is
99 used to augment the path to search for Scheme files when load‐
100 ing. It should be a colon-separated list of directories, which
101 will be prefixed to the default %load-path.
102 GUILE_LOAD_COMPILED_PATH
104 If $GUILE_LOAD_COMPILED_PATH is set before guile is started, its
105 value is used to augment the path to search for compiled Scheme
106 files (.go files) when loading. It should be a colon-separated
107 list of directories, which will be prefixed to the default
108 %load-compiled-path.
109
111 ~/.guile
112 A Guile script that is executed before any other processing
113 occurs. For example, the following .guile activates guile's
114 readline interface:
115 (use-modules (ice-9 readline))
117 (activate-readline)
118
120 The full documentation for Guile is maintained as a Texinfo manual. If
121 the info and guile programs are properly installed at your site, the
122 command
123 info guile
125 should give you access to the complete manual.
127 http://www.schemers.org provides a general introduction to the Scheme
129 language.
130
132 There is a mailing list, bug-guile@gnu.org, for reporting Guile bugs
133 and fixes. But before reporting something as a bug, please try to be
134 sure that it really is a bug, not a misunderstanding or a deliberate
135 feature. We ask you to read the section ``Reporting Bugs'' in the
136 Guile reference manual (or Info system) for hints on how and when to
137 report bugs. Also, include the version number of the Guile you are
138 running in every bug report that you send in. Bugs tend actually to
139 get fixed if they can be isolated, so it is in your interest to report
140 them in such a way that they can be easily reproduced.
141
143 Copyright (C) 2010, 2011 Free Software Foundation, Inc.
144 Permission is granted to make and distribute verbatim copies of this
146 document provided the copyright notice and this permission notice are
147 preserved on all copies.
148 Permission is granted to copy and distribute modified versions of this
150 document under the conditions for verbatim copying, provided that the
151 entire resulting derived work is distributed under the terms of a per‐
152 mission notice identical to this one.
153 Permission is granted to copy and distribute translations of this docu‐
155 ment into another language, under the above conditions for modified
156 versions, except that this permission notice may be stated in a trans‐
157 lation approved by the Free Software Foundation.
158
160 Robert Merkel <rgmerk@mira.net> wrote this manpage. Rob Browning
161 <rlb@cs.utexas.edu> has added to it.
162 guile is GNU software. Guile is originally based on Aubrey Jaffer's
164 SCM interpreter, and is the work of many individuals.
165GNU 2011-03-04 GUILE(1)