Apple-2-Tools
/
AppleWin
mirror of https://github.com/AppleWin/AppleWin.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
AppleWin/help/dbg-entering-debugger.html

194 lines
6.9 KiB
HTML
Raw Normal View History

Updated AW-help's debugger section with Michael's v3 tutorial
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">
Help doc: . 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)
2017-12-20 18:07:23 +00:00
<h2><a name="Entering-Debugger"></a>Entering the Debugger</h2>
Updated AW-help's debugger section with Michael's v3 tutorial
2006-07-30 20:24:09 +00:00
<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
Help doc: . 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)
2017-12-20 18:07:23 +00:00
your liking.&nbsp; See the <a href="dbg-configuration.html#Colors">Colors</a> section for details.</p>
Updated AW-help's debugger section with Michael's v3 tutorial
2006-07-30 20:24:09 +00:00
<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.&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 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>
Update html help pages for new and missing things added up to 1.26.2
2017-04-25 21:31:04 +00:00
Help doc: . 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)
2017-12-20 18:07:23 +00:00
<h2><a name="Exiting-Debugger"></a>Exiting the Debugger</h2>
Update html help pages for new and missing things added up to 1.26.2
2017-04-25 21:31:04 +00:00
<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%">
Help doc: . 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)
2017-12-20 18:07:23 +00:00
<p>G</p>
Update html help pages for new and missing things added up to 1.26.2
2017-04-25 21:31:04 +00:00
</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%">
Help doc: . 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)
2017-12-20 18:07:23 +00:00
<p>GG</p>
Update html help pages for new and missing things added up to 1.26.2
2017-04-25 21:31:04 +00:00
</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>
Updated AW-help's debugger section with Michael's v3 tutorial
2006-07-30 20:24:09 +00:00
</body>
</html>