Load each file of a system into the Lisp image if either the file has not been loaded, or the file has been written since it was last loaded.
A symbol representing the name of the system. The system must have been defined using the defsystem macro.
If
t
then all the files in the system are loaded regardless. (This argument was formerly called
force-p
. The old name is currently still accepted for compatibility.)
If
nil
or not present then
load-system
works silently. Otherwise a plan of the actions which
load-system
intends to carry out is printed. What happens next depends on the value of
simulate
:
:ask
-- you are asked, using
y-or-n-p
, if you want to carry out the plan.
:each
--
load-system
displays each action in the plan one at a time, and asks you if you want to carry out this particular action. The answer executes the rest of the plan without further prompting,
e
returns from
load-system
without further processing, and
y
and
n
work as expected.
If
t
the source files of the system are loaded. This only applies to file types where it makes sense to load a source file.
This is the directory to search for the object files. If the object file cannot be found here then the source file from the system's default directory are loaded.
For Lisp files
load-system
loads the object file (if it exists) into the image, unless over-ridden by the
:source-only
keyword argument. This behavior can be changed so that the newest file (whether source or object) is loaded by setting the variable
*load-source-if-newer*
to
t
.
C source files, for example
foo.c
, can be included in a system (see the use of
:default-type
and
:type
in defsystem). The corresponding object file name is
foo.so
on Linux, and on Unix it is
foo
n
.o
where
n
is a platform-specific integer. On Windows the object file name is
foo.dll
.