When LispWorks starts up, it looks for an initialization file to load. The name of the file is held in
, and is "
by default. The file may contain any valid Lisp code.
You can load a different initialization file using the option
in the command line, for example:
unix% lispworks -init my-lisp-init
would make LispWorks load my-lisp-init.lisp as the initialization file instead of that named by
Alternatively, an initialization file may be specified by setting the UNIX environment variable
. If set, the specified file will be used instead of that named by
The loading of the siteinit file (located by default at
) may similarly be controlled either by the
command line argument, or the
You can start an image without loading any personal or site initialization file by passing a hyphen to the
arguments instead of a filename:
unix% lispworks -init - -siteinit -
This starts the LispWorks image without loading any initialization file. It is often useful to start the image in this way when trying to repeat a suspected bug. You should always start the image without initialization if you are intending to resave it.
In all cases, if the filename is non-nil, and is not a hyphen, LispWorks tries to load it as a normal file by calling
. If the load fails, LispWorks prints an error report.