diff --git a/web/Intro_To_New_Debugger.htm b/web/Intro_To_New_Debugger.htm index c6015557..817dda67 100644 --- a/web/Intro_To_New_Debugger.htm +++ b/web/Intro_To_New_Debugger.htm @@ -14,8 +14,7 @@
By Michael Pohoreski.
- -Revision 4. July 1, 2006.
+Revision 6. August 30, 2008 (Debugger version 2.6.0.6).
On the left is the disassembly view. On the righ is +
On the left is the disassembly view. On the right is the info panael, which shows registers, stack, zero-page pointers, breakpoints, watches, and 2 mini-memory views.
@@ -242,6 +241,20 @@ for specific command. +HELP *
+ +Display Help +for all commands.
+ +Hex Values may be ambiguous, if their corresponding symbol is defined. To avoid confusion, don’t define symbols such as the popular $DEAD, -$BEEF, $C0DE, $CAFE, etc. An example is given with A1.
+$BEEF, $C0DE, $CAFE, etc. An example is given with A1 in the following example. @@ -2371,7 +2384,7 @@ message displayed when booted, showing Apple Model.Switch to -the Data Window to view memory. Most scrolling keys work.
+the Data Window to view memory. (Note: Not implimented yet!)You can search memory for hex values. Wildcard -support is also supported via the '?' wildcard -operator, including nibble searching. -A single '?' by itself, means match one byte of any -value. A hex value -with the high nibble or low nibble of '?' will mask -off the corresponding -nibble. (At the moment there is no way to refer to the list -of results. -A future version will support _# to reference search -result's addresses.)
+You can search memory for specific text, hex, or even wildcard values, + using the 'S' command. + +
To search for ASCII text, use double-quotes; + for Apple text (the high-bit set), use single-quotes; + and to search for wildcard bytes and nibbles, use the '?' wildcard + operator. A single '?' by itself, means match an byte of any + value. A hex value with the high nibble or low nibble with a '?' will match any nibble. +
-Searching memory for text is forthcoming in a future version -of the debugger.
+Since there may be a few results returned, the at (@) has been over-loaded + to function both as a command and as an operator. You can use the '@' command + by itself with no arguments to list the matches found. The '@' operator can be + used with other commands to reference the nth search result's addresses. +
S +#,len …
+Search memory for 8-bit hex value(s).
+@
+Display list of address found that match the search arguments.
+SH #,len byte1 …
-Search memory for 8-bit hex value(s).
-S +F000,1000 'Apple'
+Search +memory for Apple High Bit text
+SH -800,8000 C030
+S +F000,1000 C030
SH -800,8000 AD ? C0
+F000:FFFF AD ? C0SH -800,8000 3? C0
+F000,800 3? C0SH -800,8000 ?1 C0
+F000,FFF ?1 C0L -_1
+
+ S F000:FFFF C050
+
U
+@3-1
Disassemble -from search result #1 -address.
- -Note: Not -yet implemented!
- +Search for TXTCLR, and disassemble +from search result #3 +address minus 1 byte.
Switch -to the Data window to view memory. Most scrolling keys work.
+to the Data window to view memory. (Note: Not implimented yet!)Command
-Effect
-RUN filename
-Runs the specified script filename; the filename may be quoted.
-ECHO string
-Echo the text to the debugger console. The string may optionally be quoted.
-// comment
+A C++ style comment. Ignores the rest of the command line..
+