11 The Editor

The environment has a text editor which is designed specifically to make writing Lisp source code easier. By default it emulates the GNU EMACS text editor, and you should refer to the Editor User Guide supplied with your software, for a full description of the extensive range of functions and commands available. It can also emulate a Mac OS style text editor.

The Editor features a comprehensive set of menus, as well as a number of different views, and its interface is consistent with the other tools in the environment. This chapter gives a complete description of these aspects of the Editor, as well as giving you a general overview of how the Editor is used. If you have not used EMACS before, this chapter tells you all you need to know to get started.

The Editor is integrated with the other tools and offers a wide range of operations. The most commonly used of these can accessed using menu commands. The full range of editor commands is accessed via the keyboard commands described in more detail in the Editor User Guide . These operations range from simple tasks such as navigating around a file, to more complex actions which have been specifically designed to ease the task of writing Lisp code.

By becoming familiar with the menu commands available, you can learn to use the Editor effectively in a very short space of time, before moving on to more advanced operations.

Like many other tools, the Editor offers a number of different views, which you can switch between using the tabs at the top of the Editor window. Unlike other tools, one view in particular is used more often than any other.

• The text view is the most commonly used view in the Editor. This lets you read and edit text files which are stored in your filesystem.
• The output view lets you examine any output messages from the environment.
• You can edit many different files at once in the same Editor. The buffers view provides a quick way of navigating between different files that you have open.
• The definitions view is a convenient way of seeing the classes, functions, macros, variables and so on that are defined in the current file.
• Files may contain many definitions. The find definitions view lets you search for particular definitions of interest across many files.

You can create an Editor using any of the following methods:

• Choose Window > Tools > Editor . Notice that you are not actually editing a file immediately when you create an Editor like this.
• Click
in the LispWorks toolbar.

• Choose File > Open... , or click on
in the toolbar, and choose a filename in the dialog that appears.

• Make the Listener the active window, and press Ctrl+X Ctrl+F . Type in the name of a file that you want to edit. If the file is not in the current directory, enter the full pathname.
• Choose the command Find Source (available on various menus, for example Frame in the Debugger tool), or click on
to display source code in an Editor tool.

Note: the keystroke sequence Ctrl+X Ctrl+F is a standard EMACS command. If you use Mac OS editor emulation, many EMACS keys (those which do not coincide with standard Mac OS commands) are still available to you, though you will find it more natural to use standard Mac OS keys - in this case, the keystroke Command+O .

You can always discover which key to use for a particular editor command, or conversely which command is invoked by a particular key. See Help with editing for details.

11.1 Displaying and editing files

11.2 Displaying output messages in the Editor

11.3 Displaying and swapping between buffers

11.4 Displaying Common Lisp definitions

11.5 Changed definitions

11.6 Finding definitions

11.7 Setting Editor preferences

11.8 Basic Editor commands

11.9 Other essential commands

11.10 Cutting, copying and pasting using the clipboard

11.11 Cutting, copying and pasting using the kill ring

11.12 Searching and replacing text

11.13 Using Lisp-specific commands

11.14 Help with editing