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
8 guile \- a Scheme interpreter
10 .B guile [-q] [-ds] [--help] [--version] [--emacs] [--debug]
11 .B [-l FILE] [-e FUNCTION] [\]
12 .B [-c EXPR] [-s SCRIPT] [--]
14 GNU Guile is an interpreter for the Scheme programming language. It
15 implements R5RS, providing additional features
16 necessary for real-world use. It is extremely simple to embed guile
17 into a C program, calling C from Scheme and Scheme from C. Guile's
18 design makes it very suitable for use as an "extension" or "glue"
19 language, but it also works well as a stand-alone scheme development
24 executable itself provides a stand-alone interpreter for scheme
25 programs, for either interactive use or executing scripts.
27 This manpage provides only brief instruction in invoking
29 from the command line. Please consult the guile info documentation
32 at a command prompt) for more information. There is also a tutorial
38 Load scheme source code from file.
40 After reading script, apply FUNCTION to command-line arguments
42 do -s SCRIPT at this point (note that this argument must be used in
45 Describe command line options and exit
47 Start guile with debugging evaluator and backtraces enabled
48 (useful for debugging guile scripts)
50 Display guile version and exit.
52 Enable emacs protocol for use from within emacs (experimental)
54 Stop argument processing, start guile in interactive mode.
56 Stop argument processing, evaluate EXPR as a scheme expression.
58 Load Scheme source from SCRIPT-FILE and execute as a script.
61 .\".TP \w'MANROFFSEQ\ \ 'u
66 is set, its value is used to agument the path to search for scheme
67 files when loading. It should be a colon separated list of
68 directories which will be prepended to the default %load-path.
72 is a guile script that is executed before any other processing occurs.
73 For example, the following .guile activates guile's readline
77 (use-modules (ice-9 readline))
82 The full documentation for guile is maintained as a Texinfo manual. If
83 the info and guile programs are properly installed at your site, the
88 should give you access to the complete manual.
90 http://www.schemers.org provides a general introduction to the
94 Robert Merkel <rgmerk@mira.net> wrote this manpage.
95 Rob Browning <rlb@cs.utexas.edu> has added to it.
98 is GNU software. Guile is originally based on Aubrey Jaffer's
99 SCM interpreter, and is the work of many individuals.