Choose Tools > Preferences... from the podium or Works > Tools > Preferences... or click to raise the Preferences dialog. This dialog is used to specify:
The tool-specific options are described in the chapter relevant to each tool.
The remainder of this section describes the general environment options. To see these, ensure that Environment is selected in the list on the left side of the Preferences dialog, and select the General , Emulation , Styles , and File Encodings tabs.
In all cases your setting is preserved for future use after you click OK to close the Preferences dialog.
Reuse all tools controls whether LispWorks uses an existing tool rather than starting up a new copy. For example if Reuse all tools is checked, if an editor is already open, choosing File > Open and selecting a new file causes the file to be opened in the existing editor.
Use separate Editor windows for each file controls whether LispWorks will open a separate Editor window for each file (or editor buffer) that you have in memory. In addition, when Use separate Editor windows for each file is checked, closing an Editor window will remove the underlying editor buffer from memory, possibly asking if you want to save it. The default setting is unchecked.
Note: for information about Editor windows, editor buffers and files, see Displaying and swapping between buffers.
Check Use recent directory for opening files to make operations such as File > Open use the directory of the file most recently edited as the default directory in the file dialog. Deselect this option to make the dialog's default directory be the current working directory. Note that this option does not affect the Editor tool, for which the file dialog always uses the directory of the currently visible file as the default directory.
In-place completion is enabled by default in the IDE. If you prefer the modal dialog style of completion familiar to users of LispWorks 5.0 and previous versions, deselect the Use in-place completion option.
When using in-place completion to complete a filename, by default you must always select an item from the in-place completion window. You can accelerate this interaction by checking the option Auto-insert on single file completion . Then, if there is just one possible completion, it is automatically selected and appended to your input.
LispWorks exits immediately.
A dialog asks you to confirm whether LispWorks should exit.
The option Add a filter to dialog lists longer than: affects modal dialogs containing long lists. When the list is longer than the value of this option, the list has a filter, which you can use as described in Filtering modal dialog completion.
Use Find Definitions list for more items than:
affects the behavior of source location commands such as the editor commands
Find Source and
Find Source for Dspec, and the menu command
Expression > Find Source
. When the number of source location results exceeds the value of this option, then the results are immediately displayed in the Find Definitions view of an Editor tool. This is particularly useful when you need to locate the definition of a particular CLOS method from the generic function name.
The Find Definitions view is described in Finding definitions.
By default LispWorks looks for a file
.lispworks to be loaded automatically when LispWorks is started. You should create an initialization file and add to it Lisp code to initialize the LispWorks image to suit your needs.
The Preferences dialog can be used to specify a different initialization file, in the Initialization File area. You can either enter the path and filename directly into the text input box, or use the button to display a file selection dialog. Clicking on undoes any alterations entered.
Note: it is up to each user to create and maintain their own personal initialization file. A sample personal initialization file is supplied with LispWorks - see the file
lib/7-1-0-0/config/a-dot-lispworks.lisp in the LispWorks distribution.
Here you can configure the editor to behave according to one of two pre-defined editor input styles (emulations) which determine how keyboard input is processed and other properties such as the shape of the input cursor. You can also set the cursor blink rate.
The Editor and other tools using
capi:editor-pane offer two key input styles: Emacs emulation or KDE/Gnome emulation. By default, Emacs emulation is used. To choose an emulation, select
Environment > Emulation
in the Preferences dialog as shown in Configuring the editor emulation and select one of the
Editor keys are like
Note: In this and other manuals, the Emacs keys are generally given. For help with finding keys for editor commands, choose
Help > Editing > Command to Key
. Also see the files
config/msw-key-binds.lisp which contain the forms defining the keys for each input style.
By default the editor uses a system default font. You can choose an alternative font and see a sample of it displayed in the Editor Font area. Click in the Sample: area to raise a font chooser. After you select the font, the text "Click here to choose the font" is displayed in your selected font.
You can modify the background and foreground of the Editor and Listener windows, and all other tools based on the editor, using the Main Colors frame. Note, however, that this will override any customization done in the underlying window system, for example the resources in GTK+, which or may not be what you want.
First select the kind of editor that you want to modify in the Pane Kind list. Alternatively select Default to specify default background and foreground, which apply to any editor of a kind for which the corresponding value is not set.
The main panes in the Editor tool, and other panes which are also just used for editing, for example the Code To Profile tab in the Profiler and Source: in the Stepper.
The Listener tool and other listener panes, including in the Debugger, the Inspector and the Stepper.
Any pane that is used for output, including the pane in the Output tab of the Editor, Listener and System Browser, and the output panes in the Tracer and Application Builder.
The Shell tool.
Echo areas on all tools.
For each kind of pane, check Use color: alongside Background or Foreground to specify the background and foreground colors. If Use color: is unchecked, the value is not specified, and a large cross appears in the color area on the right. If Use color: is checked, then the color is set and the color area on the right shows it. Click in the color area to change the color using a Color chooser that is raised.
When the LispWorks IDE makes an editor pane, it uses the foreground and background for this kind of pane if they are specified. If either the foreground or background is not specified (that is, Use color: is unchecked), then it uses the color specified for the Default pane kind if that is set. Otherwise it uses the default of the window system.
The Change the echo area color when not active checkbox controls whether an echo area changes its colors when it is not active. When it is checked and an echo area become inactive, the echo area changes its foreground and background to the colors of the tool. In other cases, echo areas use the colors set under Echo in the Main Colors box of the Preferences dialog, or in the window system (such as in the GTK+ resources).
To change the attributes of one or more text styles, first select Environment > Styles in the Preferences dialog as shown in Setting the editor font, color and other style attributes.
Then, to make Common Lisp symbols appear with red foreground rather than the default purple for example, first select Lisp Keyword in the Style Name list. Then select Specified alongside Foreground and double-click on the color area to the right. In the Color chooser that appears, choose the new color and click OK . Now click OK on the Preferences dialog and see the change in the way your Lisp code is displayed. You may need to force the editor window to redisplay, for example by scrolling, to see the change take effect.
No special formatting
Platform-standard highlighting, as for selected text
The color specified is used.
The system generates a color which is usable for highlighting.
Note: the foreground and background colors of windows are set via the system, not in LispWorks. To alter these colors on GTK+ or Motif, see "Matching resources for GTK+ and X11/Motif" in the CAPI User Guide and Reference Manual and specify resources for the application class Lispworks.
You can control whether the editor colors parentheses in Lisp code. By default, pairs of matching parens are displayed in the same color, with a different color for forms at different depths. You can switch off this coloring by deselecting the option Color parenthesis in the Styles tab of the Environment preferences.
The Editor has defaults for the encodings used when opening and saving files. For many users these defaults will suffice. If you need to change either, select the Environment > File Encodings tab of the Preferences dialog.
LispWorks IDE User Guide (Unix version) - 13 Sep 2017