NextPrevTopIndex

Contents

Preface

1 Introduction

1.1 Major tools

1.1.1 The Listener

1.1.2 The Editor

1.1.3 The Class Browser

1.1.4 The Output Browser

1.1.5 The Inspector

1.1.6 The Object Clipboard

2 A Short Tutorial

2.1 Starting the environment

2.2 Creating a Listener

2.3 Using the Debugger

2.4 Viewing output

2.5 Inspecting objects using the Inspector

2.6 Examining classes in the Class Browser

2.7 Switching between windows

2.8 Summary

3 Common Features

3.1 Displaying tool windows

3.1.1 Displaying existing windows

3.1.2 Iconifying existing windows

3.1.3 Displaying tools using the mouse

3.1.4 Displaying tools using the keyboard

3.1.4.1 Tool accelerator modifier keys

3.1.4.2 Tool accelerator keys

3.1.4.3 Special considerations when using tool accelerators

3.1.5 Re-using tool windows

3.1.5.1 Global control of re-use

3.1.5.2 Per-window control of re-use

3.1.6 Toolbar configurations

3.1.7 Copying windows

3.1.8 Closing windows

3.1.9 Updating windows

3.2 Setting global preferences

3.2.1 The window options

3.2.2 Controlling completion behavior

3.2.3 Quitting the environment

3.2.4 Initialization file

3.3 Performing editing functions

3.3.1 Undoing changes

3.3.2 Using the clipboard

3.3.3 Selecting text and objects

3.3.4 Searching for text and objects

3.4 The history list

3.4.1 Repeating events from the history list

3.4.2 Editing the history list

3.5 Operating on files

3.6 Displaying packages

3.6.1 Specifying a package

3.7 Performing operations on selected objects

3.7.1 Operations available

3.8 Using different views

3.8.1 Sorting items in views

3.9 Tracing symbols from tools

3.10 Linking tools together

3.11 Filtering information

3.11.1 Plain Filtering

3.11.2 Advanced Filtering

3.12 Regexp matching

3.12.1 Regular expression syntax

3.12.2 Regexp and plain string matching

3.13 Completion

3.13.1 Invoking completion

3.13.2 Selecting the completed input

3.13.2.1 In-place completion

3.13.2.2 Filtering in-place completion

3.13.3 Completion dialog

3.13.3.1 Filtering modal dialog completion

3.14 Examining a window

4 Getting Help

4.1 Online manuals in HTML format

4.1.1 Browsing manuals online

4.1.2 Searching the online manuals

4.1.3 Getting help on the current tool

4.1.4 Getting help on the current symbol

4.1.5 Getting help from the LispWorks website

4.1.6 Getting patches from the LispWorks website

4.1.7 Configuring the browser used

4.2 Online help for editor commands

4.3 Browsing manuals online using Adobe Reader

4.4 Reporting bugs

5 Manipulating Graphs

5.1 An overview of graphs

5.2 Searching graphs

5.3 Expanding and collapsing graphs

5.3.1 Expanding and collapsing by clicking

5.3.2 Expanding and collapsing by menu commands

5.4 Moving nodes in graphs

5.5 Displaying plans of graphs

5.6 Preferences for graphs

5.6.1 Altering the depth and breadth of graphs

5.6.2 Displaying different graph layouts

5.7 Using graphs in your programs

6 LispWorks menus and the toolbar

6.1 LispWorks menus

6.2 The LispWorks toolbar

6.3 Specifying the initial tools

7 The Class Browser

7.1 Simple use of the Class Browser

7.1.1 Examining slots

7.1.2 Examining inherited slots

7.1.3 Filtering slot information

7.1.4 Examining other classes

7.1.5 Sorting information

7.2 Examining slot information

7.2.1 Class box

7.2.2 Filter area

7.2.3 Slots list

7.2.4 Description list

7.2.5 Performing operations on the current class

7.3 Examining superclasses and subclasses

7.3.1 Class box

7.3.2 Superclasses list

7.3.3 Subclasses list

7.3.4 Description list

7.3.5 Performing operations on the selected classes or the current class

7.4 Examining classes graphically

7.4.1 Class box

7.4.2 Subclasses and superclasses graphs

7.4.3 Description list

7.4.4 Performing operations on the selected classes or the current class

7.4.5 An example

7.5 Examining generic functions and methods

7.5.1 Class box

