9.2 Examining error conditions

The tree view is the default view in the Compilation Conditions Browser, and is therefore visible when the browser is first invoked. The Compilation Conditions Browser appears as shown in The Compilation Conditions Browser. The following code generated the compilation warnings seen:

(defun node-children (node)

  (setq *graph-name* "Test graph for tutorial")

  (if (equal node 'pets)

      (list 'dog 'parrot)

    (if (equal node 'dog)

        (list 'Kito 'Otis 'Sammy 'Teddy)

      (if (equal node 'parrot)

          (list 'Brady)))))

(setq test-graph

      (capi:contain

       (make-instance 'capi:graph-pane

                      :roots '(pets)

                      :children-function

                      'node-children)

       :best-width 300

       :best-height 400))

It is not good coding style to have global variables that are not defined as special variables; this is done above to provide an example for the Compilation Conditions Browser.

Figure 9.1 The Compilation Conditions Browser

There are three tabs that can be selected. These show the same information, in different ways:

• Text - individual compilation messages are listed in the top message area; selecting a compilation message will show the data for the selected message in the lower description area. A standard filter allows you to optionally specify a search string to limit viewed messages.
• Tree - default view that shows all errors in a tree representation with tree branches for listing by filename, by function name, and by error classification. Like the text tab mode, selecting a compilation message in the tree view causes the data for the selected message to be shown in the lower description area.
• Output - shows the raw compilation messages that you also see in the Listener window (if compiling from the the Listener)

The description area that is seen in both the Text and Tree tab views of the Compilation Conditions Browser shows a description of any item selected in the compilation conditions area containing more detailed information about the conditions selected in the compilation conditions area. The following information is listed:

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.