12 The LISPWORKS Package

compile-system

Function

Summary

The functioncompile-system compiles all the files in a system necessary to make a consistent set of object files.

Package

lispworks

Signature

compile-system system-name &key force simulate load args target-directory

Arguments

system-name

A symbol representing the name of the system. The system must have been defined already using thedefsystem macro.

force

Ift then all the files in the system are compiled regardless. (This argument was formerly called force-p. The old name is currently still accepted for compatibility.)

simulate

Ifnil or not present thencompile-system works silently. Otherwise a plan of the actions which compile-system intends to carry out is printed. What happens next depends on the value of simulate:

t -- do nothing.

:ask -- you are asked if you wish the plan to be carried out usingy-or-n-p.

:each --compile-system displays each action in the plan one at a time, and asks you whether you want to carry out this particular action. The answerc executes the rest of the plan without further prompting, returns from compile-system without further processing, andy andn work as expected.

:simulate may be abbreviated as:sim.

load

Ift thenload-system is called aftercompile-system has finished. If:no then no files are loaded at all. The default isnil.

args

Arguments to be passed directly to the compiler.

target-directory

This must be a string representing a valid directory. It defaults to the :default-pathname option todefsystem. This is the directory where the object files created are put. If the target-directory is given then dependency information expressed in the system rules is ignored.:target-directory may be abbreviated as:t-dir.

Values

compile-system returnsnil.

Examples

(compile-system 'blackboard :simulate :ask)

(compile-system 'tms :load t)

(compile-system 'packages :load :no
                 :target-directory "/usr/users/386i/")

Notes
: If the:load keyword is set tot then by defaultload-system is called aftercompile-system. This behavior can be changed to loading any file immediately after it is compiled by setting the variable defsystem::*load-when-compile* to non-nil.
See also

defsystem load-system