1 .\" Written by Robert Merkel (rgmerk@mira.net)
2 .\" augmented by Rob Browning <rlb@cs.utexas.edu>
3 .\" Process this file with
4 .\" groff -man -Tascii foo.1
6 .\" title section date source manual
7 .TH GUILE 1 "2011-03-04" GNU "GNU Guile 2.0"
10 guile \- The GNU Project Extension Language
28 .RI [\| ARGs\ for\ SCRIPT \|]\c
31 Only the most useful options are listed here;
32 see below for the remainder.
35 GNU Guile is an implementation of the Scheme programming language.
36 It extends the R5RS and R6RS language standards,
37 providing additional features necessary for real-world use.
39 Guile works well for interactive use,
41 and extension of larger applications,
42 as well as for stand-alone Scheme application development.
46 executable itself provides a stand-alone interactive compiler and
47 run-time for Scheme programs,
48 both for interactive use and for executing Scheme scripts or programs.
50 This manual page provides only brief instruction in invoking
52 from the command line.
53 Please consult the Guile info documentation for more information,
54 (type \fB info "(guile)Invoking Guile"\fR at a command prompt).
59 Add \fIDIRECTORY\fR to the front of Guile's module load path.
63 Load Scheme source code from \fIFILE\fR.
67 After reading \fISCRIPT\fR, apply \fIFUNCTION\fR to command-line arguments.
68 Note that \fIFUNCTION\fR is evaluated,
70 .B (@ (my-module) my-proc)
75 The "meta switch", used to work around limitations in #! scripts.
76 See "The Meta Switch" in the texinfo documentation for more details.
80 Stop argument processing, and start
86 Stop argument processing,
87 and evaluate \fIEXPR\fR as a Scheme expression.
91 Load Scheme source from \fISCRIPT-FILE\fR and execute as a script.
92 Note that in many cases it is not necessary to use \fB-s\fR;
101 Carry out \fB\-s \fISCRIPT\fR at this point in the option sequence.
102 Note that this argument must be used in conjunction with \fB\-s\fR.
108 with the debugging VM.
109 By default, debugging is on when
111 is invoked interactively;
118 without the debugging VM,
121 is being run interactively.
125 Compile source files automatically (default behavior).
129 Disable automatic source file compilation.
132 \fB\-\-listen\fR[=\fIP\fR]
133 Listen on a port or socket for remote REPL connections.
134 See the manual for more details.
137 \fB\-\-use\-srfi\fR=\fIN,M\fR...
138 Load SRFI extensions \fIN\fR, \fIM\fR, etc.
140 \fB \-\-use\-srfi\fR=\fI8,13\fR.
144 Add \fIEXTENSION\fR to the
149 \fB\-h\fR, \fB\-\-help\fR
150 Describe command-line options and exit.
153 \fB\-v\fR, \fB\-\-version\fR
154 Display guile version and exit.
159 suppress loading the user's initialization file,
163 .\".TP \w'MANROFFSEQ\ \ 'u
167 .RB $ GUILE_LOAD_PATH
171 its value is used to augment the path to search for Scheme files when
173 It should be a colon-separated list of directories,
174 which will be prefixed to the default
177 .B GUILE_LOAD_COMPILED_PATH
179 .RB $ GUILE_LOAD_COMPILED_PATH
183 its value is used to augment the path to search for compiled
184 Scheme files (.go files) when loading.
185 It should be a colon-separated list of directories,
186 which will be prefixed to the default
187 .B %load-compiled-path.
192 A Guile script that is executed before any other processing occurs.
193 For example, the following
195 activates guile's readline interface:
198 .B (use-modules (ice-9 readline))
200 .B (activate-readline)
203 The full documentation for Guile is maintained as a Texinfo manual.
208 programs are properly installed at your site,
213 should give you access to the complete manual.
215 http://www.schemers.org provides a general introduction to the
219 There is a mailing list,
221 for reporting Guile bugs and fixes.
222 But before reporting something as a bug,
223 please try to be sure that it really is a bug,
224 not a misunderstanding or a deliberate feature.
225 We ask you to read the section ``Reporting Bugs'' in the Guile reference
226 manual (or Info system) for hints on how and when to report bugs.
227 Also, include the version number of the Guile you are running in every bug
228 report that you send in.
229 Bugs tend actually to get fixed if they can be isolated,
230 so it is in your interest to report them in such a way that they can be
234 Copyright (C) 2010, 2011 Free Software Foundation, Inc.
236 Permission is granted to make and distribute verbatim copies of this
237 document provided the copyright notice and this permission notice are
238 preserved on all copies.
240 Permission is granted to copy and distribute modified versions of this
241 document under the conditions for verbatim copying,
242 provided that the entire resulting derived work is distributed under the
243 terms of a permission notice identical to this one.
245 Permission is granted to copy and distribute translations of this
246 document into another language,
247 under the above conditions for modified versions,
248 except that this permission notice may be stated in a
249 translation approved by the Free Software Foundation.
252 Robert Merkel <rgmerk@mira.net> wrote this manpage.
253 Rob Browning <rlb@cs.utexas.edu> has added to it.
257 Guile is originally based on Aubrey Jaffer's SCM interpreter,
258 and is the work of many individuals.