mirror of
https://github.com/AppleWin/AppleWin.git
synced 2024-08-17 13:29:03 +00:00
258 lines
12 KiB
HTML
258 lines
12 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>AppleWin Debugger Tutorial</title>
|
|
<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252">
|
|
</head>
|
|
<body style="DIRECTION: ltr" lang="en-US">
|
|
<h2><a name="Symbols"></a>Symbols</h2>
|
|
<p>AppleWin supports loading of ACME, and Merlin Symbol Tables. The default
|
|
filename read into the Main Symbol Table is “APPLE2E.SYM”.</p>
|
|
<p>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:</p>
|
|
<p><br>
|
|
<br>
|
|
</p>
|
|
<table border="0" cellpadding="2" cellspacing="0" width="80%">
|
|
<COLGROUP>
|
|
<col width="64">
|
|
<col width="192">
|
|
<tbody>
|
|
<tr bgcolor="#000000">
|
|
<td bgcolor="#000000" width="25%">
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
</td>
|
|
<td bgcolor="#000000" width="75%">
|
|
<p style="FONT-STYLE: normal"><font color="#ffffff"><b>Effect</b></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#cccccc">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYM</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Display
|
|
the number of symbols in the Main, User, and Source symbol tables.</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#999999">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYM
|
|
####</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Look-up
|
|
the Symbol or Address, and display which Symbol Table it is in.</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#cccccc">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYMUSER
|
|
LOAD</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Loads
|
|
the User Symbol Table.</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#999999">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYMUSER
|
|
CLEAR</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clears
|
|
the User Symbol Table!</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#cccccc">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYMMAIN
|
|
####</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Look-up
|
|
only in the Main symbol table.</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#999999">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYMUSER
|
|
####</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Look-up
|
|
only in the User symbol table.</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#cccccc">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYMSRC
|
|
####</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Look-up
|
|
only in the Source symbol table.</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#999999">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYM
|
|
name = ####</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Add
|
|
(or update) a symbol in the User table with the new Address.</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#cccccc">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYM
|
|
! name</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Remove
|
|
a symbol from the User table.</span></i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#999999">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">E
|
|
symbol ##</span></b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i>Set memory (at the symbol Address) to the 8-Bit (byte) Value.</i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#cccccc">
|
|
<td width="25%">
|
|
<p><font color="#000000" face="Courier"><b>EB symbol ####</b></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i>Alias for E.</i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#999999">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>E8 symbol ####</b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i>Alias for E.</i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#cccccc">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>EW symbol ####</b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i>Set memory (at the symbol Address) to the 16-Bit (word) Value.</i></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#999999">
|
|
<td width="25%">
|
|
<p><font color="#000000"><font face="Courier"><b>E16 symbol ####</b></font></font></p>
|
|
</td>
|
|
<td width="75%">
|
|
<p><i>Alias for EW.</i></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p><br>
|
|
<br>
|
|
</p>
|
|
<p><font size="4"><b>Examples</b>:</font></p>
|
|
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="799">
|
|
<COLGROUP>
|
|
<col width="276">
|
|
<col width="515">
|
|
<tbody>
|
|
<tr bgcolor="#00b8ff">
|
|
<td bgcolor="#30c0ff" width="276">
|
|
<p><font color="#000000"><b>Input</b></font></p>
|
|
</td>
|
|
<td bgcolor="#30c0ff" width="515">
|
|
<p><font color="#000000"><b>Effect</b></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#000000">
|
|
<td width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SYM</b></font></font></p>
|
|
</td>
|
|
<td width="515">
|
|
<p><font color="#ffffff"><i>Displays number of symbols in the Main, User, and Source
|
|
tables.</i></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#000000">
|
|
<td width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SYMMAIN CLEAR</b></font></font></p>
|
|
</td>
|
|
<td width="515">
|
|
<p><font color="#ffffff"><i>Clears the main symbol table!!</i></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#000000">
|
|
<td width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SYMMAIN LOAD APPLE2E.SYM</b></font></font></p>
|
|
</td>
|
|
<td width="515">
|
|
<p><font color="#ffffff"><i>Reloads the main symbol table.</i></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#000000">
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b>SYM FA62</b></font></font></p>
|
|
</td>
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Look up the Address $<b><font color="#ffff00">FA62</font></b> (RESET).</i></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#000000">
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="BACKGROUND: rgb(0,0,0) 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYM
|
|
HOME</span></b></font></font></p>
|
|
</td>
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Look up the Address $<b><font color="#ffff00">FC58</font></b> (HOME).</i></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#000000">
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="BACKGROUND: rgb(0,0,0) 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">SYM
|
|
LIFE = 300</span></b></font></font></p>
|
|
</td>
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Define a new user symbol, called “Life” at Address $0300.</i></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#000000">
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="BACKGROUND: rgb(0,0,0) 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">E
|
|
LIFE 64</span></b></font></font></p>
|
|
</td>
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Set 8-Bit variable (@ $<b><font color="#ffff00">0300</font></b>)“Life”
|
|
to 100 (decimal).</i></font></p>
|
|
</td>
|
|
</tr>
|
|
<tr bgcolor="#000000">
|
|
<td bgcolor="#000000" width="276">
|
|
<p><font color="#00b8ff"><font face="Courier"><b><span style="BACKGROUND: rgb(0,0,0) 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">EW
|
|
LIFE 3E8</span></b></font></font></p>
|
|
</td>
|
|
<td bgcolor="#000000" width="515">
|
|
<p><font color="#ffffff"><i>Set 16-Bit variable (@ $<b><font color="#ffff00">0300</font></b>)“Life”
|
|
to 1000 (decimal).</i></font></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>
|
|
<br>
|
|
|
|
</p>
|
|
</body>
|
|
</html>
|