When true, causes the Lisp heap and the executable to be saved in two separate files.
If
split
is
nil
(the default), then the saved image is written as a single executable file containing the Lisp heap. If
split
is
t
, then the saved Lisp heap is split into a separate file, named by adding
.lwheap
to the name of the executable (as specified by the argument
file
). When the executable runs, it reloads the Lisp heap from the
.lwheap
file automatically.
In addition, when saving LispWorks as an application bundle on the Macintosh (for example by using
create-macos-application-bundle
),
split
can be the symbol
:resources
. This places the Lisp heap file in the
Resources
directory of the bundle, rather than in the
Contents/MacOS
directory alongside the executable, which allows the heap to be included in the signature of the bundle.
The main use of split is to allow third-party code signing to be applied to the executable, which is often not possible when saving an image with the Lisp heap included in a single file.