trace-format

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.

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

See also process-trace-color and with-trace-color.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.