24.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 24.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.

To modify the Selected Packages list:

1. Consider whether one of these buttons offers what you need, or close to it:

All

Adds all packages.

Note: There are significant processing overheads when profiling all functions in all packages, and the results you get may include much unwanted information.

User Only

Adds the CL-USER package.

User and CL

Adds the CL-USER and CL packages.

User and Standard

Adds the CL-USER package along with those packages that you have defined.

Note: The Profiler tool assumes that packages not named in the value of *packages-for-warn-on-redefinition* are user-defined.

2. Add to your Selected Packages list if necessary. You can add a single package in one of three ways:
3. Type the package name in the Select Package box and press Return or click
, or

• Select the package in the Unselected Packages list and click on the >>> button, or
• Double-click on the package in the Unselected Packages list.
• Remove packages from the Selected Packages list if necessary. You can remove a single package in one of two ways:
• Select the package in the Selected Packages list and click on the <<< button, or
• Double-click on the package in the Selected Packages list.

Also you can click the None button 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.

• Finally, click OK to dismiss the dialog when you have finished selecting the packages whose functions you want to profile, or click Cancel to cancel the operation. This also dismisses the dialog.