The Trace dialog provides a graphical display (using an outline
control) of traced functions and how they are called. If any function
in the display is selected (4 fact is selected in
the illustration), the arguments to that function are displayed in the
Arguments field, the values returned in the Values Returned field. The
Stack field shows a stack backtrace (function names only) to the depth
indicated in the Depth field. Click on Clear to clear the
display. Scroll bars appear in the Trace History field if necessary
(the illustration does not show scroll bars). Clicking on Scroll to
Bottom displays the bottom of the Trace History.
The numbers next the function names are just labels.
Note: when the Trace dialog is open, even if it is iconized or buried
under other windows, all trace output goes to it and not to the debug
window. That is, when the state of the Trace dialog is
:normal, :maximized, or
:icon, trace output goes to it. If the state is
:shrunk, trace output does not go to it. (Nor,
obviously, when the dialog does not exist at all.)
Traced calls that occur in multiple threads are combined into the single outline widget of the Trace Dialog, but hierarchies of traced calls in multiple threads are never interleaved in the outline. Specifically, the tree of calls that appear under a single top-level item in the trace outline are always calls that occurred in the same thread as that top-level item; any traced calls that occurred in other threads during the call represented by that top-level item will appear under further distinct top-level items of the trace outline. The numbers at the left of each outline item, on the other hand, indicate the global order in which the individual calls occurred; so the numbers will not be in numerical order from top to bottom if hierarchies of traced calls in multiple threads overlap in time. The title of the Trace Dialog indicates the thread in which the currently selected call occurred.
Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.
The documentation is described in introduction.htm and the index is in index.htm.
Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.
Created 2000.10.5.