1GUILE(1) General Commands Manual GUILE(1)
2
3
4
6 guile - a Scheme interpreter
7
9 guile [-q] [-ds] [--help] [--version] [--emacs] [--debug] [-l FILE] [-e
10 FUNCTION] [] [-c EXPR] [-s SCRIPT] [--]
11
13 GNU Guile is an interpreter for the Scheme programming language. It
14 implements R5RS, providing additional features necessary for real-world
15 use. It is extremely simple to embed guile into a C program, calling C
16 from Scheme and Scheme from C. Guile's design makes it very suitable
17 for use as an "extension" or "glue" language, but it also works well as
18 a stand-alone scheme development environment.
19
20 The guile executable itself provides a stand-alone interpreter for
21 scheme programs, for either interactive use or executing scripts.
22
23 This manpage provides only brief instruction in invoking guile from the
24 command line. Please consult the guile info documentation (type info
25 guile at a command prompt) for more information. There is also a tuto‐
26 rial (info guile-tut) available.
27
28
30 -l Load scheme source code from file.
31
32 -e After reading script, apply FUNCTION to command-line arguments
33
34 -ds do -s SCRIPT at this point (note that this argument must be used
35 in conjuction with -s)
36
37 --help Describe command line options and exit
38
39 --debug
40 Start guile with debugging evaluator and backtraces enabled
41 (useful for debugging guile scripts)
42
43 --version
44 Display guile version and exit.
45
46 --emacs
47 Enable emacs protocol for use from within emacs (experimental)
48
49 -- Stop argument processing, start guile in interactive mode.
50
51 -c Stop argument processing, evaluate EXPR as a scheme expression.
52
53 -s Load Scheme source from SCRIPT-FILE and execute as a script.
54
55
57 GUILE_LOAD_PATH
58 If $GUILE_LOAD_PATH is set, its value is used to agument the
59 path to search for scheme files when loading. It should be a
60 colon separated list of directories which will be prepended to
61 the default %load-path.
62
63
65 ~/.guile is a guile script that is executed before any other processing
66 occurs. For example, the following .guile activates guile's readline
67 interface:
68
69 (use-modules (ice-9 readline))
70 (activate-readline)
71
72
74 The full documentation for guile is maintained as a Texinfo manual. If
75 the info and guile programs are properly installed at your site, the
76 command
77
78 info guile
79
80 should give you access to the complete manual.
81
82 http://www.schemers.org provides a general introduction to the Scheme
83 language.
84
85
87 Robert Merkel <rgmerk@mira.net> wrote this manpage. Rob Browning
88 <rlb@cs.utexas.edu> has added to it.
89
90 guile is GNU software. Guile is originally based on Aubrey Jaffer's
91 SCM interpreter, and is the work of many individuals.
92
93
94
95 GUILE(1)