7.5.2 Filter box

7.5.3 List of functions or methods

7.5.4 Description list

7.5.5 Performing operations on the current class

7.5.6 Operations specific to the current function or method

7.6 Examining initargs

7.6.1 Class box

7.6.2 Filter box

7.6.3 List of initargs

7.6.4 Description list

7.6.5 Performing operations on the current class

7.7 Examining class precedences

7.7.1 Class box

7.7.2 Filter box

7.7.3 List of precedences

7.7.4 Description list

7.7.5 Performing operations on the selected classes or the current class

8 The Object Clipboard

8.1 Placing objects on the Object Clipboard

8.1.1 The Listener

8.1.2 The Class Browser

8.1.3 The Inspector

8.1.4 The Function Call Browser

8.1.5 The Generic Function Browser

8.1.6 The Debugger

8.1.7 The Stepper

8.1.8 The System Browser

8.1.9 General clipping

8.2 Browsing clipped objects

8.2.1 The Inspector

8.2.2 The Class Browser

8.2.3 The Listener

8.2.4 General browsing

8.2.5 Pasting of clipped objects

8.3 Removing objects

8.4 Filtering

8.5 Using the Object Clipboard with a Listener

9 The Compilation Conditions Browser

9.1 Introduction

9.2 Examining error conditions

9.3 Configuring the display

9.3.1 Package names preferences

9.3.2 Pathname preferences

9.3.3 Condition type preferences

9.4 Access to other tools

10 The Debugger Tool

10.1 Description of the Debugger

10.1.1 Condition box

10.1.2 Backtrace area

10.1.2.1 Frames and Variables in a tree

10.1.2.2 Frames and Variables in two lists

10.1.3 Toolbar buttons

10.2 What the Debugger tool does

10.3 Simple use of the Debugger tool

10.4 The stack in the Debugger

10.5 An example debugging session

10.6 Performing operations on the error condition

10.7 Performing operations on stack frames

10.7.1 Source location, documentation and method combination

10.7.2 Restarts and returning from the frame

10.7.3 Tracing the function in the frame

10.8 Performing operations on frame variables

10.9 Configuring the debugger tool

10.9.1 Configuring the call frames displayed

10.9.2 Displaying package information

10.9.3 Behavior on closing the Debugger

10.9.4 Frames and variables display

11 The Tracer

11.1 Introduction

11.2 Tracing and Untracing functions

11.2.1 Tracing methods

11.3 Examining the output of tracing

11.3.1 The Output Data view

11.3.2 The Output Text view

11.3.3 Clearing and restoring the Output

11.4 Example

12 The Editor

12.1 Displaying and editing files

12.1.1 The toolbar

12.1.2 The editor window

12.1.3 The echo area

12.1.4 Using keyboard commands

12.2 Displaying output messages in the Editor

12.3 Displaying and swapping between buffers

12.3.1 Filter area

12.3.2 Buffers area

12.4 Displaying Common Lisp definitions

12.4.1 Filter box

12.4.2 Definitions area

12.5 Changed definitions

12.5.1 Setting the reference point for changed definitions

12.6 Finding definitions

12.7 Setting Editor preferences

12.7.1 Sorting items in lists

12.7.2 Displaying package information

12.7.3 Controlling toolbar display

12.7.4 Automatic filters on dialogs

12.7.5 Automatic use of Find Definitions view

12.7.6 Configuring the editor emulation

12.7.6.1 Choosing the key input style

12.7.6.2 Specifying a Meta key

12.7.6.3 Setting the cursor blink rate

12.7.6.4 Preserving your setting

12.7.7 Setting the editor font

12.7.8 Setting the text style attributes

12.7.8.1 Syntax styles

12.7.9 Setting the default encodings

12.8 Basic Editor commands

12.8.1 Opening, saving and printing files

12.8.2 Moving around files

12.8.3 Inserting and deleting text

12.8.4 Using several buffers

12.9 Other essential commands

12.9.1 Aborting commands

12.9.2 Undoing commands

12.9.3 Repeating commands

12.10 Cutting, copying and pasting using the clipboard

12.11 Cutting, copying and pasting using the kill ring

12.11.1 Marking the region

12.11.2 Cutting or copying text

12.11.3 Pasting text

12.12 Searching and replacing text

12.12.1 Searching for text

12.12.2 Incremental searches

12.12.3 Replacing text

