mirror of
https://github.com/AppleWin/AppleWin.git
synced 2024-12-22 09:30:15 +00:00
355f5d0dd7
. Added a new Debugger Screen Layout html page (to describe soft-switch status) (Fixes #406) - added a PPT doc which was used to generate the annotated screen layout image . Added a note about Shift+LMB for toggling 6502 status flags (#483)
194 lines
6.9 KiB
HTML
194 lines
6.9 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<title>AppleWin Debugger Tutorial</title>
|
||
<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252">
|
||
</head>
|
||
<body style="DIRECTION: ltr" lang="en-US">
|
||
<h2><a name="Entering-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="dbg-configuration.html#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>
|
||
|
||
<h2><a name="Exiting-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>
|