Once your Lisp image is running, you can start the environment by typing the following at the Lisp prompt:
(env:start-environment)This step is required for UNIX versions of LispWorks but is not necessary for the Linux version of Lispworks. In Linux, the complete LispWorks environment is started by default when Lispworks is run.
The start-environment function can take a number of keywords, as described below.
Syntax: env:start-environment &rest keywords
Starts Common LispWorks. This function takes the following keyword arguments:
The default, and the only supported value, is :capi .
The default, and the only supported value, is :motif .
The tools to start initially. The value must be of the following form:
( tool-description tool-description ... )
Each tool-description is either a symbol naming the class of the tool to start, or a list of the form ( tool-class tool-initarg1 tool-initarg2 ... ) .
The default is the value of lw-tools::*default-echo-podium* . The default value for this variable is to start the podium.
A set of functions to run when the environment starts. The value must be of the following form:
(( function1 arg1 arg2 ... ) ( function2 arg1 arg2 ... ) ...)
Following is the default value:
((lw-tools::start-lispworks-tools :tools tools ))
The value is a boolean indicating whether or not to start a GC monitor when the environment starts. The default value is t .
The value is an X Window System display string describing the X display and screen to use. The default value is derived from the DISPLAY environment variable or the -display command-line option. If neither is supplied, the default is to use the default screen on the local host.
The name of the host to use for the X Window System display. This argument is valid only if no :display argument is supplied. The default value is the local host.
The number of the display server to use for the X Window System display. This argument is valid only if no :display argument is supplied. The default value is 0 .
The number of the screen to use for the X Window System display. This argument is valid only if no :display argument is supplied. The default value is the default screen of the display.
The value is a string naming the application class used for X Window System resources. The default value is "Lispworks" .
The value is a list of strings representing the set of command-line arguments to pass to XtOpenDisplay . Each string corresponds to a single argument. The default value is derived from the command line used to start Lisp.
The value is a list of strings representing the set of application context fallback resources to use. Each string corresponds to a single line of an X resource file.
This value is used only when no other resource files can be found. The default value is read from the file whose name is the value of the :application-class argument in the app-defaults directory of the current library.