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.
To modify the Selected Packages list:
-
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.
-
Add to your Selected Packages list if necessary. You can add a single package in one of three ways:
-
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.
Common LispWorks User Guide (Macintosh version) - 21 Feb 2008