diff --git a/help/dbg-symbols.html b/help/dbg-symbols.html index a4c6a43d..7fb04f90 100644 --- a/help/dbg-symbols.html +++ b/help/dbg-symbols.html @@ -6,11 +6,42 @@

Symbols

-

AppleWin supports loading of ACME, and Merlin Symbol Tables. The default - filename read into the Main Symbol Table is “APPLE2E.SYM”.

-

Looking up symbols is now easier.  Can't remember an address of a symbol, - or can't remember the symbol for an address?  The new symbol commands - makes it easy:

+

+ When a programmer writes an assembly language program instead of directly referring to a memory address over and over again they use a symbolic name instead. + For example, instead of always directly hard-coding $C000 everywhere to read the keyboard they would instead write: +

+    KEYBOARD EQU $C000
+1   LDA KEYBOARD
+    BPL 1
+

+

When debugging assembly programs since you typically don't have the source file availabe you can tell the debugger how to interpret a memory address as a variable name or symbol. + A symbol is the symbolic name and the address assigned to it.

+

AppleWin supports loading of the assemblers ACME, and Merlin's symbol tables -- a collection of symbols, one per line, organized and collectively called a symbol table. +The semi-colon is a comment-till-end-of-line. The file format per line is: ADDRESS SYMBOL

+

e.g. +

+; IO Map
+C000 KEYBOARD
+

+ +

There are 9 symbol tables to help organize "modules"; each symbol table individually can be turned off/on independently. +

+ MAIN    APPLE2E.SYM
+ BASIC   A2_BASIC.SYM
+ ASM     A2_ASM.SYM
+ User1   A2_USER1.SYM
+ User2   A2_USER2.SYM
+ Src1    A2_SRC1.SYM
+ Src2    A2_SRC2.SYM
+ DOS33   A2_DOS33.SYM
+ PRODOS  A2_PRODOS.SYM
+

+

On startup the debugger reads 3 symbol tables by default: Main, Basic, User1.

+

+

Looking up symbols is easy.  If you can't remember an address of a symbol, + or the reversse -- can't remember the symbol for an address -- you can use the following symbol commands: + (#### referes to either a hex address or a symbolic name) +



@@ -48,22 +79,22 @@ the Symbol or Address, and display which Symbol Table it is in.

-

SYMUSER +

SYMUSER LOAD

-

Loads -the User Symbol Table.

+

Reloads +the User Symbol Table: A2_USER1.SYM

-

SYMUSER +

SYMUSER CLEAR

-

Clears -the User Symbol Table!

+

Clears +the User Symbol Table from RAM.

@@ -239,8 +270,8 @@ LIFE 64

-

EW -LIFE 3E8

+

ew +life 3e8

Set 16-Bit variable (@ $0300)“Life”