19.8 Some examples

The examples below demonstrate different ways in which the profiler can be configured and code profiled so as to produce different sets of results. In each example, the following piece of code is profiled:

(contain (setq title (make-instance 'title-pane

                                    :text "Title")))

This is a simple piece of code which creates and displays a CAPI title pane; each time you run the code a small window is created on-screen, which you can ignore or remove as soon as it is created.

1. Create a Profiler tool if you have not already done so.
2. Type the code above into the box in the Code to Profile panel.
3. Choose Window > Window Preferences... or click
in the Profiler, and select the General tab, to change the package of the Profiler.

Figure 19.6 Profiler Preferences dialog



4. In the Profiler Preferences dialog, replace the default package in the Package text box with CAPI and click
.
5. Click OK to dismiss the Preferences dialog and apply the change you have made.
6. Click on Profile .

This profiles the functions in the COMMON-LISP , CL-USER and LISPWORKS packages.

Next, add the CAPI package to the list of packages whose functions are profiled.

7. Click Packages .
8. In the dialog, double-click on CAPI in the Unselected Packages list, and click on OK .
9. Click on Profile to profile the code again.

Notice that this time there are many more functions which appear on the stack during profiling.

10. Select a few of the functions listed at the top of the Results area, and look at their function descriptions.

Add the Description area by clicking the Description >> button if you have not already done so.

Notice that most of the functions appearing on the stack are in the CAPI package. It is worth profiling a few functions explicitly, and removing unwanted packages from the list of packages to profile.

11. Click Symbols... , and add the following four functions to the list in the dialog:
funcall unwind-protect make-instance eval

Type the name of each function and press Return or click

to add it to the list.
12. Click OK when you have finished adding to this list.

Now remove the unwanted packages from the list of packages to profile, as follows:

13. Click Packages... .
14. In the dialog click on None to remove all items in the Selected Packages list
15. Click on OK , and profile the code again by clicking on Profile .

Notice that the four functions in the COMMON-LISP package are still being profiled, even though you are no longer profiling all functions from that package by default.