Where there is a finite set of meaningful text inputs (symbol names, names of existing files or editor commands, and so on) the IDE helps you to enter your text by offering completion. When you invoke completion, the system takes your partial input and either:
When your input remains partial, you may repeat the completion gesture.
When you see a choice of the possible meaningful inputs, certain gestures allow you to narrow the choice and quickly select the desired input, as described in Selecting the completed input.
In the Editor tool, a variety of completion commands are available. For example, in Emacs emulation
Tab invokes the command
Indent Selection or Complete Symbol. See the
LispWorks Editor User Guide
for details of this and other editor commands.
Also, clicking the button to the right of a text input pane raises a modal completion dialog, as described in Completion dialog.
The IDE presents the choice of inputs in one of two ways, described in the next two sections. The option LispWorks > Preferences... > Environment > General > Use in-place completion controls whether in-place completion is used.
In-place completion presents the choice of complete inputs in a special non-modal window. Example in-place completion window below shows this in the context of the editor command
While this window is visible, most keyboard gestures such as unmodified alphanumeric and punctuation keys are processed as ordinary input, adding to your partial input. This reduces the number of possible completions. Conversely, deleting part of your input will increase the number of possible completions.
You can set filter modes to alter the way that the filter operates, just as described in Advanced Filtering. Briefly, you select options from the
dropdown menu or with the keyboard gestures
Ctrl+Shift+C. The choice of items displayed changes according to the content of the filter pane and the selected filter options, and the label on the
dropdown changes to indicate your selected filter options.
When the Use in-place completion option (see Selecting the completed input) is off, all keyboard completion gestures raise a modal dialog presenting a choice of completion options.
You can navigate the choice with
Down and you can select the desired completion at any time with the
Return key, double-click, or click the
button. To cancel the attempt to complete, press
A modal completion dialog automatically has a filter if the number of possible completions exceeds the value of the option LispWorks > Preferences... > Environment > General > Add a filter to dialog lists longer than: . By default this option has value 25.
The filter options described above are also available in a modal completion dialog, and are controlled by the same keyboard gestures, for example
Ctrl+Shift+R. See Advanced Filtering for details.
LispWorks IDE User Guide (Macintosh version) - 13 Sep 2017