concatenate-system

concatenate-system Function

Summary

Produces a single, concatenated fasl from a defsystem system or systems.

Package

lispworks

Signature

concatenate-system output-file system-name &key force simulate source-only target-directory => result

Arguments

`output-file`⇩	The name of the required concatenated fasl.
`system-name`⇩	The name of a system defined using defsystem.
`force`⇩	If `t`, then all files in the system will be concatenated.
`simulate`⇩	Verbosity conditions, see Description for more detail.
`source-only`⇩	If `t`, the source files of the system are concatenated.
`target-directory`⇩	The directory to search for the object files.

Values

result

A list containing the name or names of the concatenated systems.

Description

The function concatenate-system produces a single, concatenated fasl, output-file, from a list of individual systems. system-name can be repeated before the first keyword argument to concatenate more than one system.

If force is non-nil then all the files in the system are concatenated even if output-file is newer.

If simulate is nil or is not present, concatenate-system will work silently. Otherwise, a plan of the actions which concatenate-system intends to carry out is printed. What happens next depends upon the value of simulate:

If it is t, the function does nothing.
If :ask, then the user is asked, using y-or-n-p, if the plan should be carried out.
If it is :each, the user is asked at each stage in the plan if the current action should be carried out. The responses y and n work as normal. If e is typed, concatenate-system exits without further processing.

If source-only is t, files will be loaded only if they are sources.

If, when searching target-directory for an object file, the file cannot be found, the appropriate source file from the system's default directory will be loaded instead. :target-directory may be abbreviated as :t-dir.