:hide top-level command

$Revision: 5.0.2.4 $

Arguments: &optional function-name frame-type &key package package-internals

This command and :unhide affect the behavior of :zoom. They allow the user to declare that certain frames should not be printed when the stack is displayed by :zoom. To :hide a frame means that :zoom will not show it, and to :unhide a frame means that :zoom will show it. The objects which can be hidden are functions named by specific symbols, all functions named by symbols in a package, and all frames of a given type.

All functions named by symbols in a package can be hidden by specifying the symbol or string identifying the package. A single function can be hidden by specifying the function name. Note, however, that if there is a function named with the same symbol that names a package, it is impossible to hide the function alone (since :hide will interpret the symbol as naming the package).

The minimal abbreviation for :hide is :hid.

:hide called with no arguments prints out what is currently hidden.

The function-name argument, if supplied, names a function that is to be hidden.

The frame-type argument, if supplied, names the type of frames that are to be hidden. The four valid frame types are:

  1. :binding, which are binding frames (from let, let*, prog, labels, flet, and so on);

  2. :eval, which are evaluation frames;

  3. :interpreter, which are the interpreter machinery frames;

  4. :special-form which are the special form frames.

The package keyword argument can be used to specify that all symbols of the given package should be hidden. The value given for this argument should be a symbol naming a package.

The package-internals keyword argument can be used to specify that internal symbols of the given package should be hidden. The value given for this argument should be a symbol naming a package.

The default set of hidden objects includes:

hidden packages: lep excl system clos debugger multiprocessing

hidden packages internals: top-level

hidden functions: block apply

hidden frames: :interpreter :eval :internal

See top_level.htm for more information on top-level commands. See debugging.htm for information on the debugger.

The general documentation description is in introduction.htm. The index in index.htm.

Copyright (C) 1998-1999, Franz Inc., Berkeley, CA. All Rights Reserved.