From 1f3b3c0f13608562e4309e2492909cf2dc941253 Mon Sep 17 00:00:00 2001 From: mpohoreski Date: Sun, 31 Aug 2008 08:50:49 +0000 Subject: [PATCH] expanded search topics, new command // --- AppleWin/web/Intro_To_New_Debugger.htm | 139 +++++++++++++++---------- 1 file changed, 84 insertions(+), 55 deletions(-) diff --git a/AppleWin/web/Intro_To_New_Debugger.htm b/AppleWin/web/Intro_To_New_Debugger.htm index c6015557..817dda67 100644 --- a/AppleWin/web/Intro_To_New_Debugger.htm +++ b/AppleWin/web/Intro_To_New_Debugger.htm @@ -14,8 +14,7 @@

AppleWin Debugger Tutorial

By Michael Pohoreski.

- -

Revision 4.  July 1, 2006.

+

Revision 6.  August 30, 2008 (Debugger version 2.6.0.6).

Table of Contents

@@ -109,7 +108,7 @@ syntax coloring in the disassembly view, and info panel.  All the colors can be customized to your liking.  See the Colors section for details.

-

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.

+ + + + @@ -1148,7 +1161,7 @@ possible.

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!)

@@ -2399,20 +2412,21 @@ the Code Window to view the disassembler.

Searching Memory

-

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. +


@@ -2435,18 +2449,32 @@ of the debugger.

+ +

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).

- - @@ -2490,11 +2518,22 @@ of the debugger.

+ + +

S +F000,1000 'Apple'

+ + +

Search +memory for Apple High Bit text

+ + + -

SH -800,8000 C030

+

S +F000,1000 C030

@@ -2510,7 +2549,7 @@ memory for speaker access.

SH -800,8000 AD ? C0

+F000:FFFF AD ? C0

@@ -2526,7 +2565,7 @@ memory for “ LDA $C0xx”.<

SH -800,8000 3? C0

+F000,800 3? C0

@@ -2542,7 +2581,7 @@ memory for speaker access $C03x.<

SH -800,8000 ?1 C0

+F000,FFF ?1 C0

@@ -2557,21 +2596,17 @@ memory for soft-switch $C0x1.

-

L -_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.

- @@ -3413,7 +3448,7 @@ DATA

Switch -to the Data window to view memory. Most scrolling keys work.

+to the Data window to view memory.  (Note: Not implimented yet!)

@@ -5145,50 +5180,44 @@ command. - - +

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..

+ + +