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 @@
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
+
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) +
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.
EW -LIFE 3E8
+ew +life 3e8
Set 16-Bit variable (@ $0300)“Life”