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 controls the setting of six compiler parameters, and also turns leaf case optimizations on (when called with nil ) or off (when called with t ).

The six parameters are initially set in the configuration file configure.lisp . For all these parameters, the setting nil improves the compilation speed.

The parameters relate to information required for source level debugging, and other operations that need a record of function definitions (operations such as finding all changed definitions, or finding the source of a definition).

The parameters (all internal to the compiler package) are:

*produce-xref-info*

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

*load-xref-info*

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

*notice-changed-definitions*

When t , the Cross Referencer notices when a definition is changed interpretively.

*generate-source-recording*

When t , the compiler generates source recording information.

*source-file-recording*

When t , the source file recording information produced by the compiler is loaded with a fasl file or text file.

*source-level-debugging*

When t , 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 that all the variables are set to true, without modifying them, use source-debugging-on-p .

See also

source-debugging-on-p