12 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 LispWorks 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 LispWorks 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.

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

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.

A further way to edit a file is to drag it (using the mouse) from another drag and drop enabled application such as the Finder, and drop it into the an Editor tool.

12.1 Displaying and editing files

12.2 Displaying output messages in the Editor

12.3 Displaying and swapping between buffers

12.4 Displaying Common Lisp definitions

12.5 Changed definitions

12.6 Finding definitions

12.7 Setting Editor preferences

12.8 Basic Editor commands

12.9 Other essential commands

12.10 Cutting, copying and pasting using the clipboard

12.11 Cutting, copying and pasting using the kill ring

12.12 Searching and replacing text

12.13 Using Lisp-specific commands

12.14 Help with editing

Common LispWorks User Guide (Macintosh version) - 21 Feb 2008