From 9e80202352dd49bdd9e67b8b906d86f058431505 Mon Sep 17 00:00:00 2001
From: Timothy Pearson <tpearson@raptorengineering.com>
Date: Sat, 11 May 2019 15:12:49 -0500
Subject: Initial import of abandoned HQEMU version 2.5.2
---
src/roms/openbios/Documentation/README.debugger | 50 +++++++++++++++++++++++++
1 file changed, 50 insertions(+)
create mode 100644 src/roms/openbios/Documentation/README.debugger
(limited to 'src/roms/openbios/Documentation/README.debugger')
diff --git a/src/roms/openbios/Documentation/README.debugger b/src/roms/openbios/Documentation/README.debugger
new file mode 100644
index 0000000..a44f5a8
--- /dev/null
+++ b/src/roms/openbios/Documentation/README.debugger
@@ -0,0 +1,50 @@
+The following Forth words can be used for debugging:
+
+ debug <xt> - Mark word for debugging
+ debug-off - Unmark all words for debugging
+ resume - Return from subordinate Forth interpreter
+
+The source debugger also implements the following commands when it has been activated:
+
+ Up - Unmark current word for debugging, mark parent and continue
+ Down - Mark next word for debugging
+ Trace - Continue execution until end of word displaying
+ debug information
+ Rstack - Display contents of the Rstack
+ Forth - Launch subordinate Forth interpreter
+
+An example session:
+0 > see boot
+: boot
+ linefeed parse cr " platform-boot" $find if
+ execute then
+ 2drop cr " Booting " type type cr " ... not supported on this system." type cr
+ ;
+ ok
+0 > debug boot
+Stepper keys: <space>/<enter> Up Down Trace Rstack Forth
+ ok
+0 > boot
+: boot ( Empty )
+00000000ffe26b08: linefeed ( a )
+00000000ffe26b10: parse ( ffec6e24 0 )
+00000000ffe26b18: cr
+ ( ffec6e24 0 )
+00000000ffe26b20: (") ( ffec6e24 0 ffe26b30 d )
+00000000ffe26b40: $find ( ffec6e24 0 ffe31710 ffffffffffffffff )
+00000000ffe26b48: do?branch ( ffec6e24 0 ffe31710 )
+00000000ffe26b58: execute [sparc64] Booting file 'cdrom' with parameters ''
+Not a bootable ELF image
+Not a Linux kernel image
+Not a bootable a.out image
+Loading FCode image...
+Loaded 5936 bytes
+entry point is 0x4000
+Evaluating FCode...
+open isn't unique.
+Boot load failed.
+ ( Empty )
+00000000ffe26b60: dobranch ( Empty )
+00000000ffe26bf8: (semis)
+[ Finished boot ] ok
+0 >
--
cgit v1.1