10 The HCL Package

toggle-source-debugging

Function

Summary

Toggles the production of source level debugging information.

Package

hcl

Signature

toggle-source-debugging &optional on => bool

Arguments

on: Flag (t ornil) to control the resulting setting of the variables. The default ist.

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. (These parameters are initially set in the configuration fileconfigure.lisp.) For all these parameters, the settingnil 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*

Whent, the compiler produces information for the Cross Referencer.

*load-xref-info*

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

*notice-changed-definitions*

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

*generate-source-recording*

Whent, the compiler generates source recording information.

*source-file-recording*

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

*source-level-debugging*

Whent, the compiler generates information used by the debugger.

toggle-source-debugging modifies the status of the variables, and then returns the new value. To test the setting of any variable, without modifying it, usesource-debugging-on-p.

See also

source-debugging-on-p