Contents

1 Introduction

1.1 Using the editor within LispWorks

1.2 About this manual

1.3 Viewing example files

2 General Concepts

2.1 Window layout

2.1.1 Windows and panes

2.1.2 Files and buffers

2.1.3 The mode line

2.2 Buffer positions: points, marks and locations

2.2.1 Points

2.2.2 Marks

2.2.3 Regions

2.2.4 Locations

2.3 Modes

2.4 Text handling concepts

2.4.1 Words

2.4.2 Sentences

2.4.3 Paragraphs

2.5 Executing commands

2.5.1 Modifier keys - Command, Ctrl, Alt and Meta

2.5.2 Two ways to execute commands

2.5.3 Prefix arguments

2.6 Basic editing commands

2.6.1 Aborting commands and processes

2.6.2 File handling

2.6.3 Inserting text

2.6.4 Movement

2.6.5 Deleting and killing text

2.6.6 Undoing

2.6.7 Killing and Yanking

2.6.8 Help

3 Command Reference

3.1 Aborting commands and processes

3.2 Executing commands

3.3 Help

3.3.1 The help command

3.3.2 Other help commands on UNIX and macOS

3.4 Using prefix arguments

3.5 File handling

3.5.1 Finding files

3.5.2 Saving files

3.5.3 Unicode and other file encodings

3.5.3.1 Controlling the external format

3.5.3.2 Unwritable characters

3.5.4 Auto-saving files

3.5.5 Backing-up files on saving

3.5.6 Miscellaneous file operations

3.6 Filename completion

3.7 Directory mode

3.7.1 Directory mode buffer display

3.7.2 Directory mode commands

3.7.3 Explicit editing of the Directory mode buffer

3.7.4 Modifying the file system from the Directory mode buffer

3.7.5 Creating new Directory mode buffers

3.8 Movement

3.9 Marks and regions

3.9.1 Marks

3.9.2 Regions

3.10 Locations

3.11 Deleting and killing text

3.11.1 Deleting Text

3.11.2 Killing text

3.12 Inserting text

3.13 Delete Selection

3.14 Undoing

3.15 Case conversion

3.16 Transposition

3.17 Overwriting

3.18 Indentation

3.19 Filling

3.19.1 Fill commands

3.19.2 Auto-Fill mode

3.20 Buffers

3.21 Windows

3.22 Pages

3.23 Searching and replacing

3.23.1 Searching

3.23.2 Regular expression searching

3.23.3 Replacement

3.24 Comparison

3.25 Registers

3.26 Modes

3.26.1 Major modes

3.26.2 Minor modes

3.26.3 Default modes

3.26.4 Defining modes

3.27 Abbreviations

3.28 Keyboard macros

3.29 Echo area operations

3.29.1 Completing commands

3.29.2 Repeating echo area commands

3.29.3 Movement in the echo area

3.29.4 Deleting and inserting text in the echo area

3.29.5 Display of information in the echo area

3.29.6 Leaving the echo area

3.30 Editor variables

3.31 Recursive editing

3.32 Key bindings

3.33 Execute mode

3.33.1 Listener commands

3.33.2 History commands

3.33.3 Debugger commands

3.34 Running shell commands

3.34.1 Running shell commands directly from the editor

3.34.2 Invoking and using a Shell tool

3.35 Buffers, windows and the mouse

3.35.1 Buffers and windows

3.35.2 Actions involving the mouse

3.36 Interaction with the GUI and the IDE

3.37 Miscellaneous

3.38 Obscure commands

4 Editing Lisp Programs

4.1 Automatic entry into Lisp mode

4.2 Syntax coloring

4.3 Functions and definitions

4.3.1 Movement, marking and specifying indentation

4.3.2 Definition searching

4.3.3 Tracing functions

4.3.4 Function callers and callees

4.3.5 Indentation and Completion

4.3.6 Miscellaneous

4.4 Forms

4.4.1 Movement, marking and indentation

4.4.2 Killing forms

4.4.3 Macro-expansion of forms

4.4.4 Miscellaneous

4.5 Lists

4.5.1 Movement

4.6 Comments

4.7 Parentheses

4.8 Documentation

4.9 Evaluation and compilation

4.9.1 General Commands

4.9.2 Evaluation commands

4.9.3 Evaluation in Listener commands

4.9.4 Compilation commands

4.10 Code Coverage

4.10.1 Coloring code coverage

4.10.2 Setting the default code coverage data

4.11 Breakpoints

4.11.1 Setting and removing breakpoints

4.11.2 Moving between breakpoints

4.12 Stepper commands

4.13 Removing definitions

4.13.1 Undefining one definition

4.13.2 Removing multiple definitions

4.14 Definition folding

4.15 Remote debugging

5 Emulation

5.1 Using platform-specific editor emulation

5.2 Key bindings

5.2.1 Finding the keys

5.2.2 Modifying the Key Bindings

5.2.3 Accessing Emacs keys

5.2.4 The Alt modifier and editor bindings

5.3 Replacing the current selection

5.4 Emulation in Applications

6 Advanced Features

6.1 Customizing default key bindings

6.2 Customizing Lisp indentation

6.3 Programming the editor

6.3.1 Calling editor functions

6.3.2 Defining commands

6.3.3 Buffers

6.3.3.1 Buffer locking

6.3.3.2 Buffer operations

6.3.4 Points

6.3.5 Regular expression searching

6.3.6 The echo area

6.3.7 Editor errors

6.3.8 Files

6.3.8.1 File encodings in the editor

6.3.9 Inserting text

6.3.10 Indentation

6.3.11 Lisp

6.3.12 Movement

6.3.13 Prompting the user

6.3.14 In-place completion

6.3.15 Variables

6.3.16 Windows

6.3.17 Faces

6.3.18 Examples

6.3.18.1 Example 1

6.3.18.2 Example 2

6.3.18.3 Example 3

6.4 Editor source code

6.4.1 Contents

6.4.2 Source location

6.4.3 Guidelines for use of the editor source code

7 Self-contained examples

7.1 Example commands

7.2 Syntax coloring example

Glossary

Index