The file Common/Romtools.fth contains debugging tools and various utilities.
If you only want the debug tools, compile Common/dump.fth or Common/Devtools.fth (32 bit systems) rather than Common/Romtools.fth.
: .BYTE \ b8 --
Display a byte as two hex digits.
: .WORD \ w16 --
Display a 16 bit word as four hex digits.
: .DWORD \ l --
Display a 32 bit item as eight hex digits.
: .ASCII \ b --
Display a byte as a character if the code is printable,
otherwise display a dot.
: dump \ addr len --
Dump a block of memory byte by byte. 16 bit version.
: Cdump \ addr len --
Dump a block of code memory byte by byte. 16 bit Harvard
version.
: dump \ addr len --
Dump a block of memory byte by byte. 32 bit version.
: Cdump \ addr len --
Dump a block of code memory byte by byte. 32 bit Harvard
version.
: .S \ i*x -- i*x
Non-destructive stack display.
: ? \ addr --
Display the contents of addr in the current base.
In an embedded system FORGET
and friends are only
useful when compiling code into RAM. FORGET
is used
to remove words recently compiled.
: Trim \ nfa-to-forget wid --
Trim the threads in a wordlist.
: (forget) \ nfa -- ; forgets back to given nfa
Forget all words back to the given nfa.
: $FORGET \ $addr --
Forget a word whose name is given as a counted string.
: FORGET \ -- ; FORGET <name>
The name to forget follows in input stream
: Vocs \ --
Display a list of all the vocabularies in the system.
: .Voc \ addr --
Try to display the vocabulary whose wid is at addr.
: Order \ --
Display the CONTEXT
search order and the CURRENT
vocabulary.