All Manuals > LispWorks User Guide and Reference Manual > 38 The HCL Package

NextPrevUpTopContentsIndex

toggle-source-debugging

Function
Summary

Changes compiler settings affecting production of source level debugging information.

Package

hcl

Signature

toggle-source-debugging &optional on => bool

Arguments

on

Flag (t or nil) to control the resulting setting of the variables. The default is t.

Values

bool

The current state of source level debugging: t if source level debugging is on.

Description

toggle-source-debugging sets certain compiler parameters, and also turns leaf case optimizations on (when called with nil) or off (when called with t). For all these parameters, the value nil reduces compilation speed.

toggle-source-debugging is called in the configuration file a-dot-lispworks.lisp, and the initial state of LispWorks such that source level debugging is on.

The parameters relate to information required for source level debugging, cross-referencing and finding all changed definitions.

The parameters (all in the compiler package) are:

*produce-xref-info*

When true, the compiler produces information for the Cross Referencer.

*load-xref-info*

When true, the cross-referencing information produced by the compiler is loaded when the corresponding file is loaded.

*notice-changed-definitions*

When true, the Cross Referencer notices when a function is redefined, including an interpreted redefinition..

*source-level-debugging*

When true, the compiler generates information used by the debugger.

toggle-source-debugging modifies the status of the variables, and then returns the new value. To check whether all the variables are set to true, without modifying them, use source-debugging-on-p.

Cross-referencing information is used by the functions who-calls, who-binds, who-references, who-sets, and friends.

Compatibility notes

In LispWorks 4.2 and earlier, toggle-source-debugging controlled source file recording information. In LispWorks 4.3 and later, this is controlled independently by *record-source-files*.

See also

source-debugging-on-p


LispWorks User Guide and Reference Manual - 13 Feb 2015

NextPrevUpTopContentsIndex