13 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.

• 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 shows output messages. Compiler messages are highlighted and you can easily locate the source code that generated them.
• 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.

• Choose File > Recent Files and choose a filename from the submenu 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 or to display source code in an Editor tool.

• Use the keyboard accelerator described in Displaying tools using the keyboard.

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.

13.1 Displaying and editing files

13.2 Displaying output messages in the Editor

13.3 Displaying and swapping between buffers

13.4 Displaying Common Lisp definitions

13.5 Changed definitions

13.6 Finding definitions

13.7 Setting Editor preferences

13.8 Basic Editor commands

13.9 Other essential commands

13.10 Cutting, copying and pasting using the clipboard

13.11 Cutting, copying and pasting using the kill ring

13.12 Searching and replacing text

13.13 Using Lisp-specific commands

13.14 Help with editing

LispWorks IDE User Guide (Macintosh version) - 25 Nov 2011