This manual assumes that you have at least a basic knowledge of Common Lisp. Many source code examples are used throughout the manual to illustrate important concepts, but only extensions to Common Lisp which are specific to the environment are explained in detail.
This manual does provide a complete description of the windowed development environment available in your Lisp image. This includes a description of the user interface itself, and a description of how the user interface interacts with Common Lisp.
The examples files are in a read-only directory and therefore you should compile them inside the IDE (by the Editor command
Compile Buffer or the toolbar button or by choosing
Buffer > Compile
from the context menu), so it does not try to write a fasl file.
If you want to manipulate an example file or compile it on the disk rather than in the IDE, then you need first to copy the file elsewhere (most easily by using the Editor command
Write File or by choosing
File > Save As
from the context menu).
Throughout this manual, actions that you perform using the mouse are described in terms of the gesture used, rather than the combination of mouse buttons and keys that need to be used to perform the operation. This is because the buttons that are used are highly dependent on the platform you are running your Lisp image on, the operating system you are using, and even the type of mouse that you have attached to your computer. The mouse gestures available in the environment are described below.
If you are using a mouse with several buttons, you can nearly always select by clicking the left-most button, but you should refer to the documentation for your operating system or window manager if you are unsure. This is particularly true if you are using a mouse which has been set up for use by a left-handed person, since it is possible that the function of the mouse buttons has been reversed.
Multiple selection is used in lists and graphs when you want to select more than one item. You can select several items from any list or graph in the environment, and there are a large number of commands which can operate equally well on these multiple selections.
There are a number of standard ways of making multiple selections in a list or graph, depending on your operating system or window manager. Check the relevant documentation if you are unsure, or try any of the following:
Shiftkey while selecting an item.
Controlkey while selecting an item.
Shiftkey, and then select the last item; the intervening items are also selected.
Controlkey while selecting each item individually.
Double-clicking in a choice is usually a shortcut for selecting an item and choosing a common menu command, and the precise action that takes place depends on the context in which the double-click was performed. Double-clicking can only be performed on single selections.
In the Editor double-click selects the current Lisp form. Double-clicking and then dragging without releasing the mouse button increases the selection by forms, either forward or backward. It stops when it reaches the start or end of an enclosing form.
In the Editor this selects the line on GTK+ and Cocoa. Triple-clicking in the Editor (on GTK+ and Cocoa) and then dragging without releasing the mouse button increases the selection by lines. The triple-click gesture is not currently supported in LispWorks on Microsoft Windows.
If you are using a mouse with several buttons, you should find that you can perform this gesture by clicking the right-most mouse button. On a Macintosh with a single button mouse, the context menu is raised by holding down the
Control key and clicking the mouse button. Refer to the documentation for your window manager or operating system if you are unsure.
means that you should select the Preferences... menu item, then select the Environment item in a list within the dialog that appears, then select the General tab within that dialog, and lastly access the button labelled Use in-place completion .
Throughout this manual there are descriptions of commands that you can choose by typing at the keyboard. This is especially true when discussing the built-in editor, which relies heavily on the use of keyboard commands, and the Common Lisp listener, which uses many of the same commands.
For more information on using keyboard commands in the built-in editor and the Listener, see Using keyboard commands.
Your windows may differ in some respects from the illustrations given in this manual. This is because some details are controlled by your window manager and/or operating system, not by LispWorks itself.
LispWorks IDE User Guide (Macintosh version) - 13 Sep 2017