trace-format

Function

Package: common-graphics

Arguments: format-string &rest args

This function is used to insert arbitrary comments and data into trace output. Formats a string using format-string and args just as they are used in a call to format, and inserts that string into the trace output at the current position.

If the trace dialog is currently visible, an item is added to its trace outline. When an item that was created by a call to trace-format is selected in the trace outline, each of the args will appear individually in the trace dialog's Arguments item-list and be accessible as lisp objects, just as the arguments to traced functions are. Trace-output items appear in a different color than traced function calls to differentiate them.

If the trace dialog is not currently visible, the string is printed to *trace-output* as a comment along with other trace output.

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.