10.2 Examining error conditions

The Conditions view is visible when the Compilation Conditions Browser is first invoked. The tool appears as shown in The Compilation Conditions Browser.

Figure 10.1 The Compilation Conditions Browser

There are two tabs. These show the same information, in different ways:

• Conditions - default view that shows all conditions in a tree representation, grouped by filename. Each item in the tree can be expanded to show the conditions that were generated during compilation of that file. Selecting a compilation message in the tree view causes the data for the selected message to be shown in the Description area. Double-clicking on an item (or using Find Source on the context menu, as illustrated above) shows the source code of the condition in an Editor, highlighting the nearest subform to where the condition occurred. After doing this, Ctrl+X ` (backquote) can be used to find the source of the next condition shown in the browser.
• Output - shows the raw compilation output. You will see this same output in the tool that performed the compilation.

The description area in the Conditions view of the Compilation Conditions Browser shows a description of any item selected in the conditions area. The description contains details of the selection condition. The following information is shown:

Condition

The error condition for the selected item in the message area.

Class

The class of the selected condition.

Definition

The name of the form in which the condition was signaled.

File

The name of the file that contains the Lisp source code that caused the selected condition.

Items selected in this area may be examined using the Works > Description menu which allows a variety of LispWorks tools to be invoked on the selected item in the description area.