2006-07-30 20:24:09 +00:00
|
|
|
|
<!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"><EFBFBD></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"><EFBFBD></font>/<br>
|
|
|
|
|
|
<font face="Wingdings"><EFBFBD></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<6F>re
|
|
|
|
|
|
documenting a new bug, submitting an already existing bug, or re-submitting a
|
|
|
|
|
|
bug that has already been fixed. </i>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
</p>
|
2017-04-25 21:31:04 +00:00
|
|
|
|
|
|
|
|
|
|
<h2><a name="Debugger"></a>Exiting the Debugger</h2>
|
|
|
|
|
|
<p>In general, press <b><font face="Courier, monospace">F7</font></b> to exit the debugger.<br>
|
|
|
|
|
|
NB. If you have breakpoints set then you will exit the debugger in 'stepping' mode.<br><br>
|
|
|
|
|
|
Other ways to exit the debugger and force 'stepping' mode are:
|
|
|
|
|
|
</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="14%">
|
|
|
|
|
|
<p><font color="#ffffff"><b>Command</b></font></p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="25%">
|
|
|
|
|
|
<p><font color="#ffffff"><b>Run at normal speed?</b></font></p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="25%">
|
|
|
|
|
|
<p><font color="#ffffff"><b>Run at full speed?</b></font></p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="18%">
|
|
|
|
|
|
<p><font color="#ffffff"><b>Video quality</b></font></p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="18%">
|
|
|
|
|
|
<p><font color="#ffffff"><b>Sound quality</b></font></p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
<td width="14%">
|
|
|
|
|
|
<p>g</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="25%">
|
|
|
|
|
|
<p>yes</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="25%">
|
|
|
|
|
|
<p>only if disk active, etc</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="18%">
|
|
|
|
|
|
<p>precise</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="18%">
|
|
|
|
|
|
<p>precise</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
<td width="14%">
|
|
|
|
|
|
<p>gg</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="25%">
|
|
|
|
|
|
<p>no</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="25%">
|
|
|
|
|
|
<p>always</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="18%">
|
|
|
|
|
|
<p>periodic</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
<td width="18%">
|
|
|
|
|
|
<p>muted</p>
|
|
|
|
|
|
</td>
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
</tbody>
|
|
|
|
|
|
</table>
|
|
|
|
|
|
<br>
|
|
|
|
|
|
<p>Finally to exit 'stepping' and return to the debugger, use F7, the Pause key or the Debugger toolbar button.
|
|
|
|
|
|
</p>
|
2006-07-30 20:24:09 +00:00
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
