6.1 Starting the environment

env:start-environment

Package:env

Submodule:common-lispworks

Syntax:env:start-environment &rest keywords

Starts Common LispWorks. This function takes the following keyword arguments:

:environment

The default, and the only supported value, is:capi.

:library

The default, and the only supported value, is:motif.

:tools

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 oflw-tools::*default-tools*. The default value for this variable is to start the podium window, by invoking the functionlw-tools:lispworks-echo-podium.

:start-functions

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

:gc-monitor-p

The value is a boolean indicating whether or not to start a GC monitor when the environment starts. The default value ist.

:display

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.

: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.

:server-number

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 is0.

:screen-number

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.

:application-class

The value is a string naming the application class used for X Window System resources. The default value is"Lispworks".

:command-line-args

The value is a list of strings representing the set of command-line arguments to pass toXtOpenDisplay. Each string corresponds to a single argument. The default value is derived from the command line used to start Lisp.

:fallback-resources

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 theapp-defaults directory of the current library.

Generated with Harlequin WebMaker