12.13 Using Lisp-specific commands

12.13.1 Lisp mode

12.13.2 Current buffers, definitions and expression

12.13.3 Evaluating code

12.13.4 Compiling code

12.13.4.1 Compiling in memory

12.13.4.2 Compiling to a file

12.13.5 Breakpoints

12.13.5.1 Setting breakpoints

12.13.5.2 Editing breakpoints

12.13.5.3 Removing breakpoints

12.13.5.4 Reloading code with breakpoints

12.13.6 Tracing symbols and functions

12.13.7 Packages

12.13.7.1 The primary package

12.13.7.2 The current package for Lisp operations

12.13.8 Indentation of forms

12.13.9 Other facilities

12.14 Help with editing

13 The Function Call Browser

13.1 Introduction

13.2 Examining functions using the graph views

13.2.1 Function area

13.2.2 Show functions control

13.2.3 Graph area

13.2.4 Echo area

13.2.5 The function description button

13.2.5.1 Function description area

13.2.5.2 Documentation area

13.3 Examining functions using the text view

13.3.1 Called By area

13.3.2 Calls Into area

13.4 Configuring the function call browser

13.4.1 Sorting entries

13.4.2 Displaying package information

13.5 Configuring graph displays

13.5.1 Graph layout settings

13.5.2 Graph expansion settings

13.5.3 Plan mode settings

13.6 Performing operations on functions

14 The Generic Function Browser

14.1 Examining information about methods

14.1.1 Function area

14.1.2 Filter area

14.1.3 Methods list

14.1.4 Description list

14.1.5 Performing operations on the current function or selected methods

14.2 Examining information about combined methods

14.2.1 Function box

14.2.2 Signatures button

14.2.3 Arguments types box

14.2.4 List of method combinations

14.2.5 Description list

14.2.6 Restricting displayed signatures by class

14.3 Configuring the Generic Function Browser

15 The Search Files tool

15.1 Introduction

15.2 Performing searches

15.2.1 Entering Search Specifications directly

15.2.1.1 Plain Directory searches

15.2.1.2 Root and Patterns searches

15.2.1.3 System Search

15.2.1.4 Grep searches

15.2.2 Using context-dependent searches

15.2.2.1 Context-dependent searches using Editor commands

15.2.2.2 Context-dependent searches using menu commands

15.2.2.3 Search History

15.3 Viewing the results

15.3.1 Displaying in an Editor

15.3.2 Linking to an Editor

15.3.3 Filtering the results

15.3.4 Hiding certain results

15.4 Configuring the Search Files tool

15.4.1 Search Parameters

15.4.2 Display

15.4.3 File Types

15.4.4 The External Grep Program

16 The Inspector

16.1 Inspecting the current object

16.2 Description of the Inspector tool

16.2.1 Adding a Listener to the Inspector

16.3 Filtering the display

16.3.1 Updating the display

16.4 Examining objects

16.5 Operating upon objects and items

16.5.1 Examination operations

16.5.1.1 Example

16.5.1.2 Recursive inspection

16.5.2 Examining attributes

16.5.3 Tracing slot access

16.5.4 Manipulation operations

16.5.4.1 Example

16.5.5 Copying in the Inspector

16.6 Configuring the Inspector

16.7 Customizing the Inspector

16.8 Creating new inspection formats

16.8.1 Example

17 The Symbol Browser

17.1 Introduction

17.2 Description of the Symbol Browser

17.2.1 Search Settings

17.2.1.1 Packages

17.2.1.2 Type

17.2.1.3 Accessibility

17.2.2 Filter area

17.2.3 Symbols list

17.2.4 Description area

17.2.5 Documentation area

17.3 Configuring the Symbol Browser

18 The Listener

18.1 The basic features of a Listener

18.2 Evaluating simple forms

18.3 Re-evaluating forms

18.4 Interrupting evaluation

18.5 The History menu

18.6 The Expression menu

18.7 The Values menu

18.8 The Debug menu

18.9 Execute mode

18.9.1 History commands

18.9.2 Debugger commands

18.9.3 Miscellaneous Listener commands

18.10 Setting Listener preferences

18.11 Running Editor forms in the Listener

18.12 Switching to and from other tools

18.13 Help with editing in the Listener

19 The Output Browser

19.1 Interactive compilation messages

19.1.1 Compilation message styles

20 The Process Browser

20.1 The process list

