21.4.1.2 Choosing packages

You may often want to profile every function in a package. Click Packages... to specify a list of packages whose functions you want to profile. The dialog shown in Select Packages to Profile dialog appears.

Figure 21.5 Select Packages to Profile dialog

The main part of this dialog consists of two lists:

• The Unselected Packages list shows packages in the Lisp image whose functions are not to be profiled.
• The Selected Packages list shows packages in the Lisp image whose functions are to be profiled.

A global function will be profiled if its symbol is visible in one of the Selected Packages.

In order to add a package to the Selected Packages list, you can do one of three things:

• For each package, type the package name in the Select Package box and press Return or click
.

• Select the package in the Unselected Packages list and click on the >>> button.
• Double-click on the package in the Unselected Packages list.

To remove a package from the Selected Packages list, do one of the following:

• Select the package in the Selected Packages list and click on the <<< button.
• Double-click on the package in the Selected Packages list.

In addition, there are four buttons.

• Click All if you wish to profile all functions in all packages. Be aware that there are significant processing overheads involved if you wish to do this, and the results you get will probably include a lot of unwanted information.
• Click None to clear the list of Selected Packages. This is useful is you only want to profile a few functions, which you can specify easily using the Symbols... button on the Profiler tool itself.
• Click OK to dismiss the dialog when you have finished selecting the packages whose functions you want to profile.
• Click Cancel to cancel the operation. This also dismisses the dialog.