AppleWin/help/dbg-entering-debugger.html

194 lines
6.9 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!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.&nbsp; All the colors can be customized to
your liking.&nbsp; 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.&nbsp; Help is built-in for some of the commands (with more
coming every release.)&nbsp; 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.&nbsp; Sometimes a preview (Beta) version of the
debugger is available before the next official AppleWin version is
available.&nbsp; Older bugs (may already) be fixed in the new version.&nbsp;
The version number will help both you and the developers to detect if youre
documenting a new bug, submitting an already existing bug, or re-submitting a
bug that has already been fixed. </i>
<br>
</p>
<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>
</body>
</html>