12 The LISPWORKS Package

concatenate-system

Function

Package

scm

Syntax

concatenate-system output-file &rest args

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 (sim)

Verbosity conditions, see Description for more detail.

force (force-p)

Ift, then all files in the system will be concatenated.

source-only (source-p)

Ift, the source files of the system are concatenated.

target-directory (t-dir)

The directory to search for the object files.

target-machine (t-machine)

The architecture of machine.

Description

This function produces a single, concatenated fasl, output-file, from a list of individual systems (named amongst the args).

Since concatenated fasl files may be produced in this way, 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 will work 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 the user is asked, usingy-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 ist, 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.

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