Entering the Debugger

Start AppleWin, and press F7 to enter the debugger.

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 Colors section for details.

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.

Key

Name

Effect

~
ñ`

Tilde
Shift-Accent

Toggle full screen console (US keyboards)

ñ/
ñ@

Shift Forward Slash
Shift At

Toggle full screen console (European keyboards)



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.

This typeface, and color will be used to designate commands you can type into the debugger.

Input

Effect

HELP

Display Help for specific command.

?

Display Help Summary.

VERSION

Display both the AppleWin and Debugger Version.



Note: 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.

Exiting the Debugger

In general, press F7 to exit the debugger.
NB. If you have breakpoints set then you will exit the debugger in 'stepping' mode.

Other ways to exit the debugger and force 'stepping' mode are:

Command

Run at normal speed?

Run at full speed?

Video quality

Sound quality

g

yes

only if disk active, etc

precise

precise

gg

no

always

periodic

muted


Finally to exit 'stepping' and return to the debugger, use F7, the Pause key or the Debugger toolbar button.