15 The SCM Package

concatenate-system

Function

Summary

This function produces a single, concatenated fasl from a list of individual systems.

Package

scm

Signature

concatenate-system output-file &rest args => nil

Arguments

In the following list of arguments, the words in parentheses are equivalent forms for the keyword:

output-file: The name of the required concatenated fasl.
simulate: Verbosity conditions, see Description for more detail. This argument can be abbreviated as sim.
force: Ift, then all files in the system are concatenated. The argument force-p can also be used.
source-only: Ift, the source files of the system are concatenated. The argument source-p can also be used.
target-directory: The directory to search for the object files. This argument can be abbreviated as t-dir.
target-machine: Architecture of machine. This argument can be abbreviated as t-machine.

Values

Returnsnil.

Description

Since concatenated fasl files may be produced using this function, you do not need to be wary of PC filename conventions if developing sources on UNIX for a PC application. This clearly allows more freedom for naming source files. However, output-file must, in such cases, be a PC-compatible filename.

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

If it ist, the function does nothing.
If :ask, then you are asked, usingy-or-n-p, if the plan should be carried out.
If it is:each, you are 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 ist, files are 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 is loaded instead.

The target-machine argument allows the concatenation of fasl files for loading on another machine. Possible values are:

:harlequin-pc-lisp or:pc

Concatenate PC LispWorks fasl files.

:harlequin-unix-lisp or:unix

Concatenate fasl files for the current UNIX machine.

By default, the concatenated fasl is built for the current machine architecture.