20.2 Process control

20.3 Other ways of breaking processes

20.4 Updating the Process Browser

20.5 Process Browser Preferences

21 The Profiler

21.1 Introduction

21.2 Display of Profiler Data

21.2.1 Call Tree

21.2.2 Cumulative Results

21.3 A description of profiling

21.3.1 Description of call tree data

21.3.2 Description of cumulative data

21.4 Steps involved in profiling code

21.4.1 Choosing the functions to profile

21.4.1.1 Choosing individual functions

21.4.1.2 Choosing packages

21.4.2 Specifying the code to run while profiling

21.4.3 Performing the profile

21.5 Format of the cumulative results

21.6 Interpreting the cumulative results

21.7 Profiling pitfalls

21.7.1 Effects of random sampling

21.7.2 Recursive functions

21.7.3 Structure accessors

21.7.4 Consequences of restricted profiling

21.7.5 Effect of compiler optimizations

21.7.6 Effect of compiler transforms

21.8 Some examples

22 The Shell and Remote Shell Tools

22.1 Introduction

22.2 The Shell tool

22.3 Command history in the shell

22.4 Configuring the shell to run

22.5 The remote shell tool

23 The Stepper

23.1 Introduction

23.1.1 Stepper toolbar

23.1.2 Source area

23.1.3 Backtrace area

23.1.4 Listener area

23.2 Simple examples

23.2.1 Standalone use of the stepper

23.2.2 Invoking the Stepper via a breakpoint

23.3 The implementation of the Stepper

23.3.1 Requirements for stepping

23.3.2 Editing source code

23.3.3 Side-effects of stepping

23.3.4 Atomic and constant forms

23.4 Stepper controls

23.4.1 Shortcut keys for the Stepper

23.5 Stepper restarts

23.6 Breakpoints

23.6.1 Setting breakpoints

23.6.2 Conditional breakpoints

23.6.3 Printing breakpoints

23.6.4 Editing breakpoints

23.6.5 Removing breakpoints

23.7 Stepping macro forms

23.7.1 Interactive macroexpansion

23.7.2 Macroexpansion in the stepper

23.7.3 Collapsing macroexpansions

23.7.4 Controlling macroexpansion

23.8 Listener area

23.9 Configuring the Stepper

23.9.1 Operator preferences

23.9.2 Backtrace preferences

24 The System Browser

24.1 Introduction

24.2 A brief introduction to systems

24.2.1 Examples

24.3 The System Browser

24.4 A description of the System Browser

24.5 Examining the system graph

24.5.1 System area

24.5.2 Graph area

24.5.3 Description area

24.5.4 Performing operations on system members

24.6 Examining systems in the text view

24.6.1 System area

24.6.2 Parent system area

24.6.3 Subsystems area

24.6.4 Files area

24.6.5 File description area

24.7 Generating and executing plans in the preview view

24.7.1 System area

24.7.2 Actions area

24.7.3 Filter area

24.7.4 Plan area

24.7.5 File description area

24.7.6 Executing plans in the preview view

24.8 Examining output in the output view

24.8.1 System area

24.8.2 Output area

24.9 Configuring the display

24.9.1 Sorting entries

24.9.2 Displaying package information

24.9.3 Display of the toolbar

24.9.4 Graph preferences

24.10 Setting options in the system browser

25 The Window Browser

25.1 Introduction

25.1.1 Graph box

25.1.2 Window graph

25.1.3 Description list

25.2 Configuring the Window Browser

25.2.1 Sorting entries

25.2.2 Displaying package information

25.2.3 Displaying the toolbar

25.2.4 Displaying different types of window

25.2.5 Displaying short or long names

25.3 Performing operations on windows

25.3.1 Navigating the window hierarchy

25.3.2 Window control

26 The Application Builder

26.1 Introduction

26.1.1 What the Application Builder does

26.2 Preparing to build your application

26.2.1 The script

26.2.1.1 Using your existing delivery script

26.2.1.2 Creating a new delivery script

26.3 Building your application

26.4 Editing the script

26.5 Troubleshooting

26.5.1 Viewing errors

26.5.2 Clearing the output

26.6 Running the saved application

26.6.1 Passing arguments and redirecting output

26.6.2 Executing a different file

26.6.3 Killing application processes

26.7 Building universal binaries

26.8 Configuring the Application Builder

Index

 


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

NextPrevTopIndex