All Manuals > Release Notes and Installation Guide > 8 Configuration on macOS

8.3 Configuring your LispWorks installation

Once you have successfully installed and run LispWorks, you can configure it to suit your local conditions and needs, producing an image that is set up the way you want it to be every time you start it up.

8.3.1 Levels of configuration

There are two levels of configuration:

These two levels are available for good reason: while some configuration details may be of use to all LispWorks users on your machine (for instance, having a particular library built into the image where before it was only load-on-demand) others may be a matter of personal preference (for instance how many editor windows are allowed on-screen, or the colors of tool windows).

In the first case, you use edited copies of files in the config folder to achieve your aims.

In the second case, you make entries in your initialization file. This is a file read every time LispWorks starts up, and it can contain any valid Common Lisp code. (Most of the configurable settings in LispWorks can be controlled from Common Lisp.) By default the file is called .lispworks and is in your home directory. Your initialization file can be changed via LispWorks > Preferences... from the LispWorks IDE.

8.3.2 Configuring images for the different GUIs

If you have installed both the LispWorks images, for native macOS and for GTK+, you will want to configure two images.

If necessary your Lisp configuration and initialization files can run code for one image or the other by conditionalization on the feature :cocoa. The native macOS LispWorks image has :cocoa on *features* while the GTK+ LispWorks image does not, and has :gtk.

8.3.3 Configuration files available

There are four sample configuration files in LispWorks library containing settings you can change in order to configure images:

config/configure.lisp is preloaded into the image before it is shipped. It contains settings governing fundamental issues like where to find the LispWorks run time folder structure, and so on. You can override these settings in your saved image or in your initialization file. You should read through configure.lisp .

config/siteinit.lisp contains any forms that are appropriate to the whole site but which are to be loaded afresh each time the image is started. The sample siteinit.lisp file distributed with LispWorks contains only the form:

(load-all-patches)

On startup, the image loads siteinit.lisp and your initialization file, in that order. The command line options -siteinit and -init can be used to specify loading of different files or to suppress them altogether. See the example in 8.4 Saving and testing the configured image, below, and 8.5 Initializing LispWorks for further details.

private-patches/load.lisp is loaded by load-all-patches, and should contain forms to load any private (named) patches that Lisp Support might send you.

config/a-dot-lispworks.lisp is a sample personal initialization file. You might like to copy this into a file ~/.lispworks in your home directory and edit it to create your own initialization file.

Both configure.lisp and a-dot-lispworks.lisp are preloaded into the image before it is shipped, so if you are happy with the settings in these files, you need not change them. See the example in 8.4 Saving and testing the configured image, below, and 8.5 Initializing LispWorks for further details.


Release Notes and Installation Guide - 01 Dec 2021 19:38:48