tcl.set-break Verb: Access/TCL


Command tcl.set-break Verb: Access/TCL
Applicable release versions: AP/Unix
Category TCL (746)
Description displays or changes the value of the break character used as an optional substitute for the <break> key for the current port.

The initial value of this character is set for the entire virtual machine by the "brkchr" statement in the configuration file.

Without any argument, this command displays the current value.

"set-break off" disables the <break> key.

The value to assign to the <break> key may be referenced by its ASCII or hexadecimal value.

Using "esc" as the value assigns 27 (x'1b').

Using "off" as the value assigns 255 (x'ff').

When this function is enabled by assigning a value other than x'ff' to this character, and when the command "brk-level" has been issued, hitting the corresponding key pushes one more TCL level. When the "brk-debug" command is issued, hitting the corresponding key enters the Pick/BASIC or system debugger.

Assigning an "unreasonable" value to the break character will have unpredictable results. For example, "set-break 13" makes the <return> key push a level or <break>.
Syntax set-break {decimal value} {(options}
set-break {.hexadecimal value} {(options}
set-break {off} {(options}
set-break {esc} {(options}
Options q Quiet. Suppresses all terminal output.
Break value x'1C' (decimal 28)
Displays the current definition for the <break> key.

set-break 3
Break value x'03' (decimal 3)
Previous value x'1C' (decimal 28)
Defines the <break> key as <ctrl>+c.

set-break esc
Break value x'1B' (decimal 27)
Previous value x'03' (decimal 3)
This defines the <escape> key as the <break> key.
Related tcl.set-esc