14.1 Introduction

The Function Call Browser gives you a way to view a user-defined function in the Lisp image together with the functions that call it or the functions it calls.

It has three views.

• The Called By view allows you to examine a graph of the functions which call the function being browsed. This is the default view.
• The Calls Into view allows you to examine a graph of the functions which are called by the function being browsed.
• The Text view lets you see immediate callers and callees of the browsed function using lists rather than a graph.

To create a Function Call Browser, choose Window > Tools > Function Call Browser or click in the LispWorks toolbar. Alternatively, select a function in another tool, and choose Function Calls from the appropriate actions menu to browse the selected function in the Function Call Browser. Finally, in an editor executing Alt+X List Callers or Alt+X List Callees calls up a Function Call Browser on the current function.

Note: the cross references between function calls are generated by the compiler, hence you can use the Function Call Browser only for compiled code. Moreover, the compiler setting to generate cross references must be on when you compile your code. Switch it on by evaluating:

(toggle-source-debugging t)

When cross referencing is on, this line appears in the output of the compiler:

;;; Cross referencing is on