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 (127 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.