This chapter provides reference information describing each menu command in Palm OS Debugger.
Palm OS Debugger Menu Reference Overview
The Palm OS Debugger menus include:
File
Use the File menu, shown in Figure 5.1, to perform actions related to the current file you are debugging.

Open
Use the Open menu to open a new Palm OS Debugger window with an existing target file.
Save
Use the Save menu to save the current window's contents to a file. This menu item cannot be used with a debug target file (PRC or ELF file).
Recent File List
Palm OS Debugger adds each open debug target to the File menu, in chronological order, so that you can select recently used files when starting a new debug session.
The list shows the short filenames, but the path to each file is displayed in the message area at the bottom of the Palm OS Debugger window.
Exit
Use the Exit menu to exit Palm OS Debugger.
Edit
Use the Edit menu, shown in Figure 5.2, to perform standard editing functions, to search for text strings, to move through the breakpoints, and to change keyboard settings and debugger preferences.

Undo
Use the Undo menu to undo the previously executed edit command.
Cut
Use the Cut menu to delete the currently selected text, copying the selected text into the operating system clipboard.
Copy
Use the Copy menu to copy selected text in the current window into the operating system clipboard.
Paste
Use the Paste menu to copy text from the clipboard into the current edit window.
Find
Use the Find menu to search for a text string in a window.
Find next
Use the Find next menu to look for a text string in a window using an advance search direction (searching forward from the current position).
Find previous
Use the Find previous menu to look for a text string in a window using a reverse direction search (searching backwards from the current position).
Next breakpoint
Use the Next breakpoint to jump to the next code line where you can place a breakpoint in the source window.
Previous breakpoint
Use the Previous breakpoint menu to jump back to the next prior code line where you can place a breakpoint in the source window.
Key Bindings
Use the Key Bindings menu to display the Key Bindings Editor, shown in Figure 5.3.
Figure 5.3 Key Bindings Editor Dialog

Preferences
Use the Preferences menu to display the Debugger Preferences dialog box, shown in Figure 5.4.
Figure 5.4 Debugger Preferences Dialog Box

View
Use the View menu, shown in Figure 5.5, to indicate whether Palm OS Debugger should show the toolbars or the status bar.

Main Toolbar
Use the Main Toolbar menu to hide or show the icons in the toolbar at the top of the main window.
Window Toolbar
Use the Window Toolbar menu to hide or show the toolbar icons for the Window items.
Status Bar
Use the Status Bar menu to hide or show the status information at the bottom of the main window.
Target
Use the Target menu, shown in Figure 5.6, to connect and disconnect from a debug target, to use a symbolics file, or to save and load memory values.

Connect
Use the Connect menu to connect the Palm OS Debugger with a debug target.
Disconnect
Use the Disconnect menu to disconnect the Palm OS Debugger from a debug target.
Append Symbolics
A symbolics file is a file containing information that Palm OS Debugger needs in order to display the source code that corresponds to your object code.
Use the Append Symbolics menu to select a symbolics file to append. Palm OS Debugger loads the code symbolics without requiring the code to be downloaded to the debug target.
You can use the symbolics to set breakpoints in the Files view. Any breakpoints that you set prior to connecting to the debug target and running the first time are set as unresolved. When you connect to the debug target, Palm OS Debugger attempts to resolve these breakpoints.
Remove Symbolics
Use the Remove Symbolics menu to remove the symbolics that had been previously added using the Append Symbolics menu.
Load Memory
Use the Load Memory menu to load the memory contents from a previously saved file. Select the binary file to load, and enter the absolute memory location to be loaded.
You specify the memory location range as a standard ANSI C string in one of the following ways:
- Using a low address and a high address. For example, if you specify the string
"0x8000-0x9000"
, Palm OS Debugger loads the address range0x00008000
to0x00009000
. - Using a starting address and a size. For example, if you specify the string
"0x8000+0x1000"
, Palm OS Debugger loads the address range0x00008000
to0x00009000
. - Using a starting address. If you don't specify a size for the memory range, then Palm OS Debugger loads the entire binary file into the memory starting at the starting address.
Palm OS Debugger downloads the file contents as a binary file into the specified memory location.
NOTE: The examples above show the address values and size specified as hexadecimal numbers. The address values and size can be specified in decimal, hexadecimal, octal, floating point, or binary, as described in "Registers View User Interface".
Save Memory
Use the Save Memory menu to save the current memory contents to a file. Enter a file name for the memory contents, and the absolute memory location to be saved.
You specify the memory location range as a standard ANSI C string in one of two ways:
- Using a low address and a high address. For example, if you specify the string
"0x8000-0x9000"
, Palm OS Debugger saves the address range0x00008000
to0x00009000
. - Using a starting address and a size. For example, if you specify the string
"0x8000+0x1000"
, Palm OS Debugger saves the address range0x00008000
to0x00009000
.If you specify a starting address and no size, then Palm OS Debugger saves an empty file (a file of size 0).
NOTE: The examples above show the address values and size specified as hexadecimal numbers. The address values and size can be specified in decimal, hexadecimal, octal, floating point, or binary, as described in "Registers View User Interface".
Flash Memory
This menu is intended for licensee use.
Control
Use the Control menu, as shown in Figure 5.7, to control the execution of the program you are debugging.

