Updated AW-help's debugger section with Michael's v3 tutorial
This commit is contained in:
tomch
parent
af04ad4cf0
commit
d483b34d84
14 changed files with 3189 additions and 95 deletions
|
|
@ -82,6 +82,57 @@
|
|||
<param name="Name" value="Uthernet network card">
|
||||
<param name="Local" value="uthernet.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Debugger">
|
||||
<param name="Local" value="dbg-toc-intro.html">
|
||||
<param name="ImageNumber" value="2">
|
||||
</OBJECT>
|
||||
<UL>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Entering the debugger">
|
||||
<param name="Local" value="dbg-entering-debugger.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Scrolling">
|
||||
<param name="Local" value="dbg-scrolling.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Registers">
|
||||
<param name="Local" value="dbg-registers.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Flags">
|
||||
<param name="Local" value="dbg-flags.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Execution">
|
||||
<param name="Local" value="dbg-execution.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Memory">
|
||||
<param name="Local" value="dbg-memory.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Symbols">
|
||||
<param name="Local" value="dbg-symbols.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Calculator">
|
||||
<param name="Local" value="dbg-calculator.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Windows">
|
||||
<param name="Local" value="dbg-windows.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Breakpoints">
|
||||
<param name="Local" value="dbg-breakpoints.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Configuration">
|
||||
<param name="Local" value="dbg-configuration.html">
|
||||
</OBJECT>
|
||||
</UL>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="AppleWin Configuration">
|
||||
<param name="Local" value="configuration.html">
|
||||
|
|
@ -110,100 +161,6 @@
|
|||
<param name="URL" value="cfg-disk.html">
|
||||
</OBJECT>
|
||||
</UL>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Using the Debugger">
|
||||
<param name="Local" value="debug.html">
|
||||
<param name="ImageNumber" value="2">
|
||||
</OBJECT>
|
||||
<UL>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="The Debugger Screen">
|
||||
<param name="Local" value="db-screen.html">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Debugger Commands">
|
||||
<param name="Local" value="db-cmds.html">
|
||||
<param name="ImageNumber" value="2">
|
||||
</OBJECT>
|
||||
<UL>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Breakpoint Clear">
|
||||
<param name="Local" value="dbg-commands.html#BC">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Breakpoint Disable">
|
||||
<param name="Local" value="dbg-commands.html#BD">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Breakpoint Enable">
|
||||
<param name="Local" value="dbg-commands.html#BE">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Breakpoint Set">
|
||||
<param name="Local" value="dbg-commands.html#BP">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Black and White">
|
||||
<param name="Local" value="dbg-commands.html#BW">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Color">
|
||||
<param name="Local" value="dbg-commands.html#COL">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Go">
|
||||
<param name="Local" value="dbg-commands.html#G">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Input">
|
||||
<param name="Local" value="dbg-commands.html#I">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Feed Keystroke">
|
||||
<param name="Local" value="dbg-commands.html#KEY">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Memory Dump">
|
||||
<param name="Local" value="dbg-commands.html#MD">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Code Dump">
|
||||
<param name="Local" value="dbg-commands.html#MDC">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Memory Enter">
|
||||
<param name="Local" value="dbg-commands.html#ME">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Memory Fill">
|
||||
<param name="Local" value="dbg-commands.html#MF">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Output">
|
||||
<param name="Local" value="dbg-commands.html#O">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Set Register">
|
||||
<param name="Local" value="dbg-commands.html#R">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Reset Flag">
|
||||
<param name="Local" value="dbg-commands.html#RF">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Set Flag">
|
||||
<param name="Local" value="dbg-commands.html#SF">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Trace">
|
||||
<param name="Local" value="dbg-commands.html#T">
|
||||
</OBJECT>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Remove Instruction">
|
||||
<param name="Local" value="dbg-commands.html#ZAP">
|
||||
</OBJECT>
|
||||
</UL>
|
||||
</UL>
|
||||
<LI> <OBJECT type="text/sitemap">
|
||||
<param name="Name" value="Resources">
|
||||
<param name="Local" value="resources.html">
|
||||
|
|
|
|||
391
AppleWin/help/dbg-breakpoints.html
Normal file
391
AppleWin/help/dbg-breakpoints.html
Normal file
|
|
@ -0,0 +1,391 @@
|
|||
<!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="Breakpoints"></a>Breakpoints</h2>
|
||||
<p>You now have a variety of options when specifying a breakpoint.
|
||||
Breakpoints can also be disabled, and later re-enabled. This lets ones
|
||||
set a bunch of breakpoints, and quickly re-activate them without having to
|
||||
re-enter the breakpoint logic.</p>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<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">BPA
|
||||
r [op] value</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">Adds
|
||||
(conditional) Breakpoint.<br>
|
||||
|
||||
Default operator is equal ‘=’<br>
|
||||
|
||||
(In a future version, will dispatch to BPX, BPR, BPP, or BPIO.)</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">BPX<br>
|
||||
|
||||
BPX expression<br>
|
||||
|
||||
BPX address[,len]<br>
|
||||
|
||||
BPX [op] symbol</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
|
||||
Breakpoint trigger to stop executing when the PC is within the range of
|
||||
the Address, Symbol, or Expression. i.e. Range is: [addr,addr+len)<br>
|
||||
|
||||
Default length is 1.<br>
|
||||
|
||||
Default comparision operator is equal ‘=’</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">BP</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">Currently
|
||||
an Alias for BPX.<br>
|
||||
|
||||
(In a future version, will also support Loading and Saving of
|
||||
breakpoints.)</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">BPM
|
||||
address[,len]</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
|
||||
Breakpoint trigger when memory is accessed by 6502.</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">BPR
|
||||
reg [op] value</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
|
||||
Breakpoint trigger when Register’s ‘reg’
|
||||
value is compared to the Value.</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">BD</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">Disable
|
||||
Breakpoint (grayed out).</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">BE</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">Enable
|
||||
Breakpoint (colored red).</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">BC
|
||||
#</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">Clear
|
||||
specified Breakpoint.<br>
|
||||
|
||||
Note: The asterisk ‘*’ may be used o clear all
|
||||
breakpoints.</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">BL</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">List
|
||||
Breakpoints.</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">BPIO</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">(In
|
||||
a future version, will add Breakpoint trigger on memory read or write.)</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">BPP</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">(In
|
||||
a future version, will add Breakpoint trigger on specific flag cleared
|
||||
or set.)</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p>The general format for the conditional breakpoint is:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><i>BPA register [operator] value.</i></p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>You can use the following comparison operators:</p>
|
||||
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="26">
|
||||
<col width="64">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="10%">
|
||||
<p><font color="#ffffff"><b>Op</b></font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Name</b></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>=</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Equal</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when register is equal to value.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>!</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Not Equal</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when register is not equal to value.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Less Than</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when register is less than value.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Greater Than</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when register is greater than value.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p>Breaking on any of the 6502 registers is fully supported:</p>
|
||||
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="26">
|
||||
<col width="64">
|
||||
<col width="166">
|
||||
<thead>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="10%">
|
||||
<p><font color="#ffffff"><b>Reg</b></font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Name</b></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>A</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Accumulator</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when Accumulator is triggered.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>X</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Register X</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when Index X is triggered.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>Y</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Register Y</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when Index Y is triggered.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>PC</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Program Counter</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when PC is triggered.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>S</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Stack Pointer</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when Stack Pointer is triggered.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>P</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Processor Status (flags)</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Break when flags are triggered.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<h2><font size="4">Notes:</font></h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p><i>BPP, Breaking on a specific flag (either set, or cleared) is forth-coming in a
|
||||
future version.</i></p>
|
||||
</li>
|
||||
</ul>
|
||||
<br>
|
||||
<p><font size="4"><b>Examples</b>:</font></p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="64">
|
||||
<col width="192">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="25%">
|
||||
<p><font color="#000000"><b>Input</b></font></p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="75%">
|
||||
<p><font color="#000000"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>BPX < F000</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><font color="#ffffff"><i>Add Breakpoint when PC < $<b><font color="#ffff00">FA62</font></b>.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>BPX PC < D000</b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Add Breakpoint when PC < $ <b><font color="#ffff00">D000</font>.</b></i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">BPR
|
||||
A 0</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Adds Breakpoint when Accumulator is zero.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">BPR
|
||||
A ! 0</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Adds Breakpoint when Accumulator is <b>not</b> zero.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">BPR
|
||||
S < 1FF</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Adds Breakpoint when Stack has had something pushed onto it.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
</body>
|
||||
</html>
|
||||
323
AppleWin/help/dbg-calculator.html
Normal file
323
AppleWin/help/dbg-calculator.html
Normal file
|
|
@ -0,0 +1,323 @@
|
|||
<!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="Calculator"></a>Calculator</h2>
|
||||
<p>There is a basic mini hex calculator built in. It can do Addition,
|
||||
Subtraction, Division, Modulus, bit-wise And, bit-wise Or, bit-wise Exclusive
|
||||
Or, and bit-wise Negation, with Values, Register and Symbols. It will
|
||||
display results in Hex, Binary, Decimal, and as a Character (single quoted.)</p>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="26">
|
||||
<col width="64">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="10%">
|
||||
<p><font color="#ffffff"><b>Op</b></font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Name</b></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>+</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Plus</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Addition.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>-</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Minus</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Subtraction.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>%</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Percent</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Calculate remainder (modulus).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>/</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Forward Slash</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Calculate quotient.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>&
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Ampersand</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Bit-wise AND.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>|
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Pipe</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Bit-Wise (inclusive) OR.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>^</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Caret</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Bit-Wise (exclusive) OR, also called XOR.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>!</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Exclamation</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Bit-Wise NOT.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<h2><font size="4">Notes:</font></h2>
|
||||
<ul>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><i>The unary bit-wise Negation operator, ‘!’ only effects
|
||||
the next immediate expression.</i></p>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><i>There is (currently) no multiplication operator, due
|
||||
to the asterisk ‘*’ being used for the wild card operator.</i></p>
|
||||
</li>
|
||||
</ul>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="64">
|
||||
<col width="192">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="25%">
|
||||
<p><font color="#000000"><b>Input </b></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="75%">
|
||||
<p><font color="#000000"><b>Effect </b></font>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>CALC 9+1</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate 9+1, in hex.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
A 1</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Accumulator to 1.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
X 2</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set X to 2.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
Y 3</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Y to 3.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
A+X+Y</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate sum of registers.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
1FF-S</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate Stack Depth.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
BRKV+1</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate address of Break Vector + 1<br>
|
||||
(First byte is a jump instruction.)</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
A+#A</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate Accumulator plus (decimal) 10.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
A+0A</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate Accumulator plus (decimal) 10.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
A+$0A</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate Accumulator plus (decimal) 10.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
0A+0A</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate 10 + 10, in hex.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
$RESET+1</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate Address of Reset + 1 (First opcode is one byte, CLD).</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
!HOME</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate bit-wise NOT.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
X & Y</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate bit-wise AND of Register X , Register Y.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
X | Y</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate bit-wise OR of Register X , Register Y.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
X ^ Y</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate bit-wise XOR of Register X , Register Y.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
X / Y</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate division of Register X , Register Y.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CALC
|
||||
X % Y</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Calculate remainder of Register X , Register Y.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>
|
||||
</p>
|
||||
</body>
|
||||
</html>
|
||||
410
AppleWin/help/dbg-configuration.html
Normal file
410
AppleWin/help/dbg-configuration.html
Normal file
|
|
@ -0,0 +1,410 @@
|
|||
<!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="Configuration"></a>Configuration</h2>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<h3><a name="Colors"></a>Colors</h3>
|
||||
<p>The commands to change color schemes, and colors are:</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">COLOR</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">Switch
|
||||
to color scheme.</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">MONO</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">Switch
|
||||
to monochrome scheme.</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">COLOR
|
||||
#</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">Displays
|
||||
the Red, Green, and Blue values for the specified color.</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">COLOR
|
||||
# # # #<br>
|
||||
|
||||
COLOR # R G B</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">Sets
|
||||
the colors to the new Red, Green, and Blue values.<br>
|
||||
|
||||
First # is the color.</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p>Some people prefer monochrome (easier on the eyes, in full screen), so you may
|
||||
want to use that setting:</p>
|
||||
<br>
|
||||
<p><font size="4"><b>Examples</b>:</font></p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="64">
|
||||
<col width="192">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="25%">
|
||||
<p><font color="#000000"><b>Input</b></font></p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="75%">
|
||||
<p><font color="#000000"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>MONO</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><font color="#ffffff"><i>Switch to the monochrome scheme.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>COLOR</b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Switch to the color scheme.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">COLOR
|
||||
0 10 20 40</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Sets the console background color to slate gray: RGB 10,20,40</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<h3><a name="Fonts"></a>Fonts</h3>
|
||||
<p>The font Type, and Spacing can be configured, to show more or less lines in the
|
||||
disassembly window.</p>
|
||||
<br>
|
||||
<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>FONT MODE #</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Set disassembler line spacing for the current font.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>FONT “name”</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Switch disassembler to new font.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>FONT “name” #</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Switch disassembler to new font with specified height (in pixels)</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<p><font size="4"><b>Examples</b>:</font></p>
|
||||
<table 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 bgcolor="#000000" width="276">
|
||||
<p><font color="#30c0ff"><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">FONT
|
||||
MODE 0</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="515">
|
||||
<p><font color="#ffffff">“<i>Classic” Line Spacing. Shows the fewest amount of lines.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="276">
|
||||
<p><font color="#30c0ff"><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">FONT
|
||||
MODE 1</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="515">
|
||||
<p><font color="#ffffff">“<i>Improved” Line Spacing. (Default)</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="276">
|
||||
<p><font color="#30c0ff"><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">FONT
|
||||
MODE 2</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="515">
|
||||
<p><font color="#ffffff">“<i>Minimal” Line Spacing. Shows the most amount of lines.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="276">
|
||||
<p><font color="#30c0ff"><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">FONT
|
||||
“Arial”</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="515">
|
||||
<p><font color="#ffffff"><i>Switch disassembler font to Arial.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="276">
|
||||
<p><font color="#30c0ff"><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">FONT
|
||||
“Courier New”</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="515">
|
||||
<p><i>Switch disassembler font to Courier New.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<h3><a name="Scripts"></a>Scripts</h3>
|
||||
<p>
|
||||
You can run custom batch or script files that contain debugger commands.
|
||||
Scripts files do not echo their input; to print a string to the output console
|
||||
window, use the <b>ECHO</b> command.
|
||||
</p>
|
||||
<br>
|
||||
<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>RUN </b></font></font><b><span style="COLOR: black; FONT-FAMILY: Courier">filename</span></b></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Runs the specified script filename; the filename may be quoted</i><i>.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="25%">
|
||||
<p><b><span style="COLOR: black; FONT-FAMILY: Courier">ECHO string</span></b></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Echo the text to the debugger console. The string may optionally be quoted.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<p><font size="4"><b>Examples</b>:</font></p>
|
||||
<table 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 bgcolor="#000000" width="276">
|
||||
<p><b><span style="BACKGROUND: black 0% 50%; COLOR: rgb(48,192,255); FONT-FAMILY: Courier; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">RUN
|
||||
“Test.txt”</span></b></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="515"><span style="COLOR: white">Runs
|
||||
the script file called: “Test.txt”</span></td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="276">
|
||||
<p><b><span style="BACKGROUND: black 0% 50%; COLOR: rgb(48,192,255); FONT-FAMILY: Courier; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">ECHO
|
||||
“Hello World”</span></b></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="515"><span style="COLOR: white">Prints
|
||||
the classic “Hello World” to the output console.</span></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<h3><a name="Settings"></a>Settings</h3>
|
||||
<p>Coming in a future revision, you can save or load your debugger settings, either
|
||||
piece wise, or as a whole.
|
||||
</p>
|
||||
<br>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<COLGROUP>
|
||||
<col width="90">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="35%">
|
||||
<p><font color="#ffffff"><b>Command</b></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="65%">
|
||||
<p style="FONT-STYLE: normal"><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="35%">
|
||||
<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">CONFIG
|
||||
LOAD</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Load
|
||||
(default) debugger configuration.</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="35%">
|
||||
<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">CONFIG
|
||||
LOAD “filename”</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Load
|
||||
(named) debugger configuration</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="35%">
|
||||
<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">CONFIG
|
||||
SAVE</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Save
|
||||
(default) debugger configuration.</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="35%">
|
||||
<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">CONFIG
|
||||
SAVE “filename”</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Save
|
||||
(named) debugger configuration</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<COLGROUP>
|
||||
<col width="90">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="35%">
|
||||
<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">COLOR
|
||||
LOAD “filename”</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Load
|
||||
color configuration.</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="35%">
|
||||
<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">COLOR
|
||||
SAVE “filename”</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Save
|
||||
color configuration</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="35%">
|
||||
<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">BP
|
||||
LOAD “filename”</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Load
|
||||
breakpoint configuration.</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="35%">
|
||||
<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">BP
|
||||
SAVE “filename”</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Save
|
||||
breakpoint configuration</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<p>Hope you enjoyed the tour!</p>
|
||||
</body>
|
||||
</html>
|
||||
125
AppleWin/help/dbg-entering-debugger.html
Normal file
125
AppleWin/help/dbg-entering-debugger.html
Normal file
|
|
@ -0,0 +1,125 @@
|
|||
<!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="Debugger"></a>Entering the Debugger</h2>
|
||||
<p>Start AppleWin, and press <b><font face="Courier, monospace">F7</font></b> to
|
||||
enter the debugger.</p>
|
||||
<p>The first thing you'll probably notice is the new syntax coloring in the
|
||||
disassembly view, and info panel. All the colors can be customized to
|
||||
your liking. See the <a href="#Colors">Colors</a> section for details.</p>
|
||||
<p>Since the mini-console isn't the full width of the screen, you can toggle
|
||||
between the full-screen console with the tilde '~' key. This style of table
|
||||
will be used to designate which keys the debugger will recognize.</p>
|
||||
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="26">
|
||||
<col width="64">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="10%">
|
||||
<p><font color="#ffffff"><b>Key</b></font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Name</b></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><b>~</b><br>
|
||||
<font face="Wingdings">ñ</font>`</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Tilde<br>
|
||||
Shift-Accent</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Toggle full screen console (US keyboards)</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">ñ</font>/<br>
|
||||
<font face="Wingdings">ñ</font>@</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Shift Forward Slash<br>
|
||||
Shift At</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Toggle full screen console (European keyboards)</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p>The debugger will print out a mini message at the bottom of the console when it
|
||||
is first started. Help is built-in for some of the commands (with more
|
||||
coming every release.) Most commands will display a help usage, if you
|
||||
simply type the command and press Enter.
|
||||
</p>
|
||||
<p>This typeface, and color will be used to designate commands you can type into
|
||||
the debugger.
|
||||
</p>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="64">
|
||||
<col width="192">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="25%">
|
||||
<p><font color="#000000"><b>Input</b></font></p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="75%">
|
||||
<p><font color="#000000"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><font color="#30c0ff"><font face="Courier"><b>HELP</b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Display Help for specific command.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><font color="#30c0ff"><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">?</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Display Help Summary.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><font color="#30c0ff"><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">VERSION</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Display both the AppleWin and Debugger Version.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p><b>Note</b>: <i>Please include both the AppleWin and Debugger version when reporting
|
||||
bugs about the Debugger. Sometimes a preview (Beta) version of the
|
||||
debugger is available before the next official AppleWin version is
|
||||
available. Older bugs (may already) be fixed in the new version.
|
||||
The version number will help both you and the developers to detect if you’re
|
||||
documenting a new bug, submitting an already existing bug, or re-submitting a
|
||||
bug that has already been fixed. </i>
|
||||
<br>
|
||||
</p>
|
||||
</body>
|
||||
</html>
|
||||
271
AppleWin/help/dbg-execution.html
Normal file
271
AppleWin/help/dbg-execution.html
Normal file
|
|
@ -0,0 +1,271 @@
|
|||
<!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">
|
||||
<h1>
|
||||
Execution</h1>
|
||||
<p>As you scroll around, you will notice the cursor and other lines change
|
||||
colors. Normally the cursor line is shown with an inverse bar, that is
|
||||
with a white background. Other colors have these meanings:
|
||||
</p>
|
||||
<table border="1" bordercolor="#000000" cellpadding="2" cellspacing="0" width="666">
|
||||
<COLGROUP>
|
||||
<col width="161">
|
||||
<col width="494">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="161">
|
||||
<p><font color="#ffffff"><b>Cursor Background</b></font></p>
|
||||
</td>
|
||||
<td width="494">
|
||||
<p><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="161">
|
||||
<p>White
|
||||
</p>
|
||||
</td>
|
||||
<td width="494">
|
||||
<p><i>Address of cursor.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td bgcolor="#ffff00" width="161">
|
||||
<p>Yellow (Bright)</p>
|
||||
</td>
|
||||
<td width="494">
|
||||
<p><i>Cursor is on next 6502 instruction (At 6502 PC).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td bgcolor="#cccc00" width="161">
|
||||
<p>Yellow (Dim)</p>
|
||||
</td>
|
||||
<td width="494">
|
||||
<p><i>Line is next 6502 instruction (At 6502 PC).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td bgcolor="#ff0000" width="161">
|
||||
<p>Red (Bright)</p>
|
||||
</td>
|
||||
<td width="494">
|
||||
<p><i>Cursor is on active Breakpoint.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p>Press Right Arrow to locate the current 6502 instruction. If you Page
|
||||
Down, you can see that Branch Indicators are displayed on the right side of the
|
||||
disassembly window, designated by ‘<font face="Webdings, serif">5</font>’ or ‘<font face="Webdings, serif">6</font>’. </p>
|
||||
<p>Press Right Arrow to again locate the current instruction. You will also
|
||||
notice immediate instructions have a character single quoted, after them, such
|
||||
as ‘<font face="Courier, monospace">I’</font> at $<b>FA75</b>.</p>
|
||||
<p>Pressing Space, will Trace (into) an instruction. Sometimes you trace
|
||||
into a JSR (subroutine), and wish you hadn't. Pressing Shift-Space will "<i>Step
|
||||
Out</i>" - that is, run until the Program Counter (PC) is equal to the
|
||||
return address on the stack. Pressing Left Arrow will jump the cursor to
|
||||
the next instruction after the original call.
|
||||
</p>
|
||||
<br>
|
||||
<p><font size="4"><b>Notes</b>:</font></p>
|
||||
<ul>
|
||||
<li>
|
||||
<p><i>Some code will place the arguments to the subroutine after the JSR
|
||||
instruction. The debugger is not able to detect this and "<b>Step Out</b>"
|
||||
correctly, so use caution, if the sub-routine plays with the stack.</i></p>
|
||||
<li>
|
||||
<p>
|
||||
<i>The debugger is not able to detect if the top 2 bytes on the stack is a valid
|
||||
return address, so pay careful attention if the stack is modified!</i></p>
|
||||
</li>
|
||||
</ul>
|
||||
<br>
|
||||
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="26">
|
||||
<col width="64">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="10%">
|
||||
<p><font color="#ffffff"><b>Key</b></font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Name</b></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">§</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Space
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Trace into instruction.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">ñ§</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Shift-Space
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Step out of subroutine.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>^<font face="Wingdings">§</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Ctrl-Space
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Trace over instruction.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>^<font face="Wingdings">â</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Ctrl-Down Arrow
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Run until cursor.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>^<font face="Wingdings">à</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Ctrl-Right Arrow</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Set PC to cursor.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">ß</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Left Arrow
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Jump cursor to return address on stack.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<COLGROUP>
|
||||
<col width="90">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="35%">
|
||||
<p><font color="#ffffff"><b>Command</b></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p style="FONT-STYLE: normal"><font color="#ffffff"><b>Description</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="35%">
|
||||
<p>G [StopAddress]
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Resume execution until PC = StopAddress.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="35%">
|
||||
<p>G [StopAddress] [SkipAddress,Length]</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Resume execution until PC = StopAddress.<br>
|
||||
Additionally, if the PC exits the range [SkipAddress,Length],<br>
|
||||
execution will be halted.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="35%">
|
||||
<p>####G</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Alias for: R PC [=] address.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<COLGROUP>
|
||||
<col width="90">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="35%">
|
||||
<p><font color="#000000"><b>Input</b></font></p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="65%">
|
||||
<p><font color="#000000"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="35%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>R PC FA62 </b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><font color="#ffffff"><i>Set Program Counter to Value $<b><font color="#ffff00">FA62</font></b>
|
||||
(RESET) </i></font>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="35%">
|
||||
<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">G C600 D000,3000</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="65%">
|
||||
<p><font color="#ffffff"><i>Single-step until either PC = $C600, or PC <= $D000</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
</body>
|
||||
</html>
|
||||
245
AppleWin/help/dbg-flags.html
Normal file
245
AppleWin/help/dbg-flags.html
Normal file
|
|
@ -0,0 +1,245 @@
|
|||
<!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">
|
||||
<h1>Flags</h1>
|
||||
<p>Each flag can individually be set or cleared on the Processor Status Register ('<b>P</b>').
|
||||
Cleared flags will show up with a normal background. Set flags will show
|
||||
with an inverse background.
|
||||
</p>
|
||||
<br>
|
||||
<p><font size="4"><b>Notes</b>:</font></p>
|
||||
<ul>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><i>The legacy commands <b>R</b>? and <b>S</b>?, where? is
|
||||
a flag name (C,Z,I,D,B,R,V,N) has been left in.</i></p>
|
||||
</li>
|
||||
</ul>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p><font size="4">Commands to set a flag:</font></p>
|
||||
<table bgcolor="#cccccc" border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Command</b></font></p>
|
||||
</td>
|
||||
<td>
|
||||
<p style="FONT-STYLE: normal"><font color="#ffffff"><b>Description</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td>
|
||||
<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">SEC
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Set
|
||||
Carry </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td>
|
||||
<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">SEZ
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Set
|
||||
Zero </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td>
|
||||
<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">SEI
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Set
|
||||
Interrupts Disabled </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td>
|
||||
<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">SED
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Set
|
||||
Decimal (BCD) mode </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td>
|
||||
<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">SEB
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Set
|
||||
Break </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td>
|
||||
<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">SER
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Set
|
||||
Reserved (not used on 6502)</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td>
|
||||
<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">SEV
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Set
|
||||
Overflow </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td>
|
||||
<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">SEN
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Set
|
||||
Negative </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p><font size="4">Commands to clear a flag:</font></p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Command</b></font></p>
|
||||
</td>
|
||||
<td>
|
||||
<p style="FONT-STYLE: normal"><font color="#ffffff"><b>Description</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td>
|
||||
<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">CLC
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clear
|
||||
Carry </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td>
|
||||
<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">CLZ
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clear
|
||||
Zero </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td>
|
||||
<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">CLI
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clear
|
||||
Interrupts Disabled </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td>
|
||||
<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">CLD
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clear
|
||||
Decimal (BCD) mode </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td>
|
||||
<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">CLB
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clear
|
||||
Break </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td>
|
||||
<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">CLR
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clear
|
||||
Reserved (not used on 6502)</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td>
|
||||
<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">CLV
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clear
|
||||
Overflow </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td>
|
||||
<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">CLN
|
||||
</span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td>
|
||||
<p><i><span style="BACKGROUND: 0% 50%; moz-background-clip: initial; moz-background-origin: initial; moz-background-inline-policy: initial">Clear
|
||||
Negative </span></i>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
</body>
|
||||
</html>
|
||||
373
AppleWin/help/dbg-memory.html
Normal file
373
AppleWin/help/dbg-memory.html
Normal file
|
|
@ -0,0 +1,373 @@
|
|||
<!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">
|
||||
<h1><a name="Memory">Memory</a></h1>
|
||||
<h3><a name="Memory_View">Viewing Memory</a></h3>
|
||||
<p>There are two mini-memory areas on the info panel. You can view memory in
|
||||
Hex, (normal 7-Bit) ASCII, or Apple (8-Bit) TEXT format.</p>
|
||||
<p>Control characters are shown in yellow. The Apple uses something called
|
||||
8-Bit (High-Bit) ASCII, in which the first 128 characters (normal ASCII) are
|
||||
also mapped onto the last 128 characters, but with a different
|
||||
background. (Technically, the first 64 characters are drawn inverse, the
|
||||
next 64 characters flashing, and the last 128 normally.) Some programs
|
||||
will store text in this extended Apple format, where a High-Bit character can
|
||||
be used as a flag to represent an end of word.</p>
|
||||
<p>Here is a summary:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><i>Normal ASCII (non-control characters) will show up in
|
||||
cyan; High-Bit text in white.</i></p>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><i>Apple TEXT (normal ASCII) will also display with an
|
||||
inverse background; High-Bit with a normal background.</i></p>
|
||||
</li>
|
||||
</ul>
|
||||
<br>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<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="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>M1 ####</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>View mini-memory 1 in Hex at the Address</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>M2 ####</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>View mini-memory 2 in Hex at the Address</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>MA1 ####</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>View mini-memory 1 in ASCII at the Address</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>MA2 ####</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>View mini-memory 2 in ASCII at the Address</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>MT1 ####</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>View mini-memory 1 in “Apple Text” at the Address</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>MT2 ####</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>View mini-memory 1 in “Apple Text” at the Address</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>D ####</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Alias for M1</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><font size="4"><b>Examples</b>:</font></p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<COLGROUP>
|
||||
<col width="64">
|
||||
<col width="192">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="25%">
|
||||
<p><font color="#000000"><b>Input </b></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="75%">
|
||||
<p><font color="#000000"><b>Effect </b></font>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>MA1 D0D0</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><font color="#ffffff"><i>View Applesoft Tokens (Low ASCII cyan, High ASCII white)</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">MT2
|
||||
FF0A</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>View Apple message displayed when booted, showing Apple Model.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">DATA</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Switch to the Data Window to view memory. Most scrolling keys
|
||||
work.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">CODE</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Switch to the Code Window to view the disassembler.</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<h3><a name="Memory_Search">Searching Memory</a></h3>
|
||||
<p>You can search memory for hex values. Wildcard support is also supported
|
||||
via the '<b>?</b>' wildcard operator, including nibble searching. A
|
||||
single '<b>?</b>' by itself, means match one byte of any value. A hex
|
||||
value with the high nibble or low nibble of '<b>?</b>' 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.)</p>
|
||||
<p>Searching memory for text is forthcoming in a future version of the debugger.</p>
|
||||
<br>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<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><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="25%">
|
||||
<p><font color="#000000" face="Courier"><b>SH #,len byte1 …</b></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Search memory for 8-bit hex value(s).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>SH #,len word1 …</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Search memory for 16-bit value(s).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<p><font size="4"><b>Examples</b>:</font></p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<COLGROUP>
|
||||
<col width="64">
|
||||
<col width="192">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="25%">
|
||||
<p><font color="#000000"><b>Input </b></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="75%">
|
||||
<p><font color="#000000"><b>Effect </b></font>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><b><font color="#00b8ff" face="Courier">SH 800,8000 C030</font></b></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i><font color="#ffffff">Search memory for speaker access.</font></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><b><font color="#00b8ff" face="Courier">SH 800,8000 AD ? C0</font></b></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><i><font color="#ffffff">Search memory for “ <b>LDA $<font color="#ffff00">C0xx</font></b>”.</font></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><b><font color="#00b8ff" face="Courier">SH 800,8000 3? C0</font></b></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><i><font color="#ffffff">Search memory for speaker access <b>$<font color="#ffff00">C03x</font></b>.</font></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><b><font color="#00b8ff" face="Courier">SH 800,8000 ?1 C0</font></b></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><i><font color="#ffffff">Search memory for soft-switch $<b><font color="#ffff00">C0x1</font></b>.</font></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<p><b><font color="#00b8ff" face="Courier">L _1</font></b></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><i><font color="#ffffff">Disassemble from search result #<b><font color="#ffff00">1</font></b>
|
||||
address.</font></i></p>
|
||||
<p><i><font color="#ffffff">Note: Not yet implemented!</font></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<h3><a name="Memory_Change">Changing Memory</a></h3>
|
||||
<p>To change the Apple's memory, the classic "Apple Monitor" command to enter
|
||||
memory is recognized, as well as the "normal" debugger comamnd.<br>
|
||||
</p>
|
||||
<br>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<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><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>####:byte1 …</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Classic "Apple Monitor" command to enter byte(s). Alias for E.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000" face="Courier"><b>E addr byte1 …</b></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Set memory to the 8-Bit (byte) value(s)</i><i>.</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(s).</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>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>NOP</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Writes an “NOP” opcode (EA) at the current Program Counter (PC)</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>ZAP</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Alias for NOP.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<br>
|
||||
<p><font size="4"><b>Examples</b>:</font></p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<COLGROUP>
|
||||
<col width="64">
|
||||
<col width="192">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="25%">
|
||||
<p><font color="#000000"><b>Input </b></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="75%">
|
||||
<p><font color="#000000"><b>Effect </b></font>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>300:60</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i><span style="COLOR: white">Same
|
||||
as Applesoft Poke 768,96</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<h2>
|
||||
<br>
|
||||
</h2>
|
||||
</body>
|
||||
</html>
|
||||
296
AppleWin/help/dbg-registers.html
Normal file
296
AppleWin/help/dbg-registers.html
Normal file
|
|
@ -0,0 +1,296 @@
|
|||
<!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="Registers1"></a>Registers</h2>
|
||||
<p>The command line now recognizes 6502 Registers. Namely,
|
||||
</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p><b>A</b>, the Accumulator,</p>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><b>X</b>, the 1<sup>st</sup> Index Register,</p>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><b>Y</b>, the 2<sup>nd</sup> Index Register,</p>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><b>PC</b>, the Program Counter,
|
||||
</p>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><b>S</b>, the Stack Pointer, and
|
||||
</p>
|
||||
<li>
|
||||
<p><b>P</b>, the Processor Status Register (Flags).</p>
|
||||
</li>
|
||||
</ul>
|
||||
<p>You can set a Register to a hex Value, Symbol, or Expression. (See the
|
||||
section <a href="#Calculator">Calculator</a> for more examples of using
|
||||
expressions.) The syntax is:</p>
|
||||
<br>
|
||||
<table bgcolor="#e6e6e6" border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<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">R
|
||||
r [=] ####</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">Set
|
||||
Register to (a byte) Value, Symbol, or Address, or Expression.</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">R
|
||||
A ##</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">Set
|
||||
Accumulator to (a byte) Value</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">R
|
||||
X ##</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">Set
|
||||
Register X to (a byte) Value</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">R
|
||||
Y ##</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">Set
|
||||
Register Y to (a byte) Value</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">R
|
||||
PC ####</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">Set
|
||||
PC to (a full 16-bit) Address (Value)</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">R
|
||||
S ##</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">Set
|
||||
Stack Register to (an 8-Bit) Offset</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">R
|
||||
P ##</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">Set
|
||||
Processor Status Register (flags) to (a byte) Value</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<p><b>Notes</b>:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p style="MARGIN-BOTTOM: 0in"><i>Since <b>A</b> refers to the Accumulator, you need to
|
||||
prefix the hex number <b>A</b> with either:<br>
|
||||
i) a zero '<b>0</b>', or<br>
|
||||
ii) the hash '<b>#</b>' symbol (same as 6502 immediate
|
||||
symbol.)</i></p>
|
||||
</li>
|
||||
</ul>
|
||||
<ul>
|
||||
<li>
|
||||
<p><i>You can prefix a symbol with the dollar sign '<b>$</b>' to tell the parser it is
|
||||
a symbol Address instead of a Value.</i></p>
|
||||
<li>
|
||||
<p><i>If a symbol is not defined, the expression will be the corresponding hex Value,
|
||||
if possible.</i></p>
|
||||
<li>
|
||||
<p><i>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.</i></p>
|
||||
</li>
|
||||
</ul>
|
||||
<br>
|
||||
<p><font size="4"><b>Examples</b>:</font></p>
|
||||
<table bgcolor="#000000" border="0" cellpadding="2" cellspacing="0" width="90%">
|
||||
<COLGROUP>
|
||||
<col width="64">
|
||||
<col width="192">
|
||||
<tbody>
|
||||
<tr bgcolor="#00b8ff">
|
||||
<td bgcolor="#30c0ff" width="25%">
|
||||
<p><font color="#000000"><b>Input</b></font></p>
|
||||
</td>
|
||||
<td bgcolor="#30c0ff" width="75%">
|
||||
<p><font color="#000000"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="25%">
|
||||
<p><font color="#00b8ff"><font face="Courier"><b>R PC FA62 </b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><font color="#ffffff"><i>Set Program Counter to Value $<b><font color="#ffff00">FA62</font></b>
|
||||
(RESET) </i></font>
|
||||
</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
PC RESET + 1</span></b></font></font></p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Program Counter to Address $<b><font color="#ffff00">FA63</font></b>
|
||||
(RESET+1)</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
X 2 </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Register to Value <font style="FONT-WEIGHT: bold" color="#ffff00">
|
||||
2</font></i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
Y 3 </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Register to Value <font style="FONT-WEIGHT: bold" color="#ffff00">
|
||||
3</font></i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
S 1FE </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Stack Pointer to depth of one (Stack grows down from $01FF)</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
S FF </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Stack Pointer to top of stack (Empty)</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
A 0A </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Accumulator to hex Value <font style="FONT-WEIGHT: bold" color="#ffff00">
|
||||
0A</font></i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
A #A </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Accumulator to hex Value <font style="FONT-WEIGHT: bold" color="#ffff00">
|
||||
0A</font></i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
X A </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Set Register X to Accumulator’s Value</i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
A A1 </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>If the symbol A1 exists, sets Accumulator to the <b>Address</b>
|
||||
of the symbol <b>A1</b><br>
|
||||
If the symbol A1 <b>doesn't</b> exist, sets Accumulator to the hex <b>Value</b> <font style="FONT-WEIGHT: bold" color="#ffff00">
|
||||
A1</font></i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
A $A1 </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>If the symbol A1 exists, sets the Accumulator to the <b>Address</b>
|
||||
of symbol <b>A1<br>
|
||||
</b>If the symbol A1 <b>doesn't</b> exist, sets Accumulator to the hex Value <font style="FONT-WEIGHT: bold" color="#ffff00">
|
||||
A1</font></i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#000000">
|
||||
<td bgcolor="#000000" width="25%">
|
||||
<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">R
|
||||
A #A1 </span></b></font></font>
|
||||
</p>
|
||||
</td>
|
||||
<td bgcolor="#000000" width="75%">
|
||||
<p><font color="#ffffff"><i>Sets Accumulator to the hex value <b><font color="#ffff00">A1</font></b></i></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>
|
||||
<br>
|
||||
|
||||
</p>
|
||||
</body>
|
||||
</html>
|
||||
243
AppleWin/help/dbg-scrolling.html
Normal file
243
AppleWin/help/dbg-scrolling.html
Normal file
|
|
@ -0,0 +1,243 @@
|
|||
<!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="Scrolling"></a>Scrolling</h2>
|
||||
<p>In the disassembly view, the following keys & commands can be used:<br>
|
||||
(The classic Apple "monitor " disassemble command is also suported.)
|
||||
</p>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<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="#999999">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>U ####</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Start disassembly from Value or Address</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr bgcolor="#cccccc">
|
||||
<td width="25%">
|
||||
<p><font color="#000000"><font face="Courier"><b>####L</b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>List (unassemble) from specified address.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="26">
|
||||
<col width="64">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="10%">
|
||||
<p><font color="#ffffff"><b>Key</b></font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Name</b></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">á</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Up Arrow</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Scroll up one mnemonic line.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">â</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Down Arrow</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Scroll down one mnemonic line.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">ñá</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Shift Up Arrow</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Scroll up 1 byte.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">ñâ</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Shift-Down Arrow</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Scroll down 1 byte.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>PgUp
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Page Up
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Scroll up one screen.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>PgDn
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Page Down
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Scroll down one screen.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">ñ</font>PgUp
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Shift-Page Up
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Jump to prev. page boundary (256 byte).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">ñ</font>PgDn
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p><a name="Registers"></a>Shift-Page Down
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Jump to next page boundary (256 byte).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>^PgUp
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Control-Page Up
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Jump to prev. 4K boundary (4096 bytes).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>^PgDn
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Control-Page Down</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Jump to next 4K boundary (4096 bytes).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>Home
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Home</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Jump to start of memory ($0000).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>End
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>End</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Jump to middle of memory ($8000).</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">à</font>
|
||||
</p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Right Arrow
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Locate current 6502 instruction.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><font face="Wingdings">à</font><font size="4">|</font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Tab
|
||||
</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Locate current 6502 instruction.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<h2>
|
||||
<br>
|
||||
</h2>
|
||||
</body>
|
||||
</html>
|
||||
257
AppleWin/help/dbg-symbols.html
Normal file
257
AppleWin/help/dbg-symbols.html
Normal file
|
|
@ -0,0 +1,257 @@
|
|||
<!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>
|
||||
74
AppleWin/help/dbg-toc-intro.html
Normal file
74
AppleWin/help/dbg-toc-intro.html
Normal file
|
|
@ -0,0 +1,74 @@
|
|||
<!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">
|
||||
<H1>AppleWin Debugger Tutorial</H1>
|
||||
<P><FONT size="4"><i>By Michael Pohoreski.</i></FONT></P>
|
||||
<P><FONT size="3">Revision 3. Mar 12, 2006.</FONT></P>
|
||||
<H2>Table of Contents</H2>
|
||||
<UL>
|
||||
<LI>
|
||||
<A href="#Introduction">Introduction</A>
|
||||
<LI>
|
||||
<A href="dbg-entering-debugger.html">Entering the Debugger</A>
|
||||
<LI>
|
||||
<A href="dbg-scrolling.html">Scrolling</A>
|
||||
<LI>
|
||||
<A href="dbg-registers.html">Registers</A>
|
||||
<LI>
|
||||
<A href="dbg-flags.html">Flags</A>
|
||||
<LI>
|
||||
<A href="dbg-execution.html">Execution</A>
|
||||
<LI>
|
||||
<A href="dbg-memory.html">Memory</A>
|
||||
<UL>
|
||||
<LI>
|
||||
<A href="dbg-memory.html#Memory_View">Viewing Memory</A>
|
||||
<LI>
|
||||
<A href="dbg-memory.html#Memory_Search">Searching Memory</A>
|
||||
<LI>
|
||||
<A href="dbg-memory.html#Memory_Change">Changing Memory</A>
|
||||
</LI>
|
||||
</UL>
|
||||
<LI>
|
||||
<A href="dbg-symbols.html">Symbols</A>
|
||||
<LI>
|
||||
<A href="dbg-calculator.html">Calculator</A>
|
||||
<LI>
|
||||
<A href="dbg-windows.html">Windows</A>
|
||||
<LI>
|
||||
<A href="dbg-breakpoints.html">Breakpoints</A>
|
||||
<LI>
|
||||
<A href="dbg-configuration.html">Configuration</A>
|
||||
<UL>
|
||||
<LI>
|
||||
<A href="dbg-configuration.html#Colors">Colors</A>
|
||||
<LI>
|
||||
<A href="dbg-configuration.html#Fonts">Fonts</A>
|
||||
<LI>
|
||||
<A href="dbg-configuration.html#Scripts">Scripts</A>
|
||||
<LI>
|
||||
<A href="dbg-configuration.html#Settings">Settings</A>
|
||||
</LI>
|
||||
</UL>
|
||||
</LI>
|
||||
</UL>
|
||||
|
||||
<H2> </H2>
|
||||
<H2><a name="Introduction">Introduction</a></H2>
|
||||
<p>If you're new to the debugger, this tutorial will gently get you up to speed in
|
||||
becoming familiar with it.</p>
|
||||
<p>If you're already familiar with the AppleWin Debugger, you'll be aware that it
|
||||
was probably lacking in features and ease of use. The new debugger has
|
||||
been given an over-haul for the new millennium with respect to aesthetics and
|
||||
functionality. As such, you'll probably want to read this tutorial to
|
||||
learn about the new features that will not only help you in debugging, but also
|
||||
save you time.</p>
|
||||
<p>Let's get started on the tour!
|
||||
<br>
|
||||
</p>
|
||||
</body>
|
||||
</HTML>
|
||||
129
AppleWin/help/dbg-windows.html
Normal file
129
AppleWin/help/dbg-windows.html
Normal file
|
|
@ -0,0 +1,129 @@
|
|||
<!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="Calculator"></a><a name="Windows"></a>Windows</h2>
|
||||
<p>Due to the amount of information available, the debugger now features
|
||||
"windows." You can switch to th full screen console to read the help, or
|
||||
to the data window to view memory.</p>
|
||||
<p><br>
|
||||
<br>
|
||||
</p>
|
||||
<table border="0" cellpadding="2" cellspacing="0" width="75%">
|
||||
<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="#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">WIN
|
||||
CONSOLE</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Switch to the full screen console. Scrolling keys work.</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">CONSOLE</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">Alias</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">WIN
|
||||
CODE</span></b></font></font></p>
|
||||
</td>
|
||||
<td width="75%">
|
||||
<p><i>Switch to the disassembly window.</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">CODE</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">Alias</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">WIN
|
||||
DATA</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">Switch
|
||||
to the Data window to view memory. Most scrolling keys work.</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">DATA</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">Alias</span></i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>You can cycle between windows, using these keys:</p>
|
||||
<table border="1" cellpadding="2" cellspacing="0" width="75%">
|
||||
<COLGROUP>
|
||||
<col width="26">
|
||||
<col width="64">
|
||||
<col width="166">
|
||||
<tbody>
|
||||
<tr bgcolor="#000000">
|
||||
<td width="10%">
|
||||
<p><font color="#ffffff"><b>Key</b></font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p><font color="#ffffff"><b>Name</b></font></p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><font color="#ffffff"><b>Effect</b></font></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p><b>^<font face="Wingdings">à</font></b></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Ctrl-Tab</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Cycle to next Window.</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="10%">
|
||||
<p>^<font face="Wingdings">ñà</font></p>
|
||||
</td>
|
||||
<td width="25%">
|
||||
<p>Ctrl-Shift-Tab</p>
|
||||
</td>
|
||||
<td width="65%">
|
||||
<p><i>Cycle to prev. Window</i></p>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p style="MARGIN-BOTTOM: 0in">
|
||||
<br>
|
||||
|
||||
</p>
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -31,7 +31,7 @@
|
|||
<li>
|
||||
<a href="keyboard.html">Using the Keyboard</a>
|
||||
<li>
|
||||
<a href="debug.html">Using the Debugger</a>
|
||||
<a href="dbg-toc-intro.html">Using the Debugger</a>
|
||||
<li>
|
||||
<a href="resources.html">Resources</a></li>
|
||||
</ul>
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue