dialog-print-level

Arguments: ide-configuration

This is one of a series of operators which determine the values of various printer variables for use on IDE dialogs. All values can be set on the IDE 2 tab of the Tools | Options. This operator determines the value of *print-level*. Other operators include dialog-print-length (*print-length*), dialog-print-circle (*print-circle*), and dialog-print-array (*print-array*).The general description on this page applies to all the operators (replacing -level appropriately) and so pages describing those operators simply link here.

This user option determines the value to which *print-level* will be bound when the IDE is printing arbitrary Lisp values into widgets in various tool dialogs. The affected dialogs include the backtrace pane (which appears when you elect to debug an error that is signaled), the listener's drop-down history, the Inspect dialog, the Trace Dialog, and some widgets in the Stepper Dialog.

Typically you would modify this option interactively on the IDE 2 tab of the Tools | Options, though you could also set it programmatically with a form like this one:

(setf (ide:dialog-print-level (cg:configuration ide:*ide-system*))
      3)

A small value is typically desirable because it usually affects how values are displayed on a single line in a widget where there's not a lot of room. To see a longer representation, you could for example use Tools | Return Selected Object to return a selected value to the listener, where it will be printed using the value of tpl:*print-level* and associated variables in the top-level package. Or use Tools | Inspect Selected Object to see more information about the selected value in the inspector.

It is likely a bad idea to set this variable to nil, and likewise for dialog-print-length and dialog-print-circle, due to delays that could occur if arbitrary lists that the IDE encounters are circular or deeply nested or extremely long. You might set it temporarily to nil, though, if needed for a specific purpose.

Prior to release 10.0, this option was known as backtrace-print-level. For 10.0 it was renamed and applied to additional dialogs.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page is new in the 10.0 release.
Created 2019.8.20.