Run
Use the Run menu to execute a program on the debug target, stopping only at breakpoints or at the normal end of the program execution.
If you have not yet connected to a debug target, Palm OS Debugger tries to connect. If the connection is successful, then Palm OS Debugger downloads the code to the debug target and runs it.
If you have already connected to the debug target, Palm OS Debugger runs the code that was already downloaded.
Restart
Use the Restart menu to go back to the beginning of a program, restarting the debugging session.
Stop
Use the Stop menu to suspend program execution during a debugging session.
Kill
Use the Kill menu to completely stop the execution of the program you are debugging and end the debugging session. This menu item will also disconnect Palm OS Debugger from the debug target.
Step
Use the Step menu to execute code, a single source line at a time, in the program being debugged.
Step In
Use the Step In menu to execute code a single source line at a time, stepping into a subroutine if execution branches into a subroutine.
Step Out
Use the Step Out menu to execute the rest of the code in a subroutine, stopping if execution steps out of the subroutine.
Window
Use the Window menu, shown in Figure 5.8, to open new debugging windows and to arrange the open debug windows.

Cascade
Use the Cascade menu to have the open windows displayed in an overlapping arrangement, with the title bar on each window visible.
Tile
Use the Tile menu to have the open windows displayed in the main window so that none of the windows overlap.
Arrange Icons
Use the Arrange Icons menu to arrange minimized window icons in the main window.
Files Window
Opens the content of the files view in a separate window. See "Files View" for information on the files view.
Breakpoints Window
Opens the content of the breakpoints view in a separate window. See "Breakpoints View" for information on the breakpoints view.
Registers Window
Opens the content of the registers view in a separate window. See "Registers View" for information on the registers view.
Variables Window
Opens the content of the variables view in a separate window. See "Variables View" for information on the variables view.
Global Variables Window
Opens the content of the global variables view in a separate window. See "Global Variables View" for information on the global variables view.
Memory Window
Opens the content of the memory view in a separate window. See "Memory View" for information on the memory view.
Processes Window
Opens the content of the processes view in a separate window. See "Processes View" for information on the processes view.
Stack Trace Window
Opens the content of the stack trace view in a separate window. See "Stack Trace View" for information on the stack trace view.
Expressions Window
Opens the content of the expressions view in a separate window. See "Expressions View" for information on the expressions view.
Profiler Window
Opens the content of the profiler view in a separate window. See "Profiler View" for information on the profiler view.
Create Dockable Windows
Select the Create Dockable Windows menu to cause the child windows to appear as docked windows attached to the main window. If this menu item is not selected, then child windows are separate child windows.
File Names
Palm OS Debugger adds each open debug target to the Window menu, so that you can switch between the currently opened windows.
Help
Use the Help menu, as displayed in Figure 5.9, to display information about Palm OS Debugger.

About Palm OS Debugger
Use the About Palm OS Debugger menu to display an About dialog box for Palm OS Debugger.