Quick Start Guide
Debugging the Program
Next let's see how we can
actually debug the program with the System RPL debugger. Go into the Debug4x
Project Window, and select the "Debug Info" tab. Verify that there is
a load address just above the "Search" button,
this is the location of your library in the calculator memory.
Now open the System RPL debugger using the corresponding menu option in the
Debug4x main window (Debugging menu). By default, there are a lot of different
fields in the debugger window showing different kinds of information. You can
drag around the fields to change the layout of the window (use SHIFT + mouse),
and you can also select which fields you want to display by right-clicking in
the debugger window and choosing the elements you like to see.
Next go to the main window and
type "xMYTRY" into the Go to source at label box. A blue
line will flash in the editor window showing where that name has been defined.
In this case it is the entry point for your library. On bigger projects
you will find this shortcut useful!
In the editor window, find the
line right after the opening :: of your MYTRY routine. This is the line
which has the CK1&Dispatch
call. Click in the gutter (where the line numbers are) to set a
breakpoint. A red dot shows where the breakpoint is set. Use your
mouse and right-click on the red dot. It changes to a dot with a yellow
cross - this means the breakpoint is inactive. Use the right mouse button
click again and make the breakpoint active.
Now back to the emulator.
Again place a 99 on the stack and run the program in the emulator, it should
stop on the break point just set. The debugger and editor windows will be
updated accordingly. Here's a picture of the debugger window showing it at work:
When the breakpoint is
triggered, a blue line appears in the editor window showing where execution
stopped.
