1GUILE(1)                         GNU Guile 2.2                        GUILE(1)
2
3
4

NAME

6       guile - The GNU Project Extension Language
7

SYNOPSIS

9       guile  [-L DIRECTORY] [-l FILE] [-e FUNCTION] [\] [-c EXPR] [-s SCRIPT]
10       [--] [SCRIPT [ARGs for SCRIPT]]
11
12       Only the most useful options are listed here; see below for the remain‐
13       der.
14

DESCRIPTION

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
20       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
24       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
28       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

OPTIONS

33       -L DIRECTORY
34              Add DIRECTORY to the front of Guile's module load path.
35
36       -l FILE
37              Load Scheme source code from FILE.
38
39       -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
44       \      The  "meta  switch",  used  to  work  around  limitations  in #!
45              scripts.  See "The Meta Switch" in the texinfo documentation for
46              more details.
47
48       --     Stop argument processing, and start guile in interactive mode.
49
50       -c EXPR
51              Stop  argument processing, and evaluate EXPR as a Scheme expres‐
52              sion.
53
54       -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
59       -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
62       --debug
63              Start  guile with the debugging VM.  By default, debugging is on
64              when guile is invoked interactively; it is off otherwise.
65
66       --no-debug
67              Start guile without the debugging VM, even if guile is being run
68              interactively.
69
70       --auto-compile
71              Compile source files automatically (default behavior).
72
73       --no-auto-compile
74              Disable automatic source file compilation.
75
76       --listen[=P]
77              Listen on a port or socket for remote REPL connections.  See the
78              manual for more details.
79
80       --use-srfi=N,M...
81              Load SRFI extensions N, M, etc.  For example,
82               --use-srfi=8,13.
83
84       -x EXTENSION
85              Add EXTENSION to the guile load extension list.
86
87       -h, --help
88              Describe command-line options and exit.
89
90       -v, --version
91              Display guile version and exit.
92
93       -q     In interactive mode, suppress loading the user's  initialization
94              file, ~/.guile.
95

ENVIRONMENT

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
103       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

FILES

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
116                (use-modules (ice-9 readline))
117                (activate-readline)
118

SEE ALSO

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
124              info guile
125
126       should give you access to the complete manual.
127
128       http://www.schemers.org provides a general introduction to  the  Scheme
129       language.
130

REPORTING BUGS

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

COPYING

143       Copyright (C) 2010, 2011 Free Software Foundation, Inc.
144
145       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
149       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
154       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

AUTHORS

160       Robert  Merkel  <rgmerk@mira.net>  wrote  this  manpage.   Rob Browning
161       <rlb@cs.utexas.edu> has added to it.
162
163       guile is GNU software.  Guile is originally based  on  Aubrey  Jaffer's
164       SCM interpreter, and is the work of many individuals.
165
166
167
168GNU                               2011-03-04                          GUILE(1)
Impressum