Warning: This is the manual of the legacy Guile 2.2 series. You may want to read the manual of the current stable series instead.
Next: R6RS Version References, Previous: Creating Guile Modules, Up: Modules [Contents][Index]
Typical programs only use a small subset of modules installed on a Guile system. In order to keep startup time down, Guile only loads modules when a program uses them, on demand.
When a program evaluates (use-modules (ice-9 popen)), and the
module is not loaded, Guile searches for a conventionally-named file
from in the load path.
In this case, loading (ice-9 popen) will eventually cause Guile
to run (primitive-load-path "ice-9/popen").
primitive-load-path will search for a file ice-9/popen in
the %load-path (see Load Paths). For each directory in
%load-path, Guile will try to find the file name, concatenated
with the extensions from %load-extensions. By default, this will
cause Guile to stat ice-9/popen.scm, and then
ice-9/popen. See Load Paths, for more on
primitive-load-path.
If a corresponding compiled .go file is found in the
%load-compiled-path or in the fallback path, and is as fresh as
the source file, it will be loaded instead of the source file. If no
compiled file is found, Guile may try to compile the source file and
cache away the resulting .go file. See Compilation, for more
on compilation.
Once Guile finds a suitable source or compiled file is found, the file will be loaded. If, after loading the file, the module under consideration is still not defined, Guile will signal an error.
For more information on where and how to install Scheme modules, See Installing Site Packages.