OpenBoot 3.x Command Reference Manual

Forth Source-level Debugger Commands

Table I-43 Forth Source-level Debugger Commands

Command 

Description 

c

"Continue". Switch from stepping to tracing, thus tracing the remainder of the execution of the word being debugged. 

d

"Down a level". Mark for debugging the word whose name was just displayed, then execute it. 

u

"Up a level". Un-mark the word being debugged, mark its caller for debugging, and finish executing the word that was previously being debugged. 

f

Start a subordinate Forth interpreter. When that interpreter exits (with resume), control returns to the debugger at the place where the f command was executed.

g

"Go." Turn off the debugger and continue execution. 

q

"Quit". Abort the execution of the word being debugged and all its callers and return to the command interpreter. 

s

"see". Decompile the word being debugged. 

$

Display the address,len on top of the stack as a text string. 

h

"Help". Display symbolic debugger documentation. 

?

"Short Help". Display brief symbolic debugger documentation.  

debug name

Mark the specified Forth word for debugging. Enter the Forth Source-level Debugger on all subsequent attempts to execute name. After executing debug, the execution speed of the system may decrease until debugging is turned off with debug-off. (Do not debug basic Forth words such as "dup".)

(debug

Like debug except that (debug takes an execution token from the stack instead of a name from the input stream.

debug-off

Turn off the Forth Source-level Debugger so that no word is being debugged. 

resume

Exit from a subordinate interpreter, and go back to the stepper (See the f command in this table.)

stepping

Set step mode for the Forth Source-level Debugger, allowing the interactive, step-by-step execution of the word being debugged. Step mode is the default. 

tracing

Set trace mode for the Forth Source-level Debugger. Tracing enables the execution of the word being debugged, while showing the name and stack contents for each word called by that word. 

<space-bar>

Execute the word just displayed and proceed to the next word.