GUILE(1)

💅 GUILE(1) — the GNU Project Extension Language ✨

okay bestie, listen. this is the manual page for guile, from GNU Guile 2.2, and I'm gonna walk you through it like we're texting at 2am. buckle up, it's giving iconic compiler energy 🎀

---

🌸 NAME 🌸

guile — The GNU Project Extension Language. that's it. that's the name. short, sweet, main character energy 👑

---

✨ SYNOPSIS ✨

guile [-L DIRECTORY] [-l FILE] [-e FUNCTION] [\] [-c EXPR] [-s SCRIPT]
[--] [SCRIPT [ARGs for SCRIPT]]

real talk: only the most useful options are listed up here, the rest are chilling down below in OPTIONS. don't come for me 💀

---

🦋 DESCRIPTION 🦋

GNU Guile is an implementation of the Scheme programming language, no cap. It extends the R5RS and R6RS language standards, and gives you extra features that you genuinely need for real-world use. it's the glow-up Scheme deserved 💖

Guile works well for interactive use, basic scripting, and extension of larger applications — and also for stand-alone Scheme application development. so basically it does everything, it's versatile like that 🌈

The guile executable itself is a stand-alone interactive compiler and run-time for Scheme programs, both for interactive use and for executing Scheme scripts or programs. it's the whole package, lowkey 🔥

This manual page provides only brief instruction in invoking guile from the command line. bestie, for the full lore you gotta consult the Guile info documentation — type

info "(guile)Invoking Guile"

at a command prompt and you're in 🫶

---

💅 OPTIONS 💅

• -L DIRECTORY — adds DIRECTORY to the front of Guile's module load path. front of the line, like the VIP section ✨
• -l FILE — load Scheme source code from FILE.
• -e FUNCTION — after reading SCRIPT, apply FUNCTION to the command-line arguments. heads up: FUNCTION gets evaluated, so for example (@ (my-module) my-proc) is valid here. yes, actually valid, no cap.
• \ — the "meta switch", used to work around limitations in #! scripts. see "The Meta Switch" in the texinfo documentation for more details. it's giving secret passage 🕵️
• -- — stop argument processing, and start guile in interactive mode.
• -c EXPR — stop argument processing, and evaluate EXPR as a Scheme expression.
• -s SCRIPT-FILE — load Scheme source from SCRIPT-FILE and execute as a script. note that in many cases you don't even need -s; you can just invoke guile as guile SCRIPT-FILE ARG.... we love a low-effort moment 💅
• -ds — carry out -s SCRIPT at this point in the option sequence. note that this argument must be used in conjunction with -s. they're a package deal, fr fr.
• --debug — start guile with the debugging VM. by default, debugging is on when guile is invoked interactively, and off otherwise.
• --no-debug — start guile without the debugging VM, even if guile is being run interactively.
• --auto-compile — compile source files automatically. this is the default behavior, so it's already slaying on its own 💖
• --no-auto-compile — disable automatic source file compilation.
• --listen[=P] — listen on a port or socket for remote REPL connections. see the manual for more details 👀
• --use-srfi=N,M... — load SRFI extensions N, M, etc. for example, --use-srfi=8,13.
• -x EXTENSION — add EXTENSION to the guile load extension list.
• -h, --help — describe command-line options and exit. our helpful king 🫶
• -v, --version — display guile version and exit.
• -q — in interactive mode, suppress loading the user's initialization file, ~/.guile. quiet mode, introvert behavior, we respect it 🙈

---

🌈 ENVIRONMENT 🌈

• GUILE_LOAD_PATH — if $GUILE_LOAD_PATH is set before guile is started, its value is used to augment the path to search for Scheme files when loading. it should be a colon-separated list of directories, which will be prefixed to the default %load-path.
• GUILE_LOAD_COMPILED_PATH — if $GUILE_LOAD_COMPILED_PATH is set before guile is started, its value is used to augment the path to search for compiled Scheme files (.go files) when loading. it should be a colon-separated list of directories, which will be prefixed to the default %load-compiled-path.

---

🎀 FILES 🎀

• ~/.guile — a Guile script that is executed before any other processing occurs. for example, this .guile activates guile's readline interface:

(use-modules (ice-9 readline))
(activate-readline)

look at that, setup before anything else even happens. organized queen 👑

---

🔥 SEE ALSO 🔥

The full documentation for Guile is maintained as a Texinfo manual. If the info and guile programs are properly installed at your site, the command

info guile

should give you access to the complete manual. ✨

http://www.schemers.org provides a general introduction to the Scheme language — go look, it's giving educational 🦋

---

😭 REPORTING BUGS 😭

There is a mailing list, bug-guile@gnu.org, for reporting Guile bugs and fixes. but bestie, before you report something as a bug, please try to be sure that it really is a bug — not a misunderstanding or a deliberate feature. 💀

We ask you to read the section ``Reporting Bugs'' in the Guile reference manual (or Info system) for hints on how and when to report bugs. also, include the version number of the Guile you are running in every bug report that you send in. bugs tend actually to get fixed if they can be isolated, so it is in your interest to report them in such a way that they can be easily reproduced. do it for you, not for them 💖

---

👑 COPYING 👑

Copyright (C) 2010, 2011 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of this document provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this document under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this document into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.

---

🌟 AUTHORS 🌟

Robert Merkel <rgmerk@mira.net> wrote this manpage. Rob Browning <rlb@cs.utexas.edu> has added to it. legends, both of them 🫶

guile is GNU software. Guile is originally based on Aubrey Jaffer's SCM interpreter, and is the work of many individuals. many hands, one iconic language 💜

---

and that's the whole page, bestie!! this one's from GNU, dated 2011-03-04, and it's GUILE(1) — go forth and Scheme responsibly ✨🎀💅